Jarvis: Ultimate Mac M2 Virtual Assistant

Note: High-end Glassmorphic UI

Jarvis is a sophisticated, system-level AI assistant designed specifically for macOS (optimized for Mac M2). It combines real-time acoustic triggers, high-accuracy speech-to-text, and Gemini-powered reasoning with a stunning, premium visual interface.

🚀 Features

• Apex Brain: Multi-model reasoning engine supporting Claude 3.5 Sonnet (Primary), Gemini 1.5 Flash, and Local Heuristics.
• Liquid Glass HUD: A premium, semi-transparent dashboard built with native macOS blur effects.
• Acoustic Wake Word: Double-clap detection for a stealthy wake-up experience.
• System Automation: Control volume, brightness, and launch applications (Chrome, VS Code, WhatsApp, etc.) with your voice.
• Non-Blocking Logic: Independent speech queue and low-latency STT for fluid conversation.
• SkyPulse Weather: Real-time localized weather data integrated directly into the HUD.

🛠 Tech Stack

• Core: Python 3.12+
• UI: HTML5, CSS3 (Vanilla), JavaScript, PyWebView, AppKit (Native Blur)
• Speech: SpeechRecognition (Google Web), pyttsx3 (Samantha voice)
• Brain: Google Generative AI (Gemini Flash)
• System: psutil, subprocess, osascript

📁 Project Structure

├── core/
│   ├── actions.py      # System automation (apps, volume, etc.)
│   ├── brain.py        # AI Reasoning & Heuristics
│   ├── listener.py     # Clap/Wake word detection
│   ├── speaker.py      # Non-blocking TTS engine
│   ├── stt_engine.py   # Speech-to-Text recovery
│   └── weather.py      # Open-Meteo integration
├── ui/
│   ├── index.html      # Glassmorphic HUD Layout
│   └── dashboard.py    # UI/Python bridge & Native Effects
└── main.py             # Entry point & threading logic

🚦 Quick Start

1. Install Dependencies:

   pip install -r requirements.txt

   (Note: Requires PyAudio and PyObjC on macOS)

2. Set Up API Key (Optional for AI features):

   export GOOGLE_API_KEY="your_api_key_here"

3. Run Jarvis:

   python3 main.py

4. Wake Up: Give a Double Clap to activate the assistant.

🎨 Aesthetic Design

The HUD is designed with "Liquid Glass" principles:

• Glassmorphism: Using NSVisualEffectView for real-time background blurring.
• Micro-animations: Smooth SVG transitions for "Thinking", "Listening", and "Standby" states.
• Minimalist: Frameless, transparent, and always-on-top for a HUD feel.

---

Built with ❤️ for the ultimate Mac productivity experience.