Neural Memory

NeuralMemory

[GitHub stars] [PyPI] [Downloads] [CI] [Python 3.11+] [License: MIT] [VS Code] [OpenClaw Plugin]

Your AI agent forgets everything between sessions. Neural Memory gives it a brain.

Website · Quickstart · MCP Tools · Pro · Changelog

[Neural Memory — spreading activation]

Memories are stored as interconnected neurons and recalled through spreading activation — the same way the human brain works. No vector database. No API calls. No monthly embedding bill.

pip install neural-memory

Restart your AI tool. Your agent now remembers — no init needed, the MCP server auto-initializes on first use.

Already installed? nmem update upgrades in place and detects whether you installed via pip or from source. nmem update --check only reports what is available.

The CLI is nmem (or the longer neural-memory). There is no nm binary.

3 Tools. That's It.

63 MCP tools are available, but you only need three:

Everything else — sessions, context loading, habit tracking, maintenance — works transparently in the background.

All 63 MCP tools →

What Makes This Different

Most memory tools are search engines. Neural Memory is a graph that thinks.

When you ask "Why did Tuesday's outage happen?", a vector database returns the most similar sentence. Neural Memory traces the chain:

outage ← CAUSED_BY ← JWT expiry ← SUGGESTED_BY ← Alice's review

Relationships are explicit — CAUSED_BY, LEADS_TO, RESOLVED_BY, CONTRADICTS — so your agent doesn't just find memories, it reasons through them.

Cloud Sync — Your Data, Your Infrastructure

Sync your brain across every machine. Unlike other memory tools, we never store your data.

Laptop ←→ Your Cloudflare Worker ←→ Desktop                  ↕              Your Phone

You deploy the sync hub to your own Cloudflare account (free tier). Your D1 database, your encryption key, your data. We provide the code — you own the infrastructure.

nmem sync              # push/pull changesnmem sync --auto       # auto-sync after every remember/recall

Sync uses Merkle delta — only diffs travel, not the full brain. Fast, efficient, private.

Cloud Sync setup guide →

Features

Memory & Recall

• 14 memory types — fact, decision, error, insight, preference, workflow, instruction, and more
• Spreading activation — memories surface by association, not keyword match
• Cognitive reasoning — hypothesize, submit evidence, make predictions, verify with Bayesian confidence
• Workload presets — nmem config preset {balanced,safe-cost,max-recall,chat-heavy} tune the brain for SaaS, frugal mode, deep retention, or conversational agents
• Temporal recall — nmem_causal exposes temporal_range and temporal_neighborhood actions; see the Temporal Recall Recipes guide

Knowledge Ingestion

• Train from documents — PDF, DOCX, PPTX, HTML, JSON, XLSX, CSV ingested into permanent brain knowledge
• Import adapters — migrate from ChromaDB, Mem0, Cognee, Graphiti, LlamaIndex in one command

Lifecycle & Storage

• Memory consolidation — episodic memories mature into semantic knowledge over time
• Compression tiers — full → summary → essence → ghost → metadata (reclaim storage, keep meaning)
• Brain versioning — snapshot, rollback, diff, transplant memories between brains

Community

• Brain Store — browse, import, and publish pre-built brains to the community marketplace
• 3 seed brains — Python Best Practices, Git Workflows, Docker Essentials (ready to import)

Ecosystem

• Web dashboard — 7-page React UI with graph visualization, health radar, timeline, mindmap, Brain Store
• VS Code extension — memory tree, graph explorer, CodeLens, WebSocket sync (Marketplace →)
• Safety — Fernet encryption, sensitive content auto-detection, parameterized SQL, path validation
• Telegram backup — send brain .db files to Telegram for offsite backup

Quick Examples

# Store memories (type auto-detected)nmem remember "Fixed auth bug with null check in login.py:42"nmem remember "We decided to use PostgreSQL" --type decisionnmem todo "Review PR #123" --priority 7
# Recallnmem recall "auth bug"nmem recall "database decision" --depth 2
# Brain managementnmem brain list && nmem brain healthnmem brain export -o backup.json
# Sync across devicesnmem sync --full
# Web dashboardnmem serve    # http://localhost:8000/dashboard

import asynciofrom neural_memory import Brainfrom neural_memory.storage import InMemoryStoragefrom neural_memory.engine.encoder import MemoryEncoderfrom neural_memory.engine.retrieval import ReflexPipeline
async def main():    storage = InMemoryStorage()    brain = Brain.create("my_brain")    await storage.save_brain(brain)    storage.set_brain(brain.id)
    encoder = MemoryEncoder(storage, brain.config)    await encoder.encode("Met Alice to discuss API design")    await encoder.encode("Decided to use FastAPI for backend")
    pipeline = ReflexPipeline(storage, brain.config)    result = await pipeline.query("What did we decide about backend?")    print(result.context)  # "Decided to use FastAPI for backend"
asyncio.run(main())

Neural Memory Pro

Free Neural Memory is complete — 63 tools, unlimited memories, fully offline. You never have to pay.

But past 10K memories, things change. Keyword matching misses semantically related content. Consolidation slows to minutes. Storage grows unbounded. If your agent's brain is getting big, Pro makes it smart.

Free recalls by keyword. Pro recalls by meaning.

Query: "authentication improvements"
Free (FTS5):  2 results — exact matches onlyPro  (HNSW):  7 results — includes "JWT rotation", "session hardening", "OAuth migration"

What Pro adds

Pro-exclusive features

• Cone Queries — adjustable semantic recall. Narrow the cone for precision, widen for exploration
• Smart Merge — consolidation that scales to 1M+ neurons using HNSW neighbor clustering
• Directional Compression — compress along multiple semantic axes while preserving meaning
• 5-Tier Auto Lifecycle — memories flow from float32 → float16 → int8 → binary → metadata. Auto-promote on access

Get Pro

pip install neural-memory                 # Pro features includednmem shared activate --key NM-PRO-XXXX-XXXX-XXXX   # activate licensenmem shared status                                 # verify: Pro: Active

$9/mo — 30-day money-back guarantee. All free tools keep working. Downgrade anytime, keep your data.

Pro quickstart → · Full comparison → · Pricing →

Setup by Tool

/plugin marketplace add nhadaututtheky/neural-memory/plugin install neural-memory@neural-memory-marketplace

pip install neural-memory

{  "mcpServers": {    "neural-memory": { "command": "nmem-mcp" }  }}

pip install neural-memory && npm install -g neuralmemory

{ "plugins": { "slots": { "memory": "neuralmemory" } } }

nmem shared activate --key NM-PRO-XXXX-XXXX-XXXX   # activate license

# ~/.neuralmemory/config.tomlstorage_backend = "infinitydb"

pip install neural-memory[server]              # FastAPI server + dashboardpip install neural-memory[extract]             # PDF/DOCX/PPTX/HTML/XLSX extractionpip install neural-memory[nlp-vi]              # Vietnamese NLPpip install neural-memory[embeddings]          # Local embedding modelspip install neural-memory[embeddings-openai]   # OpenAI embeddingspip install neural-memory[all]                 # Everything

Documentation

Development

git clone https://github.com/nhadaututtheky/neural-memorycd neural-memory && pip install -e ".[dev]"nmem doctor --dev        # Verify contributor setuppytest tests/ -v          # 7800+ testsruff check src/ tests/    # Lint

See CONTRIBUTING.md for guidelines.

Support

If Neural Memory helps your AI agent remember, please consider giving it a star — it helps others discover the project and keeps development going.

You can also sponsor the project.

License

MIT — see LICENSE.