Skip to main content
Glama

AON

πŸ›°οΈ AON : Self-Contained Obliterated AI

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

Website Live YouTube demo PyPI MCP server Android APK

License: MIT Python

⚑ Quick start Β· πŸ’‘ Why AON Β· πŸ”Œ MCP server Β· πŸ“± Android Β· πŸ”‘ Live instance Β· 🎬 Demo

πŸ’¬ Chat

πŸ—ΊοΈ Maps

AON chat UI

AON route on the 3D globe map

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.

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 needOllama 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).

Related MCP server: SafeFlo

πŸ’‘ 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.

πŸ›°οΈ AON

☁️ Typical cloud AI chat

Runs on your own hardware

βœ…

❌

Your chats and files stay with you

βœ…

❌

Provider content filtering

❌ none

βœ…

Cost

your GPU's power

subscription or per token

Long-term memory + your documents (RAG)

βœ…

βœ…

Runs commands on your server (with your approval)

βœ…

❌

Installs new models, MCP servers and skills from a link

βœ…

❌

Usable from Claude Desktop / Cursor as a tool (MCP)

βœ…

❌

One GPU serves your whole team

βœ…

❌

πŸ”Œ MCP server

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

Claude Desktop Claude Code Cursor stdio

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.

Tool

What it does

Access

ask_aon

Hand AON a task or question; it answers with its own model, memory, documents and tools. Pass chat to continue a conversation.

✍️ write

search_memory

Search AON's long-term memory about you

πŸ‘€ read

remember

Save a fact to AON's memory

✍️ write

search_documents

Search your document library by meaning and exact words

πŸ‘€ read

list_documents

List the library

πŸ‘€ read

add_document

Add a text document to the library

✍️ write

NOTE

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

  • 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 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

Watch the AON demo on YouTube

▢️ Click to watch on YouTube

✨ Features

πŸ› οΈ Agent with tools

Read, write and edit files, run shell commands, search and fetch the web, show maps. Commands and file writes ask for approval.

🧠 Long memory

Facts about you, searched by meaning and merged when they change; recall of older turns from this and other chats by meaning and exact strings; a rolling summary plus a numbered outline of everything you asked.

πŸ“š Document library (RAG)

Text, code, Markdown, HTML, Word and PDF, from the Documents panel or chat attachments. Hybrid search (SQLite FTS5 + vectors); answers cite the document.

πŸ“ Context budget

Every request is fitted to the model's window using the server's exact token count, so long chats never overflow.

🧩 Skills

Agent Skills (SKILL.md): import from a zip, GitHub URL or pasted text; draft one from a web page; run evals.

πŸ”Œ MCP, both ways

Connects to stdio and HTTP MCP servers (browse the Glama directory in the Hub) and is an MCP server itself.

πŸ“Ž Attachments

Files and photos in chat; images go to vision models.

πŸ—ΊοΈ Maps

Places and routes from OpenStreetMap (Nominatim, OSRM) on a MapLibre 3D globe.

πŸ‘₯ Multi-user

Chat on vLLM to serve several users at once; Cloudflare Access for sign-in.

πŸ“± Everywhere

Web UI, Android app and an optional Telegram bot.

πŸ—οΈ 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

Python FastAPI Uvicorn httpx WebSockets MCP pypdf SQLite vLLM Ollama nomic-embed-text MapLibre Cloudflare pytest

πŸ“± Android app

Download AON.apk

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 that is emailed to you. The PIN sign-in is handled by Cloudflare Access.

WARNING

Access can be withdrawn at any time. The instance runs on private hardware with limited capacity: please do not use it for anything illegal, for automated or bulk traffic, or to process other people's personal data, and expect a short wait when several people are using it.

πŸ“¦ Installation

Requirements

  • Linux (runs on Ubuntu), Python 3.11 or newer.

  • Ollama with an embedding model (ollama pull nomic-embed-text) and a chat model with tool support (for example ollama pull qwen3:14b), unless chat runs on vLLM.

  • Optional: a GPU server running vLLM (vllm/).

  • Optional: Node.js 20 for npx-based MCP servers.

Install

pipx install aon-agent            # or: pip install aon-agent
aon init                          # --ollama URL --model NAME --bind HOST:PORT --home DIR

Everything AON keeps (config, chats, memory, documents, skills) lives in its home folder: --home DIR, else $AON_HOME, else ~/.aon.

git clone https://github.com/leo007-htun/AON.git && cd AON
python3 -m venv venv && venv/bin/pip install -e ".[test]"
venv/bin/aon init

βš™οΈ Configuration

aon init writes config.toml into the home folder; edit it to taste. Keep context_window equal to vLLM's --max-model-len (or the Ollama model's context).

Key

Meaning

Example

ollama_base_url

Ollama's OpenAI-compatible endpoint (embeddings, and chat unless chat_base_url is set)

"http://localhost:11434/v1"

default_model

Model used when the UI does not pick one

"qwen3:14b"

workdir

The agent's workspace; chats and documents are stored here

"~/.aon/workspace"

bind

Address and port of the web UI. AON has no login: keep it on 127.0.0.1 unless every device that can reach it is trusted

"127.0.0.1:8700"

max_steps

Tool calls allowed per request

40

command_timeout

Seconds before a shell command is stopped

120

always_ask

Extra tools that always need approval

