Brahma Echo

Open-source Windows desktop AI assistant

Voice-first automation · contextual desktop intelligence · productivity workflows

---

Overview

Brahma Echo is a premium Windows desktop assistant that combines voice and text control with automated workflows, screen-aware intelligence, and rich content generation.

Designed for advanced desktop productivity, Brahma Echo delivers:

• Voice-first command and desktop automation
• Application control, browser workflows, and file handling
• Contextual screen inspection and adaptive task execution
• Presentation, document, and report generation
• Remote control via Discord and Brahma Connect

Quick Highlights

Core capability	Why it matters
Voice-first assistant	Speak commands naturally and stay hands-free
Gemini + OpenRouter	Fast responses with resilient fallback support
Screen-aware context	Ask about visible windows and on-screen content
Document automation	Create presentations, docs, spreadsheets, and PDFs
Plugin-ready	Extend features with lightweight Python plugins

Key Benefits

• Wake-word support for “Brahma Echo” and responsive assistant activation
• Gemini 2.5 Flash-powered AI with OpenRouter fallback resilience
• Polished Qt interface with live status displays and workflow cards
• Modular action architecture for clean extensibility and automation
• Secure local configuration with file-based credential storage
• Device pairing and remote routing through Brahma Connect

Features

Intelligent Assistant

• Unified voice and typed command handling
• Wake-word listening and responsive assistant activation
• Dynamic screen inspection for context-aware answers
• Automatic briefings with Edge TTS playback
• Gemini-first AI with OpenRouter fallback resilience

Productivity & Automation

• Open and control Windows apps, windows, files, and system actions
• Browser automation with Playwright-driven workflows
• Contextual automation based on screen content and notifications
• Reminder, meeting assistance, and notification management

Content & Office Tools

• Generate presentation decks, summaries, and slide content
• Create Word documents and spreadsheets from prompts
• Export polished reports and deliverables as PDF
• Build landing pages and website workspaces locally

Integrations

• Discord bridge for remote commands and collaboration
• OpenRouter fallback for uninterrupted AI access
• Configurable voice, UI, startup, and notification settings
• Brahma Connect for device discovery and command routing

Getting Started

Prerequisites

• Windows 10 or Windows 11
• Python 3.11 or Python 3.12
• Git installed
• Gemini API key
• OpenRouter API key (optional but recommended)

1. Clone the repository

git clone https://github.com/titechprabhasolutions/Brahma-AI---Lite.git
cd "Brahma AI - Lite"

2. Create and activate a virtual environment

python -m venv .venv
.\.venv\Scripts\Activate.ps1

3. Install dependencies

pip install -r requirements.txt
playwright install

4. Configure API credentials

Create config/api_keys.json with your keys:

{
  "gemini_api_key": "YOUR_GEMINI_API_KEY",
  "openrouter_api_key": "YOUR_OPENROUTER_API_KEY"
}

Gemini API Key

1. Create a Google Cloud or Gemini account.
2. Enable Gemini API access for your project.
3. Add the generated key to gemini_api_key.

OpenRouter API Key

1. Register at https://openrouter.ai.
2. Generate an sk-or- API key.
3. Add the key to openrouter_api_key.

5. Optional: Configure Discord integration

If you want Discord remote control, populate config/discord_bot.json with your bot credentials and connection settings.

6. Launch Brahma Echo

python main.py

For a cleaner startup experience on Windows:

start_brahma.vbs

Configuration

Core configuration files:

• config/api_keys.json — Gemini and OpenRouter credentials
• config/app_settings.json — voice, UI, startup, and automation preferences
• config/brahma_connect.json — device pairing, gateway, and discovery settings
• config/discord_bot.json — Discord bridge configuration

Project Structure

• main.py — application startup, AI orchestration, and command routing
• ui.py — Qt-based desktop interface and live assistant controls
• actions/ — modular automation, document, and assistant tools
• brahma_connect/ — local gateway, pairing, and remote routing
• config/ — local settings, credentials, and runtime configuration
• plugins/ — optional plugin extensions
• tests/ — integration and validation tests

Plugin System

Extend Brahma Echo with custom Python plugins by adding files to plugins/.

Supported hooks:

• on_brahma_created(brahma) — called when the assistant instance is initialized
• on_startup(brahma) — called after startup when plugins are registered
• on_text_command(text, source, brahma=None) — called for each incoming text command; return True to indicate the command was handled

Best Practices

• Keep credentials in config/api_keys.json and avoid committing secrets.
• Use the virtual environment for all development and runtime sessions.
• Restart the app after changing config or adding plugins.
• Review config/app_settings.json to tune voice, UI, and automation behavior.

Community & Support

• Discord: https://discord.gg/gEYmJKKtq3

License

This project is published under a custom source-available license. See LICENSE for details.

Maintainer

• Suryaansh Tiwari

Preserve attribution and keep credentials secure when building on top of Brahma Echo.