Brahma AI Evo is a next-generation desktop intelligence built to function like an authentic JARVIS workstation. Combining real-time bi-directional native voice audio, multimodal computer vision, autonomous code self-evolution, and local system orchestrations, Brahma Evo transforms your Windows PC into a self-evolving command center.
- Screen & Voice Part Recognition: Brahma scans your screen via computer vision or parses voice commands (
"Brahma, how to connect DHT11 to Arduino Pro Mini") to recognize microcontrollers (Arduino Uno, Pro Mini, ESP32), sensors (DHT11, HC-SR04 ultrasonic, servos), and passive components. - In-App Interactive Pop-up: Opens a compact, dark glassmorphic popup overlay directly inside Brahma showing:
- Component cards with pinout labels (
VCC,DATA,GND,2,p8,p9). - Animated glowing neon SVG wires with real-time flowing white electron pulse dots.
- Numbered pin bubbles (
①,②,③,④,⑤). - Operating voltage safety callouts and ready-to-flash Arduino C++ firmware.
- Component cards with pinout labels (
- On-the-Fly Code Synthesis: When asked to execute a task outside its built-in toolkit, Brahma identifies the capability gap, writes a brand-new Python tool directly into
features/, tests it inside an isolated sandbox ("The Crucible"), and auto-registers it dynamically without restarting the application. - Persistent Vault: All forged skills are saved in your
features/directory and hot-reloaded automatically.
- Self-Repairing Codebase: Background sentry catches runtime exceptions, analyzes tracebacks using LLM root-cause reasoning, applies dynamic patches to the faulty code, and presents an interactive HUD repair telemetry card without crashing the assistant.
- Live Physical Frequency Spectrum: 9-bar reactive audio visualizer embedded directly into the Command Bar.
- Dynamic State Glow States:
- 🟡 Gold: Standby / Listening
- 🔵 Cyan / Blue: Capturing Voice (Live Energy Wave)
- 🟣 Purple: Brahma Reasoning / Thinking
- 🟢 Green: Executing Tool / System Action
- 🔴 Red: Muted
- Agentic Step-by-Step HUD Cards: Collapsible execution traces embedded directly into chat bubbles.
- Features sub-second execution latency chips (
[180ms],[120ms]), status badges (COMPLETED), and expandable[Inspect]drawers for parameters and raw JSON payloads.
- 3D Earth & 2D Street Mapping: WebGL spherical Earth globe with live great-circle flight routes, real-time aircraft radar tracking, turn-by-turn highway driving routes, and nearby POI scans (hospitals, fuel, ATMs).
- Built on the open Model Context Protocol (MCP) for robust, reliable music playback, album/artist searches, queue control, volume adjustment, and active device handover between PC and mobile.
- Complete Settings UI featuring dedicated cards for every connected service:
- Google Gemini API (Live Voice & Vision)
- Spotify MCP (Client ID & Client Secret)
- OpenRouter / Anthropic
- Weather & Radar APIs
- Instagram & Smart Home
- Instant live test-connection buttons.
- Sub-500ms low-latency conversation via Gemini 2.5 Flash Native Audio.
- Live webcam and desktop screen vision for real-time document analysis, code debugging, and hardware component recognition.
- Application & Process Manager: Launch, control, inspect, and freeze memory-heavy background processes.
- System Settings: Toggle Wi-Fi, adjust volume, screen brightness, dark/light themes, and monitor CPU/RAM/Battery metrics.
- Smart Window Control: Minimize, maximize, tile, or arrange windows across multi-monitor setups.
- Clipboard Sentry: Instant analysis, translation, formatting, or debugging of copied text/code.
- Word (
.docx): Generate formatted professional documents, reports, and resumes. - Excel (
.xlsx): Create complex multi-sheet workbooks with formulas, charts, and financial models. - PowerPoint (
.pptx): Build branded presentations with slide layouts, typography, and speaker notes. - PDF Suite: Convert, merge, extract, and assemble PDF deliverables.
- AI Phone Call Proxy: Brahma screens incoming phone calls, talks to the caller, takes meeting notes, and delivers immediate desktop transcripts and summaries.
- Ecosystem Sync: Device geolocation, SMS notifications, and battery status.
- Control smart lights, smart plugs, AC units, fans, and televisions with direct Tuya and Home Assistant integrations.
- Adaptive memory engine stores personal user preferences, ongoing projects, and custom instructions across sessions.
- Windows 10 / 11 (64-bit)
- Python 3.11 or Python 3.12
- Git
- Working Microphone & Speakers (Webcam optional for vision)
- Google Gemini API Key (Get from Google AI Studio)
-
Clone the repository:
git clone https://github.com/titechprabhasolutions/Brahma-Ai-Evo.git cd Brahma-Ai-Evo
-
Run the Automated Setup:
python setup.py
Or launch using the included batch file:
start_brahma.bat
-
Configure API Keys:
- Launch Brahma AI Evo.
- Click the Settings icon on the top navigation bar.
- Enter your Gemini API Key and any optional credentials (Spotify MCP, Weather, etc.) into the respective cards.
- Click Save & Connect.
| Intent | Sample Voice / Text Command |
|---|---|
| Hardware Circuit | "Brahma, how to connect DHT11 to Arduino Pro Mini" |
| Circuit Vision | "See the Arduino parts on my screen and tell me how to assemble them" |
| Self-Evolution | "Brahma, learn a new skill to track International Space Station coordinates" |
| Flight Radar | "Show flight route from Mumbai to London" |
| Nearby Amenities | "Find nearby hospitals on the map" |
| Music Playback | "Play Starboy on Spotify" |
| Phone Screening | "Screen this incoming call for me" |
| Office Documents | "Create a project roadmap spreadsheet in Excel" |
| System Health | "Check system resources and kill heavy apps" |
Brahma AI Evo/
├── main.py # Main application entry point & live event loop
├── ui.py # PyQt6 GUI: Command Bar, Waveform FFT, HUD Wings, Chat
├── actions/ # Built-in action tools & executors
│ ├── circuit_assembler.py # Hardware vision & circuit solver engine
│ ├── spotify_controller.py # Spotify MCP client & playback manager
│ ├── geospatial_globe.py # Great-circle routes, radar & POI fetcher
│ ├── auto_heal_engine.py # Proactive exception interceptor & patcher
│ ├── call_assistant.py # Android phone call proxy & transcript analyzer
│ └── office_builder.py # Excel, Word, PPTX & PDF generators
├── core/ # Core system architecture
│ ├── circuit_hud.py # Compact in-app holographic circuit popup overlay
│ ├── globe_window.py # 3D WebGL Earth globe & map controller
│ ├── skill_forge.py # Project Ultron: LLM skill synthesizer
│ ├── skill_crucible.py # Isolated test execution sandbox
│ ├── dynamic_registry.py # Runtime tool hot-reloader & dispatcher
│ └── identity.py # System prompt & behavioral core
├── features/ # Self-evolved & custom Python tools
│ ├── circuit_schematic.py # Modular circuit schematic feature
│ └── spotify_mcp.py # Modular Spotify feature
├── smart_home/ # Smart device provider & discovery services
└── brahma-connect-android/ # Companion Android mobile application
- All long-term memories, credentials, and configuration files are stored locally in
%LOCALAPPDATA%\BrahmaAI\. - External tools run through permission sentries and the isolated Crucible sandbox.
- Audio and video frames are only streamed during active conversation sessions.
Personal & Private Local Use Only — No Distribution.
This project is licensed under the Brahma AI Evo Source-Available Personal Use License.
- ✅ Allowed: You may download, clone, inspect, build, and run the software locally strictly on your own personal device for private, personal, educational, and research use.
- 🚫 Strictly Prohibited (No Distribution): You may NOT distribute, redistribute, re-upload, mirror, share, transmit, sublicense, or publish this software, repository, binaries, or derivative works anywhere (including other Git hosts, public repositories, or cloud platforms). The only official distribution source is this repository.
- 🚫 Strictly Prohibited (No Commercial Use): You may NOT sell, rent, monetize, bundle, commercialize, or host this software as a paid SaaS/cloud service.
For full terms and legal conditions, see the LICENSE file. For commercial licensing inquiries, reach out via Discord.
Brahma AI Evo • Built with intelligence, precision, and autonomy.