[]

embed_model

Embedding model on Ollama

"nomic-embed-text"

context_window

The chat model's context length, in tokens

16384

reply_reserve

Tokens kept free for thinking and the answer

6144

history_tokens

Recent chat turns sent word for word

5000

cross_chat_recall

Also recall relevant turns from your other chats

true

chat_base_url

Optional separate chat backend (vLLM)

"http://gpu-box:8001/v1"

chat_model

The model name served there; only this model goes to chat_base_url

"aon"

chat_temperature, chat_top_p, chat_repetition_penalty

Sampling for the chat backend

0.2, unset, 1.15

chat_vision

The chat backend model accepts images

true

telegram_bot_token, telegram_allowed_chat_ids

Optional Telegram bot

"", []

πŸš€ Running

aon serve                         # web UI on the bind address from config.toml
aon serve --port 9000             # or override host/port
aon --help
setsid nohup aon serve >> ~/.aon/aon.log 2>&1 < /dev/null &
pgrep -af '[a]on serve'           # is it running?
tail -f ~/.aon/aon.log            # its log
pkill -f '[a]on serve'            # stop it
sudo tee /etc/systemd/system/aon.service >/dev/null <<'EOF'
[Unit]
Description=AON agent
After=network-online.target
Wants=network-online.target

[Service]
User=ubuntu
Environment=AON_HOME=/home/ubuntu/.aon
ExecStart=/home/ubuntu/.local/bin/aon serve
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target
EOF
sudo systemctl daemon-reload && sudo systemctl enable --now aon
journalctl -u aon -f

Change User, AON_HOME and the aon path (which aon) to match your setup.

⚑ Multi-user with vLLM

Ollama answers one request at a time for some models. To serve several users, run the chat model on vLLM and point AON at it:

chat_base_url = "http://<gpu-box>:8001/v1"
chat_model = "aon"
default_model = "aon"
context_window = 16384

vllm/ has the systemd unit, the chat template and the exact package versions used. Measured on one RTX 4090 (24 GB) with a 27B 4-bit model: 16K context serves 2–3 full-length requests at once and the rest queue; 8K serves 4.

🌐 Remote access

AON has no login of its own. Keep bind on your LAN and, to reach it from outside, put it behind an authenticating proxy, for example a Cloudflare Tunnel with Cloudflare Access (email PIN). Geolocation in the map needs HTTPS.

πŸ§ͺ Development

pip install -e ".[test]"
pytest -q

Path

What it is

src/aon/cli.py

The aon command: init, serve, mcp

src/aon/main.py

Builds AON from config.toml (shared by serve and mcp)

src/aon/mcp_server.py

AON as an MCP server

src/aon/web.py

FastAPI app: REST API and the chat WebSocket

src/aon/engine.py

The agent loop (tool calls, approval, loop guard)

src/aon/router.py

Planner: answer directly, ask, or plan tool steps

src/aon/llm_client.py, backends.py

Model calls; Ollama or vLLM per model

src/aon/context.py

Fitting requests into the context window

src/aon/recall.py, summary.py

Chat recall, rolling summary, outline

src/aon/memory*.py

Episodic memory, extraction, consolidation

src/aon/docs.py

Document library (RAG)

src/aon/skills.py, skill_*.py

Skills: store, import, authoring, evals

src/aon/mcp_client.py, mcp_tools.py, hub.py

MCP servers and the Glama hub

src/aon/tools/

Built-in tools (files, shell, web, map)

src/aon/static/

Web UI (index.html), icons, fonts, map library

src/aon/default_skills/

Skills copied into a new home by aon init

tests/

Test suite

specs/

Design notes

vllm/

vLLM server setup

πŸ’Ύ Data

AON keeps its data in its home folder: workspace/app.db (chats), workspace/docs.db (document library), memory/episodes.db (memory) and workspace/uploads/ (attachments). This repository includes a snapshot of them from 2026-10-14. A fresh install creates empty ones; to start clean, delete them before the first run. The Glama API key is kept in .glama_key, which is git-ignored.

🀝 Contributing

Issues and pull requests are welcome. For anything bigger than a fix, please open an issue first to talk it through. Run pytest -q before sending a pull request.

πŸ“„ License

AON is released under the MIT License. Β© 2026 Sithu Htun (@leo007-htun).

Bundled third-party files keep their own licenses, included next to them: CybercoreCSS (MIT), MapLibre GL JS (BSD-3-Clause), highlight.js (BSD-3-Clause), and the Exo 2, JetBrains Mono, Orbitron and Rajdhani fonts (SIL Open Font License).


If AON is useful to you, give it a ⭐. It helps others find it.

⬆ Back to top

Maintenance

ActivityMaintained
ResponsivenessUnresponsive

Related MCP Connectors

Related MCP Servers

  • A
    license
    B
    quality
    C
    maintenance
    A local-first MCP server that provides AI agents with safe codebase access through file discovery, hybrid lexical-semantic search, and project introspection. It features durable local memory and semantic indexing while keeping all data and processing entirely on your local machine.
    74
    25 npm
    6
    MIT
  • A
    license
    A
    quality
    C
    maintenance
    A local shared-memory MCP server for Claude, Codex, Hermes, and other MCP-aware agents, providing a durable memory layer with Markdown files and SQLite fact store.
    6
    MIT