__     __
   ___  \ \   / /___  _ __  __ _
  / _ \  \ \ / // _ \| '__|/ _` |
 |  __/   \ V /|  __/| |  | (_| |
  \___|    \_/  \___||_|   \__,_|
  

Voice-first multi-agent AI assistant that controls everything

---

⚡ Performance Benchmarks

eVera enforces strict performance budgets on every CI run. All 43 agents and 278+ tools are benchmarked.

Metric	Budget	What It Measures
Agent instantiation	< 50ms	Time to create any agent instance
Schema generation	< 0.5ms/tool	OpenAI function-calling schema per tool
Tier 0 routing	< 0.1ms	Regex-based instant classification
Keyword routing	< 1.0ms	Full keyword classification across 43 agents
Keyword throughput	> 10K ops/sec	Sustained routing throughput
Pure-logic tools	< 5ms	Tools with no I/O (hash, playlist, template)
SQLite tools	< 20ms	Database queries, schema, optimization
3D model generation	< 30ms	OBJ mesh generation (cube, sphere)
Full pipeline (mock)	< 100ms	agent.run() with mocked LLM
Parallel 10 tools	< 50ms	10 tools executing concurrently
Memory footprint	< 1 MB	Total registry memory usage
Registry load	< 2 sec	Loading all 43 agents + plugins

Run benchmarks locally:

pytest tests/test_benchmarks.py -v -s

📥 Quick Install

Desktop App (Recommended — one-click, no Python needed)

Platform	Download	Install
Windows	Vera-Setup.exe	Run the installer
macOS	Vera.dmg	Open DMG → drag to Applications
Linux	Vera.AppImage	chmod +x Vera-*.AppImage && ./Vera-*.AppImage

From Source (Developer)

git clone https://github.com/srpatcha/eVera.git && cd eVera
python -m venv .venv && source .venv/bin/activate   # Windows: .venv\Scripts\activate
pip install -r requirements.txt
cp .env.example .env                                 # Add your API keys
python main.py --mode server                         # Open http://localhost:8000

---

✨ Features

🎙️ Voice Control — 3 Modes

Always-on listening, wake word detection, or push-to-talk. Supports 19 languages with auto spell-correction.

🤖 24+ Specialized AI Agents — 183+ Tools

Core Agents (always loaded)

Agent	Tools	What It Does
💬 Companion	4	Chat, jokes, mood check, activity suggestions
💻 Operator	26	Apps, scripts, files, mouse, keyboard, windows, processes, admin, GUI dialogs
🌐 Browser	11	Navigate, login, fill forms, post on social media (auto-installs Playwright)
🔍 Researcher	4	Web search, summarize URLs, papers, fact-check
✍️ Writer	4	Draft, edit, format, translate
📅 Life Manager	9	Calendar, reminders, todos, email (IMAP read/reply/search)
🏠 Home Controller	7	Lights, thermostat, locks, security, media, setup wizard
📈 Income	15	Real-time prices, paper trading, Alpaca, IBKR, trading setup wizard
💻 Coder	5	Read/write/edit files, search code, VS Code (path overrides)
📦 Git	10	Status, diff, commit, push, AI code review, create PRs
🎬 Content Creator	5	Video scripts, AI video generation, social media scheduling, SEO
🏦 Finance	6	Bank balances, transactions, spending analysis, budgets
📋 Planner	8	Morning plans, daily/weekly/monthly reviews, goal setting, Eisenhower matrix
🧘 Wellness	7	Focus sessions (pomodoro), breaks, screen time, energy tracking, burnout prevention
📰 Digest	6	RSS feeds, news digests, reading lists, thread summarization
🌍 Language Tutor	5	Language lessons, vocabulary, grammar, pronunciation, quizzes (16+ languages)
🗺️ Codebase Indexer	4	Project indexing, architecture analysis, definition extraction, related files
📝 Meeting	3	Extract action items, parse meeting notes, create tasks from transcripts
📊 Diagram	4	Call graphs, class diagrams, flowcharts, export to SVG/PNG/PDF

Conditional Agents (enabled via config)

Agent	Tools	Enabled By	What It Does
📱 Mobile Controller	6	VERA_MOBILE_CONTROL_ENABLED	Send notifications, open apps, set alarms, toggle settings
💼 Job Hunter	12	VERA_JOB_ENABLED	Autonomous job search, resume matching, auto-apply, application tracking
🎫 Jira	7	VERA_JIRA_ENABLED	Tickets, sprints, create/update issues, JQL search, comments
🚀 Work Pilot	3	VERA_JIRA_ENABLED	Autonomous ticket→branch→code→PR→Jira workflow
🎨 Media Factory	12	VERA_MEDIA_ENABLED	Image gen (Pollinations/DALL-E), photo editing, video assembly, subtitles, voiceovers, YouTube/Instagram/TikTok upload

💻 Full System Control (v0.5.0+)

• 🖱️ Mouse — click, move, drag, scroll at any screen coordinates
• ⌨️ Keyboard — press any hotkey (Ctrl+C, Alt+Tab, Win+D)
• 🪟 Windows — list, focus, minimize, maximize, close windows
• ⚙️ Processes — list, inspect, kill running processes
• 📊 System Info — CPU, memory, disk, battery, OS details
• 🔧 Services — list, start, stop, restart system services
• 🌐 Network — IP info, connections, ping test
• 📋 Clipboard — read/write system clipboard
• 🔔 Notifications — send OS-level desktop notifications

🆕 New in v0.9.0 — 3D Holographic Avatar

• 🎭 3D Avatar — Full Three.js WebGL humanoid replacing 2D canvas face: procedural body, holographic shaders, particle aura
• 🤖 8 Gesture Animations — Chin stroke, wave, thumbs up, open palms, clasped hands, defensive, droop — auto-triggered by expression
• ✨ Holographic Materials — Custom GLSL shaders with fresnel glow, circuit-line patterns, energy pulse waves
• 🛡️ Production Hardened — WebGL/Three.js fallback, Page Visibility API, FPS monitoring, CSP headers, SRI CDN, error boundaries
• 🔒 Security Upgrade — Content Security Policy meta tag, X-Content-Type-Options, Referrer-Policy, crossorigin CDN loading

🆕 New in v0.8.0 — eVera Rebrand

• 🏷️ Full rebrand — eSri → eVera across 165 files, all imports, class names, configs, UI, and CI/CD
• 📦 Unified versioning — All packages (Python, Electron, mobile) synced to v0.8.0
• 🔄 CI/CD overhaul — Consolidated workflows, automated cross-platform releases

🆕 v0.7.0 — Office Work Automation

• 🎫 Jira Integration — Full REST API: get/create/update tickets, sprint boards, JQL search, comments
• 🚀 Work Pilot — Autonomous pipeline: fetch ticket → create branch → commit → push → create PR → update Jira
• 📝 Meeting Agent — Extract action items from transcripts, auto-create todos + Jira tickets
• 🗺️ Codebase Indexer — Index projects, extract definitions, architecture summaries, find related files
• 💬 Slack Channel Monitor — Poll channels for activity, @mention alerts, message summaries
• 🔀 PR Creation — git_create_pr tool via gh CLI or GitHub REST API fallback
• ⏰ 2 New Scheduler Loops — Automatic ticket scanning + channel monitoring
• ⚙️ 4 New Config Blocks — VERA_JIRA_*, VERA_CHANNEL_*, VERA_CODEBASE_*, VERA_MEETING_*

🎭 3D Holographic Avatar (v0.9.0)

Full Three.js WebGL humanoid avatar replacing the 2D canvas face:

• Procedural geometric mannequin body — head, torso, neck, arms, hands with 5 fingers
• Holographic ShaderMaterial — fresnel rim glow, circuit-line UV grid, energy pulse wave, wireframe overlay
• 8 gesture animations auto-triggered by expression — chin stroke, wave, thumbs up, open palms, clasped hands, defensive, droop, rest
• 200-particle aura with orbital motion and additive blending
• Idle breathing, head micro-bob, shoulder sway, finger micro-curl
• Production hardened — WebGL fallback, Page Visibility API (pauses when tab hidden), FPS monitoring with adaptive quality, CSP headers, SRI-protected CDN with local fallback, complete resource cleanup on destroy, error boundaries

👁️ Screen Vision + Real-time Monitoring

Captures your screen → GPT-4o / Gemini vision analysis. Ask "what's on my screen?" Enable VERA_VISION_MONITOR_ENABLED=true for continuous background monitoring with hash-based debounce.

📊 Real Stock Trading

Paper trading, Alpaca, Interactive Brokers, TradingView alerts webhook.

🧠 4-Layer Memory

Working memory → Episodic (FAISS vectors) → Semantic (user facts) → Encrypted vault.

🛡️ Security Hardened

API auth, PII redaction, path sandboxing, command blocking, encrypted credentials, trade confirmation.

🧠 Emotional Intelligence

Sentiment analysis (keyword + LLM hybrid), mood tracking, pattern detection, proactive empathy notifications.

---

🐳 Docker Deployment

Quick Start (one command)

# Clone and start (includes Ollama local LLM)
git clone https://github.com/embeddedos-org/eVera.git && cd eVera
docker compose up -d
# Open http://localhost:8000

Build & Run

# Build image
docker compose build

# Start all services (eVera + Ollama)
docker compose up -d

# View logs
docker compose logs -f vera

# Stop
docker compose down

Docker Architecture

┌───────────────────────────────────────────────────┐
│            Docker Compose Stack              │
├────────────────────────┬──────────────────────────┤
│   eVera Server         │   Ollama LLM           │
│   ────────────────   │   ────────────────── │
│   Python 3.12          │   llama3.2 (default)   │
│   FastAPI + WebSocket   │   GPU acceleration     │
│   43 Agents / 278 Tools │   Auto model pull      │
│   Port: 8000            │   Port: 11434          │
└────────────────────────┴──────────────────────────┘
         │ vera-data volume      │ ollama-models volume

Available Commands

make help          # Show all commands
make up            # Start all services
make down          # Stop all services
make logs          # Tail eVera logs
make test          # Run tests in container
make bench         # Run benchmarks in container
make shell         # Open shell in container
make health        # Check service health
make pull-model    # Pull Ollama model
make prod-up       # Start in production mode
make clean         # Remove everything

Production Deployment

# Set required env vars
export VERA_SERVER_API_KEY="your-secure-key"
export VERA_LLM_OPENAI_API_KEY="sk-..."

# Start with production overrides (GPU, resource limits, logging)
docker compose -f docker-compose.yml -f docker-compose.prod.yml up -d

Container Modes

docker run evera server     # Web UI + REST API (default)
docker run evera text       # Text-only CLI mode
docker run -it evera shell  # Interactive shell
docker run evera test       # Run test suite
docker run evera benchmark  # Run performance benchmarks

🏗️ Architecture

┌──────────────────────────────────────────────────────────────────┐
│  📱 Desktop App (Electron)                                       │
│  ┌─────────────────────────────────────────────────────────────┐ │
│  │ Auto-starts Python backend • Splash screen • System tray   │ │
│  └──────────┬──────────────────────────────────────────────────┘ │
│             │ localhost:8000                                      │
│  ┌──────────▼──────────────────────────────────────────────────┐ │
│  │              🎭 Web UI (glassmorphism)                       │ │
│  │  Animated Face │ Waveform │ Chat │ Agent Dashboard          │ │
│  └──────────┬──────────────────────────┬───────────────────────┘ │
│             │ WebSocket                │ REST API                 │
│  ┌──────────▼──────────────────────────▼───────────────────────┐ │
│  │              VeraBrain (FastAPI + LangGraph)                 │ │
│  │  Enrich → Classify → Safety → [Agent/Tier0] → Store → Out  │ │
│  │                                                              │ │
│  │  ┌────────────┐  ┌──────────────┐  ┌──────────────────────┐ │ │
│  │  │MemoryVault │  │ 24+ Agents   │  │ Provider Manager     │ │ │
│  │  │ 4 layers   │  │ 183+ tools   │  │ Ollama/OpenAI/Gemini │ │ │
│  │  └────────────┘  └──────────────┘  └──────────────────────┘ │ │
│  │  ┌────────────┐  ┌──────────────┐  ┌──────────────────────┐ │ │
│  │  │ Safety     │  │ Event Bus    │  │ Proactive Scheduler  │ │ │
│  │  │ Policy+PII │  │ SSE stream   │  │ 15 background loops  │ │ │
│  │  └────────────┘  └──────────────┘  └──────────────────────┘ │ │
│  └─────────────────────────────────────────────────────────────┘ │
└──────────────────────────────────────────────────────────────────┘

Tier-Based LLM Routing

Tier	Name	Engine	Cost	Example
0	Reflex	Regex	Free	"What time is it?"
1	Executor	Ollama (local)	Free	"Turn off the lights"
2	Specialist	GPT-4o-mini / Gemini Flash	$	"Draft an email to John"
3	Strategist	GPT-4o	$$	"Start work on ticket PROJ-123"

---

🗣️ Voice Commands

System Control

"Open Chrome" / "Launch VS Code" / "Open Spotify"
"Click at 500, 300" / "Double click the button"
"Press Ctrl+C" / "Alt+Tab" / "Win+D"
"List all windows" / "Focus Chrome" / "Minimize Slack"
"What processes are running?" / "Kill notepad"
"What's my CPU usage?" / "How much disk space?"
"Take a screenshot" / "What's on my screen?"

Conversation & Life

"Hey Vera, how are you?" / "Tell me a joke"
"Schedule a meeting tomorrow at 3pm"
"Remind me to call Mom in 2 hours"
"Add 'buy groceries' to my todo list"

Web & Research

"Go to twitter.com" / "Login to GitHub"
"Search the web for AI news"
"Summarize this URL: ..."

Stock Trading

"What's Apple's stock price?"
"Buy 10 shares of Tesla" (paper or real)
"Show my portfolio" / "How's the market?"

Smart Home

"Turn on the living room lights"
"Set thermostat to 72 degrees"
"Lock the front door"

Office & Work (v0.7.0+)

"Show my Jira tickets" / "Get ticket PROJ-123"
"Create a ticket: fix login bug"
"Check the sprint board"
"Start work on PROJ-456" → Creates branch, tracks state
"Complete work on PROJ-456" → Commits, pushes, creates PR, updates Jira
"Extract action items from these meeting notes: ..."
"Create tasks from this transcript: ..."
"Index the project at /path/to/repo"
"What's the architecture of this project?"
"Find files related to authentication"
"Create a PR for this branch"

Media Creation (v0.8.1+)

"Generate an image of a sunset over the ocean"
"Edit image — resize to 1080x1920" / "Make it grayscale" / "Remove the background"
"Add text overlay: Breaking News"
"Create a voiceover: Welcome to today's update"
"Assemble a video from these images with Ken Burns transitions"
"Add subtitles to this video"
"Create a reel about AI trends and upload to YouTube"
"Upload this video to Instagram as a reel"

Productivity

"Plan my day" / "Daily review" / "Set a goal"
"Start a focus session" / "Take a break"
"Generate my daily digest" / "What's the news?"
"Teach me Spanish" / "Quiz me on French vocabulary"

---

🔌 API Reference

Method	Path	Description
GET	/health	Health check
GET	/status	System status + memory stats
GET	/agents	List all agents
POST	/chat	Send transcript, get response
GET	/memory/facts	List semantic facts
POST	/memory/facts	Store a fact
GET	/events/stream	SSE event stream
POST	/webhook/tradingview	TradingView alert webhook
WS	/ws	WebSocket real-time chat
WS	/ws/voice	Voice I/O (PCM16 in, TTS audio out)
WS	/ws/mobile	Mobile device control (protocol docs)

---

🖥️ Platform Support

Platform	Client	System Control	Voice	CI Tested
Windows	.exe NSIS	Full (26 tools)	✅	✅
macOS	.dmg	Full (26 tools)	✅	✅
Linux	.AppImage + .deb	Full (26 tools)	✅	✅
Android	React Native	Remote (via server)	✅ Native STT/TTS	—
iOS	React Native	Remote (via server)	✅ Native STT/TTS	—

---

⚙️ Configuration — Office Automation & Media

Add to your .env file to enable advanced features:

# Jira Integration
VERA_JIRA_ENABLED=true
VERA_JIRA_BASE_URL=https://myorg.atlassian.net
VERA_JIRA_USERNAME=you@company.com
VERA_JIRA_API_TOKEN=your_jira_api_token
VERA_JIRA_PROJECT_KEY=PROJ
VERA_JIRA_BOARD_ID=1
VERA_JIRA_SCAN_INTERVAL_MINUTES=15

# Slack Channel Monitoring
VERA_CHANNEL_ENABLED=true
VERA_CHANNEL_CHANNELS=["C01ABC123","C02DEF456"]
VERA_CHANNEL_POLL_INTERVAL_MIN=5
VERA_CHANNEL_SUMMARIZE=true
VERA_CHANNEL_MENTION_ALERT=true

# Codebase Indexer (enabled by default)
VERA_CODEBASE_DEFAULT_PROJECT_PATH=/path/to/your/project
VERA_CODEBASE_MAX_FILES=500

# Meeting Agent (enabled by default)
VERA_MEETING_AUTO_CREATE_TICKETS=false
VERA_MEETING_AUTO_CREATE_TODOS=true

# Media Factory (enabled by default)
VERA_MEDIA_ENABLED=true
VERA_MEDIA_DALLE_API_KEY=              # Optional: premium image gen (free Pollinations used by default)
VERA_MEDIA_YOUTUBE_CLIENT_SECRETS_PATH= # Path to YouTube OAuth client_secret.json
VERA_MEDIA_INSTAGRAM_ACCESS_TOKEN=      # Instagram Graph API token
VERA_MEDIA_DEFAULT_VOICE=en-US-AriaNeural
VERA_MEDIA_DEFAULT_ASPECT_RATIO=9:16
VERA_MEDIA_DEFAULT_IMAGE_PROVIDER=pollinations  # pollinations (free) or dalle

---

🔒 Security

eVera includes multiple security layers to prevent misuse and protect sensitive data:

Layer	Description
Policy Engine	Rule-based ALLOW/CONFIRM/DENY per agent.tool pattern (vera/safety/policy.py)
Path Sandboxing	All file operations validated against ALLOWED_ROOTS and BLOCKED_PATHS
PII Detection	Real-time PII scanning with auto-redaction before LLM calls
RBAC	Role-based access control (admin/user/viewer) with API key auth
Command Blocking	50+ dangerous shell patterns blocked (rm -rf, format, dd, etc.)
Injection Prevention	PowerShell/AppleScript input escaping, shlex parsing for sudo
Audit Logging	Every tool execution and elevated action logged with timestamps

---

🧪 Testing — 650+ Tests

python verify.py                    # Pre-push verification (all checks)
pytest tests/ -v

# Run only new agent tests
pytest tests/test_new_agents_registry.py tests/test_new_agents_tools.py tests/test_new_agents_routing.py -v

# Run performance benchmarks
pytest tests/test_benchmarks.py -v -s                    # All tests (524+ pass)
pytest tests/ --cov=vera            # With coverage
ruff check . && ruff format .       # Lint

---

🔧 Development

Build from Source

# 1. Backend
python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
python main.py --mode server

# 2. Electron app (dev mode)
cd electron && npm install && npm start

# 3. Build standalone installer
python build_backend.py             # Bundle Python backend
cd electron && node build.js win    # Package for Windows

Tech Stack

Component	Technology
Orchestration	LangGraph StateGraph
LLM	litellm → Ollama / OpenAI / Gemini
Desktop	Electron 28 + PyInstaller
GUI Automation	pyautogui + pygetwindow
System	psutil + pyperclip
STT/TTS	faster-whisper / pyttsx3 / edge-tts / Web Speech
Vector Store	FAISS + sentence-transformers
Browser	Playwright
Trading	yfinance + Alpaca + IBKR
Tickets	Jira Cloud REST API + httpx
Web UI	Vanilla JS + Three.js WebGL + Canvas + Web Audio
API	FastAPI + WebSocket + SSE

---

📦 Releases

See CHANGELOG.md for full version history.

Version	Date	Highlights
0.9.0	2026-04-24	3D Avatar: Three.js holographic mannequin, gesture animations, production hardening, CSP security
0.8.0	2026-04-22	Rebrand: eSri → eVera, unified versioning, CI/CD overhaul
0.7.0	2026-04-22	Office automation: Jira agent (7 tools), Work Pilot (ticket→PR), Meeting agent, Codebase Indexer, Slack channel monitor, PR creation, 4 new config blocks
0.6.0	2026-04-21	Vision monitor, voice server, admin ops, GUI tools, path overrides, Playwright auto-install, setup wizards, mobile control
0.5.1	2026-04-20	Content creator, finance agent, email management, enhanced scheduler
0.5.0	2026-04-19	Standalone desktop app (Win/Mac/Linux), 12 new system control tools, CI/CD builds
0.4.1	2026-04-18	200+ tests, self-recovery, verify script
0.4.0	2026-04-18	Multi-agent crews, workflow engine, RBAC, Git agent, plugins
0.3.1	2026-04-17	Security hardening: API auth, encrypted credentials
0.3.0	2026-04-17	Browser agent, stock trading, screen vision
0.2.0	2026-04-17	Animated face, always-listening, buddy personality
0.1.0	2026-04-16	Initial release: 7 agents, LangGraph pipeline

---

📚 Documentation

Full documentation is available in the docs/ folder:

Document	Description
Documentation Home	Index of all documentation
Getting Started	Installation, first run, configuration
Architecture	System design and component overview
Agents Reference	All 24+ agents with tools and examples
API Reference	REST, WebSocket, and SSE endpoints
Security	Safety policies, PII, sandboxing
Configuration	All environment variables
Development	Building, testing, contributing
FAQ	Troubleshooting and common questions
Diagrams	7 Mermaid architecture diagrams

Generate API Docs (Doxygen)

pip install -r docs/requirements.txt
cd docs && doxygen Doxyfile          # HTML → docs/html/index.html
cd latex && make                      # PDF  → docs/latex/refman.pdf

---

🤝 Contributing

1. Fork → git checkout -b feature/amazing
2. Make changes → pytest tests/ -v → ruff check .
3. git commit -m "Add amazing feature" → Push → Open PR

---

📄 License

MIT — see LICENSE for details.

---

Built with ❤️ by Srikanth Patchava
eVera — Your AI assistant that actually does things.

Security

Please see SECURITY.md for reporting vulnerabilities.

Contributing

Please see CONTRIBUTING.md for contribution guidelines.

---

Part of the EmbeddedOS Organization.