How titechprabhasolutions/brahma-ai-evo works
Brahma AI Evo is a Windows desktop AI environment. The main user journey is a voice or text request entering the desktop application, being interpreted and planned, then dispatched to an action that returns a result to the interface. The repository also includes separate capability branches for self-evolving skills, document work, hardware guidance, smart-home control, and Android device connectivity. Edges use README-documented relationships or visible source-index references; unsampled implementations and uncertain wiring are not expanded.
Main entry points: main.py Application Loop · executor.py Action Executor · llm_client.py Unified AI Client · server.py Connect Gateway
Components 29
Desktop Experience
- Application Loop
main.py - Command UI
ui.py - Local Dashboard
dashboard/server.py
Agent and Memory
- Task Planner
agent/planner.py - Action Executor
agent/executor.py - Task Queue
agent/task_queue.py - Unified AI Client
llm_client.py - Long-Term Memory
memory/memory_manager.py - Local Brain
core/local_brain.py
Desktop Capabilities
- File Processing
actions/file_processor.py - System Settings
actions/computer_settings.py - Game Updater
actions/game_updater.py - Instagram Tools
actions/instagram_mcp.py - Circuit Assembler
actions/circuit_assembler.py - Skill Crucible
core/skill_forge.py - Auto-Heal Engine
actions/auto_heal_engine.py - Smart Home Service
smart_home/service.py
Android Connect
- Connect Gateway
brahma_connect/gateway/server.py - Device Registry
brahma_connect/gateway/device_manager.py - Connect Protocol
brahma_connect/gateway/protocol.py - Gateway WebSocket
brahma_connect/gateway/websocket.py - Android Service
brahma-connect-android/app/src/main/java/com/brahma/connect/BrahmaConnectForegroundService.kt - Device Commands
brahma-connect-android/app/src/main/java/com/brahma/connect/commands/DeviceCommandHandler.kt - Agent State Store
brahma-connect-android/app/src/main/java/com/brahma/connect/core/AgentStateStore.kt
Supporting Services
- Smart Home Storage
smart_home/storage.py - Undo Support
core/undo.py - User Data Paths
core/user_paths.py - OpenRouter Client
or_client.py
Other components
- User
Connections 31
- User → Command UI: issues requests
README.md - Command UI → Application Loop: submits input
README.md - Application Loop → Task Planner: plans tasks
- Application Loop → Action Executor: dispatches actions
- Application Loop → Command UI: updates interface
README.md - Task Planner → Unified AI Client: reasons with
- Action Executor → Task Queue: queues tasks
- Action Executor → File Processing: runs tools
- Action Executor → System Settings: runs tools
- Action Executor → Game Updater: runs tools
- Action Executor → Instagram Tools: runs tools
- Action Executor → Circuit Assembler: runs tools
- Unified AI Client → OpenRouter Client: uses provider
llm_client.py - Unified AI Client → Long-Term Memory: uses memory
- Application Loop → Local Brain: uses reasoning
main.py - Skill Crucible → Unified AI Client: synthesizes skills
- Application Loop → Skill Crucible: supports skill creation
README.md - Auto-Heal Engine → Unified AI Client: analyzes failures
actions/auto_heal_engine.py - Application Loop → Auto-Heal Engine: supports repair
README.md - Smart Home Service → Smart Home Storage: stores device data
smart_home/service.py - User → Local Dashboard: uses dashboard
README.md - Android Service → Device Commands: creates handler
brahma-connect-android/app/src/main/java/com/brahma/connect/BrahmaConnectForegroundService.kt - Android Service → Gateway WebSocket: connects websocket
brahma-connect-android/app/src/main/java/com/brahma/connect/BrahmaConnectForegroundService.kt - Android Service → Agent State Store: tracks connection
brahma-connect-android/app/src/main/java/com/brahma/connect/BrahmaConnectForegroundService.kt - Connect Gateway → Device Registry: manages devices
brahma_connect/gateway/server.py - Connect Gateway → Connect Protocol: builds messages
brahma_connect/gateway/server.py - Connect Gateway → Gateway WebSocket: uses transport
brahma_connect/gateway/server.py - File Processing → Undo Support: registers undo
- System Settings → Undo Support: registers undo
actions/computer_settings.py - Unified AI Client → User Data Paths: loads data paths
llm_client.py - Long-Term Memory → User Data Paths: loads data paths
memory/memory_manager.py