⚡ A local, privacy-focused AI desktop assistant for Windows. Control your PC remotely via Telegram or locally with Voice commands. Powered by Ollama.
# Add to your Claude Code skills
git clone https://github.com/Surajkumar5050/zyron-assistantZYRON isn't just another assistant - it's your personal AI that lives entirely on your machine. No subscriptions, no cloud uploads, no privacy concerns. Just pure, powerful automation at your fingertips.
No comments yet. Be the first to share your thoughts!
Follow these stages to get Zyron running perfectly on your machine.
ollama pull qwen2.5-coder:7b
(This model is optimized for tool-calling and system automation)git clone https://github.com/Surajkumar5050/zyron-assistant.git
cd zyron-assistant
setup.bat
For live browser monitoring and stealth research:
zyron_activity_monitor.xpi from the Releases section.about:addons -> Gear Icon ⚙️ -> Install Add-on From File....python src/zyron/scripts/register_native_host.py
API TOKEN..env: Open the .env file created by the installer and fill it in:
TELEGRAM_TOKEN=your_bot_token_here
ALLOWED_TELEGRAM_USERNAME=your_telegram_username
MODEL_NAME=qwen2.5-coder:7b
start_zyron.bat to see the console and voice feedback.run_silent.vbs. Zyron will move to the background and wait for your voice or Telegram commands without taking up window space."Hey Pikachu, what's my battery level?"
"Hey Pikachu, open Spotify"
"Hey Pikachu, take a screenshot"
"Hey Pikachu, show me what I'm doing"
"Hey Pikachu, find that Excel file from yesterday"
"Hey Pikachu, where am I?"
"Hey Pikachu, check storage"
/activities - See running apps and browser tabs
/screenshot - Capture your screen
/batterypercentage - Check current battery percentage + charging / discharging status
/systemhealth - View CPU, RAM, and system performance status
/storage - View disk space across all drives
/location - Get current location
/recordaudio - Record 10 seconds of audio
/camera_on - Start camera feed
/camera_off - Stop camera feed
/sleep - Put PC to sleep
/restart - Restart the system
/shutdown - Shut down the system
/clear_bin - Empty recycle bin
/copied_texts - View top 20 clipboard history
/focus_mode_on - Enable focus mode (do not disturb)
/blacklist - Manage blocked apps, sites for focus mode
"Open Chrome and go to YouTube"
"What's my battery percentage?"
"Find that PDF I was working on this morning"
"Show me my system resources"
"List files in my downloads folder"
"Clear the recycle bin"
"Send me that document I opened yesterday"
zyron-assistant/
│
├── src/
│ └── zyron/
│ ├── main.py # Application entry point
│ ├── core/ # Core System Modules
│ │ ├── brain.py # AI inference engine
│ │ ├── voice.py # Voice input/output
│ │ ├── wake_word.py # Offline Wake Word (Vosk)
│ │ └── memory.py # Context manager
│ ├── agents/ # Autonomous Agents
│ │ ├── system.py # System automation (muscles)
│ │ └── telegram.py # Telegram bot handler
│ └── features/ # Feature Modules
│ ├── activity.py # App & Browser monitoring
│ ├── clipboard.py # Clipboard history
│ └── files/ # File System Intelligence
│ ├── finder.py # Smart search engine
│ └── tracker.py # File activity logger
│
│
├── browser_extension/ # Chrome extension for tab monitoring
│ ├── manifest.json
│ ├── background.js
│ ├── popup.html
│ ├── popup.js
│ └── icons/
│ ├── icon16.png
│ ├── icon48.png
│ └── icon128.png
├── firefox_extension/ # Firefox extension for tab monitoring
│ ├── manifest.json
│ ├── background.js
│ ├── icon16.png
│ ├── icon48.png
│ └── icon128.png
│
├── docs/ # Documentation
│ ├── ACTIVITIES_FEATURE_GUIDE.md
│ ├── ARCHITECTURE.md
│ ├── CONFIGURATION.md
│ ├── CONTRIBUTING.md
│ ├── EXTENSION_INSTALL_GUIDE.md
│ ├── INSTALLATION.md
│ ├── LOCATION_ACCURACY_GUIDE.md
│ └── USER_MANUAL.md
│
├── markdown_themes/ # README assets
│ ├── header.png
│