What Makes ZYRON Special?
ZYRON 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.
Core Features
See It In Action
Real Conversations with ZYRON
What Can ZYRON Do?
System Control
- Launch & Manage Apps - Open Chrome, Spotify, VS Code, or any application
- Power Management - Sleep, shutdown, restart, or lock your PC
- File Operations - Browse, search, and manage files naturally
- Window Control - Switch between apps, minimize, maximize
Monitoring & Intelligence
- Live Activity Tracking - See what apps you're running and which browser tabs are open
- System Health - Real-time CPU, RAM, disk, and battery monitoring
- Storage Analysis - Check available space across all drives
- Clipboard History - Access your last 100 copied texts
- Zombie Process Reaper - Auto-detects and alerts you about idle, high-memory apps (kills them on command)
Media Capture
- Screenshots - Capture your screen on command
- Camera Feed - Access your webcam remotely
- Audio Recording - Record 10-second clips from system + microphone
- Instant Sharing - All media delivered via Telegram
Smart Search
- Intelligent File Finder - "Find that PDF I opened yesterday" - ZYRON understands
- Recent Files - Access files by time, type, or keyword
- Activity Log - 30-day history of all file access
- Context-Aware - Learns your preferences over time
Location & Network
- IP Geolocation - Know where your laptop is
- Network Info - Check your connection status
- Location Tracking - Useful for lost/stolen device scenarios
🚀 The Ultimate 0-100 Setup Guide
Follow these stages to get Zyron running perfectly on your machine.
Stage 1: The Engine (AI Infrastructure)
- Download Ollama: Visit ollama.com and install it.
- Pull the Model: Open your terminal and run:
(This model is optimized for tool-calling and system automation)ollama pull qwen2.5-coder:7b
Stage 2: The Core (Installation)
- Clone & Enter:
git clone https://github.com/Surajkumar5050/zyron-assistant.git cd zyron-assistant - Automated Installer: Run the setup script. It creates your environment and installs all 30+ required libraries.
setup.bat
Stage 3: The Bridge (Firefox Integration) 🦊
For live browser monitoring and stealth research:
- Add-on: Download
zyron_activity_monitor.xpifrom the Releases section. - Install: In Firefox, go to
about:addons-> Gear Icon ⚙️ -> Install Add-on From File.... - Secure Bridge: Run the registration script to connect Firefox to your PC:
python src/zyron/scripts/register_native_host.py
Stage 4: Remote Control (Telegram)
- Create Bot: Message @BotFather on Telegram and get your
API TOKEN. - Configure
.env: Open the.envfile 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
Stage 5: Launch (The Experience)
- Visible Mode (Testing): Run
start_zyron.batto see the console and voice feedback. - Stealth Mode (Professional): Run
run_silent.vbs. Zyron will move to the background and wait for your voice or Telegram commands without taking up window space.
Command Examples
Voice Commands
"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"
Telegram Commands
/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
Natural Language (Both Voice & Text)
"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"
Project Architecture
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
│