Give your AI agent a brain that remembers, learns, and protects itself from repeating mistakes. F1 0.588 on LoCoMo — +55% vs GPT-4. Built on the Atkinson-Shiffrin memory model with 150+ MCP tools.
$ npx nexo-brain init
Three ways to connect NEXO Brain to your AI workflow. Same cognitive engine, different entry points.
Native Model Context Protocol server. Works with Claude Code, Claude Desktop, and any MCP-compatible client out of the box.
UniversalReplaces OpenClaw's default memory with full cognitive architecture. Deep integration with the agent lifecycle and tool registry.
OpenClawOne-click install from the ClawHub marketplace. Browse, install, and start using cognitive memory in seconds.
One-ClickNot just storage — a complete cognitive architecture that learns, forgets naturally, detects conflicts, and prevents repeated mistakes.
Three-store model: Sensory Register captures raw input, STM holds working context with rehearsal, LTM consolidates with semantic vectors. Just like human cognition.
Vector search with fastembed (BAAI/bge-base-en-v1.5). Query across all memory stores with cosine similarity. Retrieve what matters, not just what matches.
Pre-edit checks that inject known errors, real schemas, and blocking rules before your agent writes code. Prevents repeating past mistakes.
Memories naturally fade over time following the Ebbinghaus forgetting curve. Rehearsal strengthens important memories. No manual cleanup needed.
0-100 alignment index that adjusts based on corrections, successes, and proactive actions. Controls internal rigor: low trust = more paranoid checks.
Detects when new instructions contradict existing strong memories. Surfaces the conflict and asks for resolution instead of silently overwriting.
Change logs, decision records with alternatives and reasoning, session diaries with mental state continuity. Full audit trail of what happened and why.
Hot-reload plugins at runtime. Add new tool categories without restarting the server. Ship your own extensions as Python files.
All data stored in local SQLite databases. Vectors computed on-device with ONNX Runtime. Nothing ever leaves your machine. Zero cloud dependencies.
5-question onboarding that creates a unique agent personality. Your agent adopts a consistent voice, tone, and behavioral style from day one.
23 non-negotiable principles every NEXO agent follows. From memory hygiene to error prevention, the codex defines what it means to be a reliable co-operator. See the wiki.
Run NEXO Brain in a container with two commands. Mount your data directory, and the cognitive engine runs isolated and portable across any environment.
Complex questions are automatically split into sub-queries. Each component is retrieved independently, then fused for a higher-quality answer. Improves recall on multi-faceted prompts.
Adaptive chunking strategy that respects sentence and paragraph boundaries. Produces semantically coherent chunks instead of arbitrary token splits, reducing retrieval noise.
After initial vector retrieval, a cross-encoder model rescores candidates for precision. The top-k results are reordered by true semantic relevance before being returned to the agent.
Automatic end-of-session summarization that distills key decisions, errors, and follow-ups into a compact diary entry. The next session starts with full context, not a cold slate.
Combined vector + BM25 keyword search via SQLite FTS5. Best of both worlds: semantic understanding for concept-level retrieval plus exact keyword matching for precise lookups.
Upgraded from 384 to 768 dimensions (BAAI/bge-base-en-v1.5). Doubled semantic precision for richer memory representations — still CPU-only, no GPU required.
Redundancy-aware Ebbinghaus forgetting curve. Unique memories decay 4x slower than duplicates — no information loss in sparse stores, automatic cleanup in dense ones.
Automatic date extraction and temporal query boosting. "When" questions get smarter filtering — memories are ranked not just by relevance but by recency when context demands it.
Transparent 384→768 embedding upgrade on first startup. All existing memories are re-embedded automatically with zero user action required — no data loss, no manual steps.
Signal weights learn from real feedback via Ridge regression. 2-week shadow mode validates new weights before promoting. Weight momentum and automatic rollback keep the system stable.
Pain memory per file and area. Guard warns on HIGH RISK (>0.5) and CRITICAL (>0.8). Validated recovery on clean checks — the system forgets pain when the problem is fixed.
Vibe, corrections, brevity, topic, tool errors, and git diff. Emergency bypass for urgent sessions. Severity-weighted decay keeps personality calibrated over time without manual resets.
Weekly self-improvement cycle. Analyzes patterns, proposes changes, validates via snapshot/rollback. Circuit breakers and budget caps for safety.
nexo chat to launch Claude Code, nexo update to sync the cognitive engine, nexo doctor for unified diagnostics. One binary, full control from any terminal.
First-class managed scripts with lifecycle tracking, schedule associations, and recovery awareness. 9 MCP tools for create, reconcile, sync, classify, and schedule management.
Health checks before every interactive session. Safe migrations, dependency verification, and environment validation ensure the cognitive engine starts clean every time.
Boot and wake catch-up for core and personal jobs. Explicit recovery contracts define what runs after sleep, restart, or missed schedules — no silent failures.
Your scripts become first-class citizens. A real CLI binary controls the cognitive engine. Recovery contracts ensure nothing is lost on sleep or restart.
nexo chat to launch Claude Code with NEXO as operator, nexo update to sync the engine, nexo doctor for unified diagnostics. One binary, full control from any terminal.
Scripts tracked in a first-class SQLite registry with 9 MCP tools for full lifecycle: create, schedule, reconcile, sync, classify. Your automations are now managed entities, not loose files.
Boot and wake catch-up with explicit contracts for core and personal jobs. Every background process declares its recovery behavior — no silent failures after sleep or restart.
Health checks and safe migrations before every interactive session. Dependency verification and environment validation ensure the cognitive engine starts clean.
macOS power assertions, sleep inhibit on Linux, and intelligent scheduling that adapts to battery state. Background processes respect the platform's power constraints.
Evolution can now modify core behavior modules with automatic rollback followups. Fixed false-positive watchdog tamper detection. Safe self-improvement of the cognitive engine.
One command to install. NEXO Brain sets up the MCP server, SQLite databases, and cognitive engine automatically. A 5-question personality calibration creates your agent's unique voice.
Common questions about NEXO Brain, how it works, and how to get started.
nexo command), unified doctor diagnostics, Skills v2 with executable modes, personal scripts registry with 9 lifecycle tools, Claude Code plugin structure, managed evolution, an always-on dashboard with 23 modules, a full nervous system of 14 autonomous processes, and metacognitive error prevention.npx nexo-brain init in your terminal. The installer automatically configures your MCP client (Claude Code or Claude Desktop), downloads the embedding model, and creates the SQLite databases. No API keys or cloud accounts required.nexo_guard_check) is a pre-action safety system. Before your agent edits code or makes changes, it checks for known errors, blocking rules, and relevant learnings. It prevents the agent from repeating mistakes it has already encountered.plugins/ directory are automatically loaded at startup. You can add, remove, or update plugins at runtime without restarting the server. Each plugin can register new MCP tools.npx nexo-brain init and the installer handles everything automatically. For v2.0, your code and data are cleanly separated: code stays in the repo, personal data in NEXO_HOME (~/.nexo/). All 14 autonomous processes are auto-installed, and existing data is preserved. The migration is non-destructive.Open source, AGPL-3.0 licensed, and built for builders who want their AI to actually remember.
Translate this page