AON

🛰️ AON : Self-Contained Obliterated AI

Your own uncensored AI agent. One GPU. Zero cloud. Zero filters.

[⚡ Quick start](#-quick-start) · [💡 Why AON](#-why-aon) · [🔌 MCP server](#-mcp-server) · [📱 Android](#-android-app) · [🔑 Live instance](#-try-the-live-instance) · [🎬 Demo](#-demo)

AON is a self-hosted AI agent that runs on your own hardware with local models. It answers questions, runs tools (files, shell, web search, maps), remembers you across chats, reads your documents, and extends itself with new models, skills and MCP servers. Use it from the web, the Android app, Telegram, or from Claude Desktop, Claude Code and Cursor through its [MCP server](#-mcp-server).

[!IMPORTANT]

🔒 Nothing leaves your box. Chat runs on vLLM or

Ollama on your own GPU, embeddings on Ollama. No cloud LLM, no API bills,

no provider filtering or logging.

---

⚡ Quick start

pipx install aon-agent        # 1. install

aon init # 2. create ~/.aon with a starter config aon serve # 3. open http://127.0.0.1:8700

[!TIP]

You need Ollama with nomic-embed-text and a chat model that supports

tools: ollama pull nomic-embed-text && ollama pull qwen3:14b. Then try aon mcp to plug AON

into Claude Desktop (how).

💡 Why AON

Memory and RAG are table stakes now. What AON adds:

• 🔓 Obliterated and fully yours. An uncensored ("obliterated") 27B model on a single consumer GPU (RTX 4090). Your chats, memory and documents never leave the box.
• 🧬 It extends itself. Paste a link and AON works out what it is: a GGUF model it can pull (it checks the VRAM budget and tool support first), an MCP server it can connect, a skill repo it can import, or docs it can learn from. It can draft a new skill from any web page and test it.
• 🔌 Plugs into the AI apps you already use. aon mcp turns AON into an MCP server for Claude Desktop, Claude Code and Cursor, so they can hand it tasks and search its memory and your documents.
• 👥 A private AI for your whole crew, from one GPU. vLLM serves several people at once, behind Cloudflare Access email PIN, with every user approved by hand.
• 🛡️ Honest by design. Shell commands and file writes wait for your approval. A reply that claims "done" without a tool having run is not trusted. Secrets are never saved to memory.
• 🗺️ Grounded, not guessed. Places and routes come from OpenStreetMap routing on a 3D globe; distances and times are computed, not written by the model.

🔌 MCP server

Use AON inside Claude Desktop, Claude Code, Cursor and any other MCP client.

aon mcp runs AON as a Model Context Protocol server. It ships in the aon-agent package (source); your MCP client starts it for you.

[!NOTE]

Shell commands and file writes are always refused over MCP: there is nobody to approve them

inside another app.

Claude Desktop and Cursor

• Claude Desktop: Settings → Developer → Edit Config (claude_desktop_config.json), then restart it.
• Cursor: ~/.cursor/mcp.json, or .cursor/mcp.json in a project.

{

"mcpServers": { "aon": { "command": "aon", "args": ["mcp"] } } }

Claude Code

Claude Code:

claude mcp add aon -- aon mcp

Add "--home", "/path/to/home" to args for a different home folder. If the client can't find aon, use the full path from which aon.

🎬 Demo

▶️ *Click to watch on YouTube*

✨ Features

🏗️ Architecture

flowchart TB

subgraph clients["Clients"] direction LR W["🌐 Web UI"] ~~~ A["📱 Android"] ~~~ T["💬 Telegram"] ~~~ M["🤖 Claude / Cursor"] end S["🛰️ AON server · FastAPI + agent loop"] subgraph backends["Behind AON"] direction LR TL["🛠️ Tools"] ~~~ DB[("🧠 Memory + docs")] ~~~ V["⚡ vLLM"] ~~~ O["🦙 Ollama"] ~~~ X["🔌 MCP servers"] end clients -- "HTTPS via Cloudflare Access, or MCP over stdio" --> S S --> backends

Built with

📱 Android app

260 KB, Android 7.0 or newer.

1. Open the link on your phone and download the APK.
2. Allow installs from your browser when Android asks (Install unknown apps), then tap Install.
3. Open AON and sign in with your approved email address (see Try the live instance).

The app opens https://aon.vulkron.uk by default. To use your own server, press Back in the app and choose Change server, for example http://192.168.1.50:8700 on your home network. The APK is signed (APK Signature Scheme v2, certificate CN=AON, O=Vulkron, C=GB); its SHA-256 is on the release page.

🔑 Try the live instance

Access to https://aon.vulkron.uk is by approval only:

1. 📝 Request access. Open an issue titled *Access request*, saying who you are and what you would like to use AON for. Please do not post your email address in the issue; the maintainer will reply and tell you how to send it.
2. ⏳ Wait for approval. Requests are reviewed by hand. Once yours is approved, your email address is added to the allowed list and the issue is closed with a note.
3. ✅ Sign in. Open https://aon.vulkron.uk, enter the approved email address, and type the one-time PIN th