How titechprabhasolutions/brahma-echo works
Brahma Echo is a Windows desktop AI assistant whose main workflow is accepting voice or text requests, interpreting them with AI, and carrying out desktop or productivity actions. Its wider product includes screen context, learning and self-healing, smart-home controls, and remote Android access. The graph preserves those documented branches; some subsystem links rely on README descriptions or source-index references rather than sampled call sites, so those relationships are dashed where their exact runtime wiring is unverified.
Main entry points: main.py Assistant Entry · executor.py Action Executor · llm_client.py AI Client · service.py Connect Service
Components 27
Assistant Runtime
- Assistant Entry
main.py - Desktop UI
ui.py - Local Dashboard
dashboard/server.py - Task Planner
agent/planner.py - Action Executor
agent/executor.py
AI and Learning
- AI Client
llm_client.py - OpenRouter Client
or_client.py - Long-term Memory
memory/memory_manager.py - Learned Rules
core/learned_rules.py - Self-healing
actions/auto_heal_engine.py
Desktop Actions
- Screen Context
actions/screen_processor.py - File Operations
actions/file_controller.py - File Inspection
actions/file_processor.py - Browser Automation
actions/browser_control.py - Google Workspace
actions/google_workspace_mcp.py - System Diagnostics
actions/system_diagnostics_mcp.py - Smart Home
smart_home/service.py
Remote Connect
- Connect Controls
actions/brahma_connect.py - Connect Service
brahma_connect/service.py - Connect Gateway
brahma_connect/gateway/server.py - Command Router
brahma_connect/gateway/command_router.py - Device Registry
brahma_connect/gateway/device_manager.py - Android Companion
brahma-connect-android/app/src/main/java/com/brahma/connect/commands/DeviceCommandHandler.kt - Android WebSocket
brahma-connect-android/app/src/main/java/com/brahma/connect/network/BrahmaWebSocketClient.kt
Integrations
- AI Provider
- Playwright MCP
Other components
- User
Connections 27
- User → Assistant Entry: requests tasks
- Assistant Entry → Desktop UI: presents assistant
main.py - Assistant Entry → Task Planner: plans tasks
- Task Planner → Action Executor: dispatches actions
- Assistant Entry → AI Client: requests AI
main.py - AI Client → OpenRouter Client: uses fallback
llm_client.py - AI Client → AI Provider: sends prompts
- Assistant Entry → Long-term Memory: uses memory
main.py - Assistant Entry → Learned Rules: loads learned rules
main.py - Assistant Entry → Self-healing: offers self-repair
- Assistant Entry → Screen Context: inspects screen
main.py - Action Executor → File Operations: dispatches file actions
- Action Executor → File Inspection: dispatches inspection
- Action Executor → Browser Automation: dispatches browser actions
- Action Executor → Google Workspace: dispatches workspace actions
- Action Executor → System Diagnostics: dispatches diagnostics
- Action Executor → Smart Home: dispatches controls
- Browser Automation → Playwright MCP: uses MCP
- Connect Controls → Connect Service: calls service
actions/brahma_connect.py - Connect Service → Connect Gateway: starts gateway
brahma_connect/service.py - Connect Gateway → Command Router: routes commands
brahma_connect/gateway/server.py - Connect Gateway → Device Registry: manages devices
brahma_connect/gateway/server.py - Command Router → Device Registry: resolves devices
brahma_connect/gateway/command_router.py - Android WebSocket → Android Companion: dispatches commands
brahma-connect-android/app/src/main/java/com/brahma/connect/network/BrahmaWebSocketClient.kt - Local Dashboard → Assistant Entry: submits commands
main.py - User → Local Dashboard: uses remote dashboard
- Connect Service → Android WebSocket: communicates remotely