zyron-assistant

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)

1. Download Ollama: Visit ollama.com and install it.
2. Pull the Model: Open your terminal and run:

   ollama pull qwen2.5-coder:7b
   

   (This model is optimized for tool-calling and system automation)

Stage 2: The Core (Installation)

1. Clone & Enter:

   git clone https://github.com/Surajkumar5050/zyron-assistant.git
   cd zyron-assistant
   

2. 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:

1. Add-on: Download zyron_activity_monitor.xpi from the Releases section.
2. Install: In Firefox, go to about:addons -> Gear Icon ⚙️ -> Install Add-on From File....
3. 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)

1. Create Bot: Message @BotFather on Telegram and get your API TOKEN.
2. Configure .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
   

Stage 5: Launch (The Experience)

• Visible Mode (Testing): Run start_zyron.bat to 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
│