Skip to content
Back to search

neural-memory

MarketplaceWorks with Claude CodeGitHubIncomplete

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

Its scripts were only partly scanned.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/nhadaututtheky/neural-memory with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/nhadaututtheky/neural-memory'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/nhadaututtheky--neural-memory/badge.svg)](/listings/nhadaututtheky--neural-memory)

HTML

<a href="/listings/nhadaututtheky--neural-memory"><img src="/api/listings/nhadaututtheky--neural-memory/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

<details> <summary><b>Claude Code (Plugin)</b></summary>

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

</details>

<details> <summary><b>Cursor / Windsurf / Other MCP Clients</b></summary>

pip install neural-memory

Add to your editor's MCP config:

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

</details>

<details> <summary><b>OpenClaw (Skill or Plugin)</b></summary>

**Skill — one click via ClawHub.** Published on every release:

[clawhub.ai/skills/neural-memory](https://clawhub.ai/skills/neural-memory)

**Plugin — memory slot replacement.** Use this if you want NeuralMemory to *be* OpenClaw's memory provider rather than a skill it calls:

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

Set memory slot in `~/.openclaw/openclaw.json`:

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

</details>

<details> <summary><b>Upgrade to Pro</b></summary>

Already using Neural Memory? Just activate your key:

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

Then enable InfinityDB (semantic search engine):

# ~/.neuralmemory/config.toml
storage_backend = "infinitydb"

Restart your MCP server. Existing memories are auto-migrated from SQLite to InfinityDB on first startup.

> [Get a license →](https://neuralmemory.theio.vn/landing/pricing/) · [Pro quickstart →](https://neuralmemory.theio.vn/guides/pro-quickstart/)

</details>

<details> <summary><b>Installation extras</b></summary>

pip install neural-memory[server]              # FastAPI server + dashboard
pip install neural-memory[extract]             # PDF/DOCX/PPTX/HTML/XLSX extraction
pip install neural-memory[nlp-vi]              # Vietnamese NLP
pip install neural-memory[embeddings]          # Local embedding models
pip install neural-memory[embeddings-openai]   # OpenAI embeddings
pip install neural-memory[all]                 # Everything

</details>

<details> <summary><b>Benchmarks vs alternatives</b></summary>

| Metric | NeuralMemory | Mem0 | Cognee | |--------|:---:|:---:|:---:| | **Write 50 memories** | 1.2s | 148.2s (121x slower) | 290.6s (80x slower) | | **Read 20 queries** | 1.8s | 2.9s | 34.6s | | **API calls** | **0** | 70 | 149 |

Zero LLM calls, zero API cost. [Full benchmarks →](docs/benchmarks.md) · [Cognitive Efficiency release evidence →](docs/benchmarks.md#cognitive-efficiency-release-evidence-phase-8)

</details>

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 43 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "neural-memory",
  3. "displayName": "Neural Memory",
  4. "owner": {
  5. "name": "NeuralMemory Contributors",
  6. "email": ""
  7. },
  8. "metadata": {
  9. "description": "Reflex-based memory system for AI agents. Stores experiences as interconnected neurons, recalls through spreading activation — not search.",
  10. "version": "4.63.0"
  11. },
  12. "plugins": [
  13. {
  14. "name": "neural-memory",
  15. "displayName": "Neural Memory",
  16. "source": {
  17. "source": "github",
  18. "repo": "nhadaututtheky/neural-memory"
  19. },
  20. "description": "Reflex-based memory system for AI agents — stores experiences as interconnected neurons and recalls them through spreading activation, mimicking how the human brain works.",
  21. "version": "4.63.0",
  22. "author": {
  23. "name": "NeuralMemory Contributors"
  24. },
  25. "homepage": "https://github.com/nhadaututtheky/neural-memory",
  26. "repository": "https://github.com/nhadaututtheky/neural-memory",
  27. "license": "MIT",
  28. "keywords": [
  29. "memory",
  30. "neural",
  31. "mcp",
  32. "agents",
  33. "ai",
  34. "graph",
  35. "recall",
  36. "llm",
  37. "persistence",
  38. "associative"
  39. ],
  40. "category": "productivity"
  41. }
  42. ]
  43. }
README.md · README · 370 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # NeuralMemory
  2. [![GitHub stars](https://img.shields.io/github/stars/nhadaututtheky/neural-memory?style=social)](https://github.com/nhadaututtheky/neural-memory/stargazers)
  3. [![PyPI](https://img.shields.io/pypi/v/neural-memory.svg)](https://pypi.org/project/neural-memory/)
  4. [![Downloads](https://img.shields.io/pypi/dm/neural-memory)](https://pypi.org/project/neural-memory/)
  5. [![CI](https://github.com/nhadaututtheky/neural-memory/workflows/CI/badge.svg)](https://github.com/nhadaututtheky/neural-memory/actions)
  6. [![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
  7. [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
  8. [![VS Code](https://img.shields.io/visual-studio-marketplace/v/neuralmem.neuralmemory?label=VS%20Code)](https://marketplace.visualstudio.com/items?itemName=neuralmem.neuralmemory)
  9. [![OpenClaw Plugin](https://img.shields.io/npm/v/neuralmemory?label=OpenClaw)](https://www.npmjs.com/package/neuralmemory)
  10. **Your AI agent forgets everything between sessions. Neural Memory gives it a brain.**
  11. <p align="center">
  12. <strong><a href="https://neuralmemory.theio.vn">Website</a></strong> ·
  13. <a href="https://neuralmemory.theio.vn/guides/quickstart-guide/">Quickstart</a> ·
  14. <a href="https://neuralmemory.theio.vn/api/mcp-tools/">MCP Tools</a> ·
  15. <a href="https://neuralmemory.theio.vn/landing/pro-landing.html">Pro</a> ·
  16. <a href="https://neuralmemory.theio.vn/changelog/">Changelog</a>
  17. </p>
  18. <p align="center">
  19. <img src="docs/assets/images/hero-brain.svg" alt="Neural Memory — spreading activation" width="720"/>
  20. </p>
  21. 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.
  22. ```bash
  23. pip install neural-memory
  24. ```
  25. Restart your AI tool. Your agent now remembers — no `init` needed, the MCP server auto-initializes on first use.
  26. **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.
  27. > The CLI is `nmem` (or the longer `neural-memory`). There is no `nm` binary.
  28. ---
  29. ## 3 Tools. That's It.
  30. 63 MCP tools are available, but you only need three:
  31. | Tool | What it does |
  32. |------|-------------|
  33. | `nmem_remember` | Store a memory — auto-detects type, tags, and connections |
  34. | `nmem_recall` | Recall through spreading activation — related memories surface naturally |
  35. | `nmem_health` | Brain health score (A–F) with actionable fix suggestions |
  36. Everything else — sessions, context loading, habit tracking, maintenance — works transparently in the background.
  37. > [All 63 MCP tools →](https://neuralmemory.theio.vn/api/mcp-tools/)
  38. ---
  39. ## What Makes This Different
  40. Most memory tools are search engines. Neural Memory is a **graph that thinks**.
  41. When you ask "Why did Tuesday's outage happen?", a vector database returns the most similar sentence. Neural Memory traces the chain:
  42. ```
  43. outage ← CAUSED_BY ← JWT expiry ← SUGGESTED_BY ← Alice's review
  44. ```
  45. **Relationships are explicit** — `CAUSED_BY`, `LEADS_TO`, `RESOLVED_BY`, `CONTRADICTS` — so your agent doesn't just find memories, it *reasons* through them.
  46. | | Search-based (RAG) | Neural Memory |
  47. |--|---------------------|---------------|
  48. | Retrieval | Similarity score | Graph traversal |
  49. | Relationships | None | 24 explicit types |
  50. | LLM required | Yes (embedding) | No — fully offline |
  51. | Multi-hop reasoning | Multiple queries | One traversal |
  52. | Memory lifecycle | Static | Decay, reinforcement, consolidation |
  53. | Cost per 1K queries | ~$0.02 | **$0.00** |
  54. ---
  55. ## Cloud Sync — Your Data, Your Infrastructure
  56. Sync your brain across every machine. Unlike other memory tools, **we never store your data**.
  57. ```
  58. Laptop ←→ Your Cloudflare Worker ←→ Desktop
  59. ↕
  60. Your Phone
  61. ```
  62. 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.
  63. ```bash
  64. nmem sync # push/pull changes
  65. nmem sync --auto # auto-sync after every remember/recall
  66. ```
  67. Sync uses **Merkle delta** — only diffs travel, not the full brain. Fast, efficient, private.
  68. > [Cloud Sync setup guide →](https://neuralmemory.theio.vn/guides/cloud-sync/)
  69. ---
  70. ## Features
  71. #### Memory & Recall
  72. - **14 memory types** — fact, decision, error, insight, preference, workflow, instruction, and more
  73. - **Spreading activation** — memories surface by association, not keyword match
  74. - **Cognitive reasoning** — hypothesize, submit evidence, make predictions, verify with Bayesian confidence
  75. - **Workload presets** — `nmem config preset {balanced,safe-cost,max-recall,chat-heavy}` tune the brain for SaaS, frugal mode, deep retention, or conversational agents
  76. - **Temporal recall** — `nmem_causal` exposes `temporal_range` and `temporal_neighborhood` actions; see the [Temporal Recall Recipes guide](https://neuralmemory.theio.vn/guides/temporal-recipes/)
  77. #### Knowledge Ingestion
  78. - **Train from documents** — PDF, DOCX, PPTX, HTML, JSON, XLSX, CSV ingested into permanent brain knowledge
  79. - **Import adapters** — migrate from ChromaDB, Mem0, Cognee, Graphiti, LlamaIndex in one command
  80. #### Lifecycle & Storage
  81. - **Memory consolidation** — episodic memories mature into semantic knowledge over time
  82. - **Compression tiers** — full → summary → essence → ghost → metadata (reclaim storage, keep meaning)
  83. - **Brain versioning** — snapshot, rollback, diff, transplant memories between brains
  84. #### Community
  85. - **Brain Store** — browse, import, and publish pre-built brains to the community marketplace
  86. - **3 seed brains** — Python Best Practices, Git Workflows, Docker Essentials (ready to import)
  87. #### Ecosystem
  88. - **Web dashboard** — 7-page React UI with graph visualization, health radar, timeline, mindmap, Brain Store
  89. - **VS Code extension** — memory tree, graph explorer, CodeLens, WebSocket sync ([Marketplace →](https://marketplace.visualstudio.com/items?itemName=neuralmem.neuralmemory))
  90. - **Safety** — Fernet encryption, sensitive content auto-detection, parameterized SQL, path validation
  91. - **Telegram backup** — send brain `.db` files to Telegram for offsite backup
  92. ---
  93. ## Quick Examples
  94. ```bash
  95. # Store memories (type auto-detected)
  96. nmem remember "Fixed auth bug with null check in login.py:42"
  97. nmem remember "We decided to use PostgreSQL" --type decision
  98. nmem todo "Review PR #123" --priority 7
  99. # Recall
  100. nmem recall "auth bug"
  101. nmem recall "database decision" --depth 2
  102. # Brain management
  103. nmem brain list && nmem brain health
  104. nmem brain export -o backup.json
  105. # Sync across devices
  106. nmem sync --full
  107. # Web dashboard
  108. nmem serve # http://localhost:8000/dashboard
  109. ```
  110. ```python
  111. import asyncio
  112. from neural_memory import Brain
  113. from neural_memory.storage import InMemoryStorage
  114. from neural_memory.engine.encoder import MemoryEncoder
  115. from neural_memory.engine.retrieval import ReflexPipeline
  116. async def main():
  117. storage = InMemoryStorage()
  118. brain = Brain.create("my_brain")
  119. await storage.save_brain(brain)
  120. storage.set_brain(brain.id)
  121. encoder = MemoryEncoder(storage, brain.config)
  122. await encoder.encode("Met Alice to discuss API design")
  123. await encoder.encode("Decided to use FastAPI for backend")
  124. pipeline = ReflexPipeline(storage, brain.config)
  125. result = await pipeline.query("What did we decide about backend?")
  126. print(result.context) # "Decided to use FastAPI for backend"
  127. asyncio.run(main())
  128. ```
  129. ---
  130. ## Neural Memory Pro
  131. Free Neural Memory is complete — 63 tools, unlimited memories, fully offline. **You never have to pay.**
  132. 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.
  133. ### Free recalls by keyword. Pro recalls by meaning.
  134. ```
  135. Query: "authentication improvements"
  136. Free (FTS5): 2 results — exact matches only
  137. Pro (HNSW): 7 results — includes "JWT rotation", "session hardening", "OAuth migration"
  138. ```
  139. ### What Pro adds
  140. | | Free (SQLite) | Pro (InfinityDB) |
  141. |--|:---:|:---:|
  142. | **Recall** | Keyword match (FTS5) | Semantic similarity (HNSW) |
  143. | **Speed at 1M neurons** | ~500ms | **<5ms** |
  144. | **Scale tested** | ~50K neurons | 2M+ neurons |
  145. | **Compression** | Text-level trimming | 5-tier vector compression (97% savings) |
  146. | **Consolidation** | O(N²) brute-force | O(N×k) HNSW clustering |
  147. | **Storage per 1M** | ~5 GB | **~1 GB** |
  148. | **Cloud sync** | Manual push/pull | Merkle delta (auto, diffs only) |
  149. ### Pro-exclusive features
  150. - **Cone Queries** — adjustable semantic recall. Narrow the cone for precision, widen for exploration
  151. - **Smart Merge** — consolidation that scales to 1M+ neurons using HNSW neighbor clustering
  152. - **Directional Compression** — compress along multiple semantic axes while preserving meaning
  153. - **5-Tier Auto Lifecycle** — memories flow from float32 → float16 → int8 → binary → metadata. Auto-promote on access
  154. ### Get Pro
  155. ```bash
  156. pip install neural-memory # Pro features included
  157. nmem shared activate --key NM-PRO-XXXX-XXXX-XXXX # activate license
  158. nmem shared status # verify: Pro: Active
  159. ```
  160. **[$9/mo](https://neuralmemory.theio.vn/landing/pricing/)** — 30-day money-back guarantee. All free tools keep working. Downgrade anytime, keep your data.
  161. > [Pro quickstart →](https://neuralmemory.theio.vn/guides/pro-quickstart/) · [Full comparison →](https://neuralmemory.theio.vn/landing/pro/) · [Pricing →](https://neuralmemory.theio.vn/landing/pricing/)
  162. ---
  163. ## Setup by Tool
  164. <details>
  165. <summary><b>Claude Code (Plugin)</b></summary>
  166. ```bash
  167. /plugin marketplace add nhadaututtheky/neural-memory
  168. /plugin install neural-memory@neural-memory-marketplace
  169. ```
  170. </details>
  171. <details>
  172. <summary><b>Cursor / Windsurf / Other MCP Clients</b></summary>
  173. ```bash
  174. pip install neural-memory
  175. ```
  176. Add to your editor's MCP config:
  177. ```json
  178. {
  179. "mcpServers": {
  180. "neural-memory": { "command": "nmem-mcp" }
  181. }
  182. }
  183. ```
  184. </details>
  185. <details>
  186. <summary><b>OpenClaw (Skill or Plugin)</b></summary>
  187. **Skill — one click via ClawHub.** Published on every release:
  188. [clawhub.ai/skills/neural-memory](https://clawhub.ai/skills/neural-memory)
  189. **Plugin — memory slot replacement.** Use this if you want NeuralMemory to *be*
  190. OpenClaw's memory provider rather than a skill it calls:
  191. ```bash
  192. pip install neural-memory && npm install -g neuralmemory
  193. ```
  194. Set memory slot in `~/.openclaw/openclaw.json`:
  195. ```json
  196. { "plugins": { "slots": { "memory": "neuralmemory" } } }
  197. ```
  198. </details>
  199. <details>
  200. <summary><b>Upgrade to Pro</b></summary>
  201. Already using Neural Memory? Just activate your key:
  202. ```bash
  203. nmem shared activate --key NM-PRO-XXXX-XXXX-XXXX # activate license
  204. ```
  205. Then enable InfinityDB (semantic search engine):
  206. ```toml
  207. # ~/.neuralmemory/config.toml
  208. storage_backend = "infinitydb"
  209. ```
  210. Restart your MCP server. Existing memories are auto-migrated from SQLite to InfinityDB on first startup.
  211. > [Get a license →](https://neuralmemory.theio.vn/landing/pricing/) · [Pro quickstart →](https://neuralmemory.theio.vn/guides/pro-quickstart/)
  212. </details>
  213. <details>
  214. <summary><b>Installation extras</b></summary>
  215. ```bash
  216. pip install neural-memory[server] # FastAPI server + dashboard
  217. pip install neural-memory[extract] # PDF/DOCX/PPTX/HTML/XLSX extraction
  218. pip install neural-memory[nlp-vi] # Vietnamese NLP
  219. pip install neural-memory[embeddings] # Local embedding models
  220. pip install neural-memory[embeddings-openai] # OpenAI embeddings
  221. pip install neural-memory[all] # Everything
  222. ```
  223. </details>
  224. <details>
  225. <summary><b>Benchmarks vs alternatives</b></summary>
  226. | Metric | NeuralMemory | Mem0 | Cognee |
  227. |--------|:---:|:---:|:---:|
  228. | **Write 50 memories** | 1.2s | 148.2s (121x slower) | 290.6s (80x slower) |
  229. | **Read 20 queries** | 1.8s | 2.9s | 34.6s |
  230. | **API calls** | **0** | 70 | 149 |
  231. Zero LLM calls, zero API cost. [Full benchmarks →](docs/benchmarks.md) ·
  232. [Cognitive Efficiency release evidence →](docs/benchmarks.md#cognitive-efficiency-release-evidence-phase-8)
  233. </details>
  234. ---
  235. ## Documentation
  236. | Guide | Description |
  237. |-------|-------------|
  238. | [Quickstart Guide](https://neuralmemory.theio.vn/guides/quickstart-guide/) | Interactive guide with animated demos |
  239. | [Pro Quickstart](https://neuralmemory.theio.vn/guides/pro-quickstart/) | Get started with Pro features |
  240. | [CLI Reference](https://neuralmemory.theio.vn/getting-started/cli-reference/) | All 82 CLI commands |
  241. | [MCP Tools Reference](https://neuralmemory.theio.vn/api/mcp-tools/) | All 63 MCP tools with parameters |
  242. | [Cloud Sync](https://neuralmemory.theio.vn/guides/cloud-sync/) | Multi-device sync setup |
  243. | [Brain Health Guide](https://neuralmemory.theio.vn/guides/brain-health/) | Understanding and improving brain health |
  244. | [Embedding Setup](https://neuralmemory.theio.vn/guides/embedding-setup/) | Configure embedding providers |
  245. | [Architecture](https://neuralmemory.theio.vn/architecture/overview/) | Technical design deep-dive |
  246. ## Development
  247. ```bash
  248. git clone https://github.com/nhadaututtheky/neural-memory
  249. cd neural-memory && pip install -e ".[dev]"
  250. nmem doctor --dev # Verify contributor setup
  251. pytest tests/ -v # 7800+ tests
  252. ruff check src/ tests/ # Lint
  253. ```
  254. See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
  255. ## Support
  256. If Neural Memory helps your AI agent remember, please consider giving it a star — it helps others discover the project and keeps development going.
  257. <a href="https://github.com/nhadaututtheky/neural-memory/stargazers">
  258. <img src="https://img.shields.io/github/stars/nhadaututtheky/neural-memory?style=social" alt="Star on GitHub"/>
  259. </a>
  260. You can also [sponsor](https://github.com/sponsors/nhadaututtheky) the project.
  261. ## License
  262. MIT — see [LICENSE](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.