Electro

Cloud-native AI agent runtime, written in Rust.
_{Deploy once. Runs forever. Thinks on a budget.}

---

What is Electro

Electro is a cloud-native AI agent runtime written in Rust. It connects to messaging channels, routes messages through an agent loop that calls AI providers, executes tools, and persists conversation history to memory backends—all from a single binary that runs headless on minimal hardware.

Capabilities

• Multi-channel deployment: Telegram, Discord, Slack, CLI, or interactive TUI
• 6 AI providers: Anthropic, OpenAI, Google Gemini, xAI Grok, OpenRouter, and ChatGPT via OAuth—no API key needed for Codex
• Built-in tools: Shell, vision browser (screenshot → click), file ops, web fetch, git, MCP client
• λ-Memory: Exponential decay memory with hash-based recall
• Blueprints: Structured, replayable recipes that capture learned procedures
• Many Tems: Stigmergic swarm intelligence for parallel task execution
• Eigen-Tune: Self-tuning distillation that trains local models from LLM interactions

Quick Start

# Clone and build
git clone https://github.com/dawsonblock/Electro.git && cd Electro
cargo build --release

Mode 1 — Interactive TUI

./target/release/electro tui

Mode 2 — Server with Telegram bot

export TELEGRAM_BOT_TOKEN="your-token"
./target/release/electro start

See docs/setup/getting-started.md for full setup instructions.

Documentation

Guide	Description
docs/setup/getting-started.md	Initial setup and configuration
docs/setup/docker-oauth.md	Docker deployment with OAuth
docs/dev/getting-started.md	Development environment setup
docs/dev/architecture.md	Architecture deep dive
docs/dev/contributor-protocol.md	Contributing guidelines
docs/ops/configuration.md	Configuration reference
docs/ops/deployment.md	Deployment guides
docs/ops/monitoring.md	Monitoring and observability
docs/ops/upgrade.md	Upgrade procedures
docs/channels/	Channel setup guides (Telegram, Discord, Slack)
docs/architecture/vision.md	Project vision and roadmap

Workspace Layout

electro (binary)
├─ electro-core        — Traits, types, config, errors
├─ electro-agent       — Agentic core, λ-Memory, blueprints
├─ electro-hive        — Swarm intelligence, Many Tems
├─ electro-distill     — Eigen-Tune self-tuning
├─ electro-providers   — Anthropic, OpenAI, Gemini, Grok, OpenRouter
├─ electro-codex-oauth — ChatGPT Plus/Pro via OAuth PKCE
├─ electro-tui         — Interactive terminal UI
├─ electro-channels    — Telegram, Discord, Slack, CLI
├─ electro-memory      — SQLite, Markdown, λ-Memory
├─ electro-vault        — ChaCha20-Poly1305 secrets
├─ electro-tools       — Shell, browser, file ops, web fetch, git
├─ electro-mcp         — MCP client, 14-server registry
├─ electro-gateway     — HTTP server, health, dashboard
└─ electro-observable  — OpenTelemetry tracing

Development

cargo check --workspace                              # Quick compile check
cargo test --workspace                               # Run tests
cargo clippy --workspace --all-targets --all-features -- -D warnings  # Lint
cargo fmt --all                                      # Format
cargo build --release                                # Release binary

Requires Rust 1.82+ and Chrome/Chromium (for the browser tool).

---

MIT License