aion
Autonomous AI agent system with local-first control, plugins and web/CLI interface.
AION is a self-hosted AI agent that writes its own plugins, routes tasks across 6 providers, and works while you sleep โ running 100% on your machine.
No cloud dependency beyond the LLM API. Everything else is local.
Why AION?
๐ง It extends itself.
AION writes, hot-reloads, and creates its own plugins directly from chat. No manual skill files, no code editor. Just ask: "Add a tool that checks Bitcoin prices." The plugin is live immediately.
๐ญ A personality that grows with you.
AION's character evolves automatically โ mood adapts to context, communication style deepens over 300+ exchanges, and every morning it surfaces your unfinished tasks without being asked.
๐ก No API costs for everyday tasks.
Connect your Claude.ai subscription ($20/mo) or Gemini free tier via OAuth. AION routes heavy tasks to powerful models and light tasks to free ones โ automatically.
๐ฑ Controls your desktop.
Screenshot, click, type, hotkeys โ AION sees and controls your screen via pyautogui, without a browser extension or separate daemon.
AION vs. OpenClaw
Both are self-hosted, open-source AI agents with Web UI, MCP, scheduling, and semantic memory. Here's where they differ:
| AION | OpenClaw | |
|---|---|---|
| Writes its own plugins from chat | โ | โ |
| Evolving personality + mood engine | โ | โ |
| Proactive morning briefings | โ | โ |
| Use subscription (no per-token cost) | โ Claude + Gemini OAuth | โ API key required |
| Desktop automation (click, type, screenshot) | โ | โ |
| Web UI | โ | โ |
| Scheduled tasks / cron | โ | โ |
| MCP integrations | โ 1,700+ | โ plugin-based |
| Semantic RAG memory | โ | โ |
| Browser automation | โ Playwright | โ exec-based |
| Messaging: Telegram, Discord, Slack | โ | โ |
| Messaging: WhatsApp, Signal, iMessage | โ | โ |
| Mobile companion app | โ | โ |
| AI providers | 6 (incl. Ollama) | 40+ |
| Runtime | Python | Node.js |
OpenClaw is the better choice if you need WhatsApp/Signal/iMessage or a mobile companion app.
AION is the better choice if you want an agent that evolves, extends itself, and thinks proactively.
โก Quick Start
pip install -r requirements.txt && pip install -e .
aion --setup # guided setup: API keys, plugins, providers
aion # โโ arrow-key selector: Web UI or CLI
aion --web # Web UI โ http://localhost:7000
aion --cli # CLI mode (terminal only)
aion update # git pull + reinstall in one step
Features
| ๐ค 6 AI providers + automatic failover | ๐ Credentials vault (AES-encrypted) |
| ๐ Task routing โ best model per task type | ๐ฑ Messaging: Telegram, Discord, Slack, Alexa |
| ๐งฉ Plugin system โ hot-reload, one Python file | ๐ค Multi-agent delegation |
| ๐ Browser automation (Playwright, 8 tools) | ๐ Audio: TTS + STT, voice in Telegram |
| โฐ Scheduler (cron + interval + natural language) | ๐ 100% local โ no cloud beyond the LLM API |
| ๐ MCP client โ 1,700+ server integrations | ๐ง Semantic RAG memory (vector embeddings) |
Supported Providers
| Provider | Free option | Notes |
|---|---|---|
| Google Gemini | โ Free tier + Google OAuth | Recommended default |
| Anthropic Claude | โ Claude.ai subscription ($20/mo) | Best for coding + reasoning |
| OpenAI | โ | GPT-4.1, o3, o4-mini |
| DeepSeek | โ | Very low cost |
| xAI Grok | โ | grok-3, grok-3-mini |
| Ollama | โ Fully local, offline | Any model, no API key |
Switch model any time: Web UI dropdown, POST /api/model, or just say "Switch to claude-opus-4-6".
Installation
Guided (recommended)
pip install -r requirements.txt && pip install -e .
aion --setup
The setup wizard configures API keys, plugins, and providers. Everything can be changed later in the Web UI.
Docker
docker-compose up
Playwright/Chromium pre-installed. Volumes for .env, config, memory, and plugins.
Docs
| โ Configuration & Troubleshooting | .env, config.json, task routing, file structure, troubleshooting |
| ๐ Plugin Development | Writing plugins, tool registration, available plugins |
| ๐ก REST API Reference | All endpoints, SSE stream events |
| ๐ฌ Messaging & Integrations | Telegram, Discord, Slack, Alexa, Browser, MCP |
Made with Python ยท Powered by your choice of AI
AION is fully transparent โ its codebase, prompts, and memory are always readable and editable.
Reviews (0)
Sign in to leave a review.
Leave a reviewNo results found