J.A.R.V.I.S.

Just A Rather Very Intelligent System

A lightweight, offline desktop AI assistant built entirely in Python. Controls your Windows system through natural language — no internet, no API, no LLM required.

---

Features

Category	Capabilities
Web & Search	Google Search, YouTube, GitHub, Gmail — all via your default browser
Mouse Control	Move, click, right-click, double-click, scroll
Keyboard Control	Type text, press any key, execute hotkeys (Ctrl+C, Alt+Tab, etc.)
Application Management	Open, close, focus, minimize, maximize, uninstall
CMD & PowerShell	Execute any command and get output directly in chat
Security Tools	Port scanning, DNS lookup, password generation, hashing
File System	Browse directories, check sizes, open any file
Hardware Control	CPU/RAM monitoring, fan speed, power plans, process priority
Windows Settings	Open any settings page, adjust volume
Power Control	Shutdown, restart, lock screen, sleep
Custom Protocols	Create multi-step command sequences and run them with one command
Notes	Quick note-taking system
Math	Calculator, unit conversions, constants
Entertainment	Jokes, quotes, random facts, dice rolls

Prerequisites

• Python 3.8+ (Download)
• Windows 10 or 11

Installation

git clone https://github.com/MahbodFarajian/JARVIS-OS-Agent.git
cd JARVIS-OS-Agent
pip install -r requirements.txt
python main.py

Dependencies

Package	Purpose
customtkinter	Modern dark UI framework
pyautogui	Mouse & keyboard automation
pygetwindow	Window management
psutil	System monitoring
pyperclip	Clipboard operations
Pillow	Screenshot capture

Usage

Just type natural language commands in the chat:

> search python tutorial
> open chrome
> ip address
> scan ports 192.168.1.1
> system status
> run ipconfig
> list files C:\Users
> set volume 50
> create protocol startup: open chrome | open spotify | system status
> protocol startup
> help

Command Reference

search [query]          Google search
google [query]          Same as search
open youtube            Open YouTube
open youtube [query]    Search YouTube
open github             Open GitHub
open gmail              Open Gmail
open chatgpt            Open ChatGPT

move mouse to X Y       Move cursor to coordinates
click                   Left click at current position
click at X Y            Left click at coordinates
right click              Right click
double click             Double click
scroll up               Scroll up
scroll down             Scroll down

type [text]             Type text at cursor
press enter             Press Enter key
press tab               Press Tab
press escape            Press Escape
copy / paste / cut      Standard shortcuts
undo / redo             Standard shortcuts
select all               Ctrl+A
save                    Ctrl+S
alt tab                 Switch windows
show desktop            Win+D

open [app]              Launch application
close [app]             Close application window
focus [app]             Switch to application
minimize [app]          Minimize window
maximize [app]          Maximize window
list windows            Show all open windows
uninstall [app]         Open uninstaller

run [command]           Execute any CMD command
powershell [command]    Execute PowerShell command
ip address              Show IP addresses
wifi info               Show WiFi status
ping [host]             Ping a host
list processes          Show running processes
kill [process]          Terminate a process

scan ports [host]       Scan common ports
scan ports [host] 22,80 Custom port list
whois [domain]          DNS lookup
generate password       Generate 16-char password
generate password 32    Custom length
hash [text]             MD5 + SHA256

system status           Full system report
cpu usage               CPU percentage
ram usage               RAM percentage
disk usage              Disk space info
temperatures            Sensor readings
power plan performance  Set high performance
power plan balanced     Set balanced
fan auto                Automatic fan
fan max                 Maximum speed

create protocol [name]: [step1] | [step2] | [step3]
run protocol [name]     Execute a protocol
list protocols          Show all protocols
delete protocol [name]  Remove a protocol

Architecture

JARVIS-OS-Agent/
├── main.py          Entry point with error handling
├── config.py        All configuration in one place
├── system.py        Windows system controller
├── brain.py         Natural language command processor
├── gui.py           CustomTkinter chat interface
├── requirements.txt Python dependencies
├── LICENSE          MIT License
└── README.md        This file

• config.py — Colors, fonts, paths, constants
• system.py — Hardware abstraction: mouse, keyboard, apps, CMD, files, network
• brain.py — Pattern-matching NLP: parses commands, manages protocols, handles conversation
• gui.py — Dark-themed chat UI with conversation history and settings

How It Works

JARVIS uses pattern matching — no machine learning, no API calls, no internet dependency. Each user input is checked against a series of regex patterns and keyword matchers. The first matching handler produces the response.

This means:

• Instant responses — no network latency
• Complete privacy — nothing leaves your machine
• Zero cost — no API keys or subscriptions
• Works offline — once installed, internet is optional

Requirements

Component	Minimum	Recommended
OS	Windows 10	Windows 11
Python	3.8	3.11+
RAM	4 GB	8 GB
CPU	i3	i5 8th gen+
Storage	50 MB	100 MB

Contributing

Contributions are welcome. Please fork the repository and create a pull request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

This project is licensed under the MIT License — see the LICENSE file for details.

Author

Mahbod Farajian