vecanova-zana

Your AI doesn't remember your notes. Not a bug. Their business model.

ZANA is a sovereign cognitive agent that lives on your machine, remembers everything, and belongs to you — forever.

---

The problem

Every AI session starts from zero. You re-explain your context, your preferences, your goals — every single time. Your "personal AI" remembers nothing between sessions. That's not a limitation. That's the design. They want your data on their servers.

ZANA inverts this with one architectural principle: the memory stays with you.

Quick start

pipx install vecanova-zana
zana init
zana chat

That's it. No Docker. No cloud account. No API key required to start.

What makes ZANA different

4-Store Memory Architecture

ZANA maintains four types of memory simultaneously — all stored locally in ~/.zana/:

Aeon — Your Sovereign Agent

Every ZANA installation generates an Aeon: a computational identity with 35 genes derived from your usage patterns and a nanosecond-seeded entropy signature. No two Aeons are identical — not even if you reinstall.

Your Aeon evolves through 9 stages (Huevo → Fresh → Rookie → Champion → Ultimate → Legend → Archon → Mythic → Sovereign) as it absorbs your knowledge.

Civic Ledger — Verifiable Sovereignty

Every reasoning decision ZANA makes is signed with SHA-256 and written to ~/.zana/civic_ledger.jsonl. Open it. Read it. Verify it. Your agent can't lie to you about what it decided.

cat ~/.zana/civic_ledger.jsonl | python3 -m json.tool | head -40

LLM-Agnostic by Design

Works with Claude, GPT-4, Gemini, Llama, Mistral, and any OpenAI-compatible endpoint. Switch models with one env var — your memory doesn't move.

export ZANA_PRIMARY_MODEL=claude-opus-4-7  # or gpt-4o, gemini-pro, llama3, ...
zana chat

Zero-Docker, Local-First

Runs on your machine as a standard isolated Python package. SQLite for episodic memory. No containers, no cloud sync, no telemetry.

The Coliseo — Where Knowledge Becomes Combat

ZANA includes a battle engine that maps your Obsidian vault into a 6-world arena:

Every note you write in Obsidian shapes the terrain where your Aeon competes. Your knowledge base becomes a living arena.

Z-Skill Protocol

Skills are SKILL.md files that extend ZANA's capabilities. Drop one in ~/.zana/skills/ and ZANA activates it automatically.

zana skill list      # see active skills
zana skill install   # install from registry

Architecture

~/.zana/
├── aeon_dna.json       # Your agent's genetic identity
├── episodic.db         # SQLite episodic memory
├── semantic/           # Vector knowledge store
├── procedural/         # Learned workflows
├── world_model.json    # Your mental map
├── civic_ledger.jsonl  # SHA-256 audit trail
└── skills/             # Active Z-Skills

The core is Python. The security layer (Armor) is Rust — compiled via PyO3, zero overhead.

Configuration

# ~/.zana/.env
ZANA_PRIMARY_MODEL=claude-opus-4-7
ZANA_VAULT_PATH=/home/you/Obsidian/MyVault
ZANA_LANGUAGE=en

Full configuration reference: github.com/Kemquiros/zana-core#configuration

Requirements

• Python 3.12+
• Linux, macOS, or Windows (WSL recommended)
• 512 MB RAM minimum (2 GB recommended for large vaults)

Links

• Landing: zana.vecanova.com
• GitHub: github.com/Kemquiros/zana-core
• Issues: github.com/Kemquiros/zana-core/issues