Open-source MVP — local desktop and CLI available

Give Every AI
Your Brain

NAAvOS helps you define an inspectable, user-owned Avatar package and compile approved context for supported AI hosts — from a single avatar.json.

~/naavos

$ pnpm install

$ pnpm exec naavos init

✓ Avatar Source Package created at ~/.naavos/avatar.json

$ pnpm exec naavos compile --target hermes

✓ Compiled → hermes (SOUL.md, SKILL.md, memories/)

$ pnpm exec naavos compile --target claude-code

✓ Compiled → claude-code (CLAUDE.md)

$ pnpm exec naavos compile --target cursor

✓ Compiled → cursor (.cursorrules)

$ pnpm exec naavos install --target hermes

✓ Backup created. Files installed.

Download the desktop beta Personal setup guide

For independent users: run the local desktop Avatar without NAAvOS hosting, Cloudflare, Coolify, VPS access, Node.js, or Ollama. The beta installers are unsigned, so your operating system may show a security warning. Signed installers and hosted-provider integrations are being certified separately.

AI targets supported

MIT

Open source license

Tests passing

Local

First-class privacy

Sound familiar?

WITHOUT NAAvOS

→Every new Claude session: re-explain your rules.
→Context resets. History lost.
→Every agent needs its own config file.
→No way to verify agents actually follow your rules.

WITH NAAvOS

→One avatar.json. Every agent knows you.
→Rules, style, history — always loaded.
→Update once. Compile everywhere.
→Conformance tests prove agents follow your rules.

Core Capabilities

What it does

Inspectable Avatar

A schema for identity, communication, rules, privacy and scope. Sensitive fields remain optional and private by default.

Evidence-Gated Conformance

Local fixtures and hosted MCP checks are tested separately from behavioural fidelity and host acceptance.

Target Adapters

Compile approved context for a named host, with unsupported fields and release limits made visible.

CLI and No-Code Paths

Developers can script the CLI; non-technical users use the guided desktop flow without editing configuration.

Reversible Changes

Preview, backup, reload verification and rollback are part of the product contract—not hidden side effects.

Optional Memory Projections

SQLite + FTS5 remains canonical. ReMe and future providers are explicit, rebuildable projections.

How it works

Three steps. No fluff.

Init

pnpm exec naavos init Creates ~/.naavos/avatar.json

Configure

Edit avatar.json Identity, rules, adapters, privacy

Compile & Install

naavos compile --target hermes naavos install --target hermes

Integration evidence

Compile once for available adapters; host certification is verified separately.

🧠HermesLocal verified

⌨️Claude CodeAdapter available

⌘CursorAdapter available

✨GeminiAdapter available

✦OpenClawAdapter available

📝ReMeOptional projection

Open source.
Use it locally today.

NAAvOS is an MIT-licensed public development release. Independent users can download the local desktop MVP, follow the personal setup guide, and define an Avatar without creating a NAAvOS-hosted account. Hosted connections and named-host certification are verified separately.

macOS

Apple Silicon DMG

Windows

64-bit MSI

Linux

DEB package