Every person in the world can have their own Aeon.
Your memories. Your evolution. Your rules. Running on your hardware.
The current AI paradigm concentrates intelligence in a handful of corporations that accumulate unlimited data about every user, control the models that "think for you," and define what you remember, how you evolve, who you are digitally.
ZANA inverts this with a single architectural principle:
┌─────────────────────────────────────────────────┐
│ YOUR AEON (lives on your hardware) │
│ Memory (4 stores) · Identity · Mastery Map │
│ Civic Ledger · DNA · WisdomRules │
└──────────────────────┬──────────────────────────┘
│ Z-Protocol (open, free)
↓
┌─────────────────────────────────────────────────┐
│ PROCESSING (interchangeable — your choice) │
│ Ollama · Claude · Gemini · GPT-4o · Mistral │
│ Groq · DeepSeek · LLaMA · Gemma · any model │
└─────────────────────────────────────────────────┘
Your Aeon is your digital soul. The model is the compute engine. No one should own your soul.
No Docker required to start. ZANA runs offline on any machine with Python 3.12+. Docker unlocks the full stack (ChromaDB, PostgreSQL, voice). Start without it.
curl -LsSf https://raw.githubusercontent.com/Kemquiros/zana-core/main/scripts/install.sh | shirm https://raw.githubusercontent.com/Kemquiros/zana-core/main/scripts/install.ps1 | iexpip install pipx
pipx install vecanova-zana
zana init # 4 questions, then you're done
zana chat # start talking — no Docker, no accounts, no API key requiredDownload the binary for your platform from GitHub Releases:
zana-linux-x86_64zana-windows-x86_64.exezana-macos-arm64
Then run zana init → zana chat.
zana start # launches Docker services: ChromaDB, PostgreSQL, Neo4j, ARIA UI
zana status # check all services
zana stop # shut everything downGuides: Linux · macOS · Windows · User Manual
An Aeon is not a chatbot. It is a sovereign cognitive entity that:
- Remembers — every conversation, document, and decision you've ever had with it
- Reasons — step by step, symbolically, not just word by word
- Evolves — its skills improve the more you use it, while you sleep
- Protects — your data never leaves your hardware unless you explicitly choose it
- Learns collectively — shares improvements with other Aeons without sharing your data
| What your Aeon does | What it means for you |
|---|---|
| 🧠 Persistent Memory | Every idea, note, and conversation — indexed and searchable in under 50ms |
| ⚙️ Code Agent | Describe what you want. ZANA plans, writes, and tests while you do something else |
| 📊 Business Intelligence | Ask questions across your contracts, KPIs, and reports — connected |
| 🔬 Research | Drop papers or links. ZANA maps connections and surfaces what matters |
| 🛡️ Private by design | No telemetry. No accounts. No data sent anywhere without your permission |
| 🌱 Self-improving | Skills evolve automatically. The Aeon sharpens every day |
| 🎓 Adaptive tutor | Remembers what confused you and adjusts how it explains things |
| 🌐 Model-agnostic | Swap your LLM with one environment variable — the Aeon stays |
Your Aeon grows as you grow. Every interaction advances its understanding of your path.
Seed First interaction — the Aeon awakens
↓
Larva Patterns emerge — basic skills learned
↓
Warrior Tactical autonomy — proactive assistance ← current default
↓
Champion Real proactivity — anticipates before you ask
↓
Legend Mastery — contributes skills to the global Agora
↓
Singularity Full user-Aeon cognitive fusion
The rank reflects genuine accumulated wisdom — not a progress bar.
| Pillar | Module | What it does |
|---|---|---|
| ⚔️ Sentinel | armor/ (Rust) |
Blocks PII and prompt injection at 2.1 µs/request |
| 📚 Archivist | episodic/, rust_core/, world_model/, procedural_memory/ |
Four memory stores: Semantic (ChromaDB), Episodic (PostgreSQL + pgvector), World Model (Neo4j), Procedural Skills (JSON + Q-Learning) |
| 📊 Analyst | reasoning_engine/ (Rust), swarm/ |
Exact Math Logic (EML) — symbolic reasoning that never hallucinates numbers |
| ⚙️ Operator | orchestrator/graph.py, mcp/ |
LangGraph pipeline: Orchestrator → Planner → Executor → Critic → Compressor → Chronicler |
| 📣 Herald | sensory/ (FastAPI), aria-ui/ (Next.js), telegram_bot/ |
Voice, vision, text, WebSocket — multilingual |
Three compiled .so binaries handle performance-critical work:
| Binary | What it does | Latency |
|---|---|---|
zana_steel_core.so |
Kalman filter, Policy Brain (RL), EML operator | 1.4–18 µs |
zana_armor.so |
PII detection + prompt injection guard | 2.1 µs |
zana_audio_dsp.so |
Voice activity detection, Whisper preprocessing | real-time |
All three compile automatically on first zana start. Rust installs itself if missing.
| Service | Port | Role |
|---|---|---|
| Sensory Gateway (FastAPI) | 54446 | Main API entry |
| ARIA UI (PWA) | 54448 | Web interface |
| PostgreSQL + pgvector | 55433 | Episodic memory |
| Redis | 56380 | Session cache |
| Neo4j | 57474 | World model graph |
| Caddy | 80 / 443 | Reverse proxy + TLS |
Open protocols — free to implement, extend, and fork:
| Protocol | Purpose | Status |
|---|---|---|
| Z-Sovereign | Sentinel + Civic Ledger — what your Aeon protects | ✅ Live |
| Z-Identity | DNA + Mastery Map — who your Aeon is | ✅ Live |
| Z-Memory | 4-store memory architecture | ✅ Live |
| Z-Think | Orchestrator + Symbolic Reasoning (EML) | ✅ Live |
| Z-Express | Herald — multimodal, multilingual | ✅ Live |
| Z-Civic | Immutable SHA-256 reasoning audit | ✅ Live |
| Z-Skill | Open skill format (agentskills.io compatible + extensions) | 🔄 v3.0 |
| Z-Sync | Privacy-preserving WisdomRule federation | 🔄 v3.5 |
| Z-DNA | Portable Aeon serialization (.zaeon.enc) |
🔄 v3.5 |
zaeon:// |
Universal Aeon identity URI | 🔄 v3.5 |
ZANA is model-agnostic. Swap your LLM with one environment variable:
| Provider | Activation |
|---|---|
| Anthropic Claude | ANTHROPIC_API_KEY=sk-... |
| OpenAI GPT | OPENAI_API_KEY=sk-... |
| Google Gemini | GOOGLE_API_KEY=AIza... |
| Groq | GROQ_API_KEY=gsk_... |
| Ollama (local, no key) | OLLAMA_BASE_URL=http://localhost:11434 |
| Gemma 4 (recommended local) | ZANA_PRIMARY_MODEL=ollama/gemma4 |
Each cognitive module (Curator, Compressor, Orchestrator) can use a different provider independently.
| Command | What it does |
|---|---|
zana start |
Boot the full ZANA stack |
zana stop |
Shut everything down |
zana status |
Running services and health |
zana setup |
Configure API keys or set up local Ollama |
zana chat |
Terminal conversation |
zana hardware |
Scan hardware and get model recommendations |
zana hardware --recommend |
Best models for your exact machine |
zana upgrade |
Update to the latest version |
zana embed <file> |
Index a document into memory |
zana aeon list |
Available Aeon agents |
zana aeon use <name> |
Switch active Aeon |
ZANA scores itself across 7 cognitive pillars on every boot:
| Mode | Score |
|---|---|
| Cold (no Docker) | 89.8 / 100 |
| Hot (full stack) | 100.0 / 100 |
- Z-Skill v1.0 —
zana skill create/list/run/info. Drop aSKILL.mdin~/.zana/skills/to activate any skill. agentskills.io compatible. - Full offline command coverage —
zana wisdom,zana sentinel,zana memory,zana satelliteall work without Docker or Gateway. SPROUT tier is genuinely self-contained. - WisdomQueue — inbox, approve, reject wisdom proposals locally at
~/.zana/wisdom_queue.json. Atomic writes (no data loss on crash). - SentinelLiteDB — local SQLite ring buffer for all Sentinel events (max 1,000). Prunes oldest automatically.
zana doctor --fix— 3 new auto-fix cases: missing wisdom queue, missing skills registry, corrupted memory DB.- 176 tests — up from 130 in v3.4.0. Every offline path tested in CI.
See the full CHANGELOG for all previous releases.
See docs/ROADMAP.md for the full roadmap.
v3.5.0 "Offline Sovereignty" — Live ✅
Every command works without Docker. SEED + SPROUT tier users get a complete, self-contained Aeon.
Next — v3.6 "Community"
- Z-Sync — privacy-preserving WisdomRule federation between Aeons
- The Agora — open skill marketplace
zaeon://— universal Aeon identity URI- WhatsApp + Discord Herald channels
ZANA: A Neuro-Symbolic Personal Cognitive AI Runtime (PDF)
ZANA is MIT licensed. The Z-Protocol is open.
git clone https://github.com/Kemquiros/zana-core
cd zana-core/cli
pip install -e ".[dev]" # no Docker required for development
pytest cli/tests/ -q # 176 testsWays to contribute:
- Skills — create a
SKILL.mdand open a PR to The Agora - Adapters — new Herald channels (Telegram already done, WhatsApp, Discord, Signal welcome)
- Languages — translate
zana initonboarding wizard - Providers — new model adapters (LiteLLM-compatible)
- Armor — Rust security audits and contributions
- Docs — user guides, tutorials, video walkthroughs
See CONTRIBUTING.md for the full guide. Issues labeled good first issue are the best place to start.
With gratitude to: eglejsr, ferchus_nandus, domination, kamo, virtus_sapiens, oma_fren, xanderx_monkey.
Built with honor in Medellín, Colombia. 🇨🇴 VECANOVA · MIT License
JUNTOS HACEMOS TEMBLAR LOS CIELOS.