aion

agent
SUMMARY

Autonomous AI agent system with local-first control, plugins and web/CLI interface.

README.md
AION

Autonomous Intelligent Operations Node

Python 3.10+
FastAPI
License: MIT
Platforms


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.

Yorumlar (0)

Sonuc bulunamadi