nexo-brain 0.3.6 → 0.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (7) hide show
  1. package/README.md +35 -3
  2. package/package.json +2 -2
  3. package/src/cognitive.py +482 -17
  4. package/src/migrate_embeddings.py +119 -0
  5. package/src/plugins/episodic_memory.py +47 -47
  6. package/src/scripts/nexo-postmortem-consolidator.py +21 -21
  7. package/src/scripts/nexo-synthesis.py +53 -53
package/README.md CHANGED
@@ -1,5 +1,9 @@
1
1
  # NEXO Brain — Your AI Gets a Brain
2
2
 
3
+ [![GitHub stars](https://img.shields.io/github/stars/wazionapps/nexo?style=social)](https://github.com/wazionapps/nexo/stargazers)
4
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
5
+ [![GitHub Sponsors](https://img.shields.io/badge/Sponsor-%E2%9D%A4-pink)](https://github.com/sponsors/wazionapps)
6
+
3
7
  **NEXO Brain transforms any MCP-compatible AI agent from a stateless assistant into a cognitive partner that remembers, learns, forgets, adapts, and builds a relationship with you over time.**
4
8
 
5
9
  [Watch the overview on YouTube](https://www.youtube.com/watch?v=-uvhicUhGTY)
@@ -158,6 +162,27 @@ NEXO Brain v0.3.1 adds 21 cognitive tools on top of the 76 base tools, bringing
158
162
  | **Prospective Memory** | Context-triggered reminders that fire when conversation topics match, not just by date. "Remind me about X when we discuss Y" works naturally. |
159
163
  | **Hook Auto-capture** | Extracts decisions, corrections, and factual statements from conversations automatically. You don't need to explicitly say "remember this" — the system detects what's worth storing. |
160
164
 
165
+ ## Benchmark: LoCoMo (ACL 2024)
166
+
167
+ NEXO Brain was evaluated on [LoCoMo](https://github.com/snap-research/locomo) (ACL 2024), a long-term conversation memory benchmark with 1,986 questions across 10 multi-session conversations.
168
+
169
+ | System | F1 | Adversarial | Hardware |
170
+ |---|---|---|---|
171
+ | GPT-4 (128K full context) | 0.379 | — | GPU cloud |
172
+ | Gemini Pro 1.0 | 0.313 | — | GPU cloud |
173
+ | **NEXO Brain** | **0.297** | **89.2%** | **CPU only** |
174
+ | LLaMA-3 70B | 0.295 | — | A100 GPU |
175
+ | GPT-3.5 + Contriever RAG | 0.283 | — | GPU |
176
+
177
+ **Key findings:**
178
+ - Matches 70B-parameter models running entirely on CPU with 384-dim embeddings
179
+ - 89.2% adversarial rejection rate — reliably says "I don't know" when information isn't available
180
+ - 25s ingestion for 10 full conversations (no GPU, no batching)
181
+ - 58.9% temporal recall on "when did X happen?" questions
182
+ - First MCP memory server benchmarked on a peer-reviewed dataset
183
+
184
+ Full results in [`benchmarks/locomo/results/`](benchmarks/locomo/results/).
185
+
161
186
  ## Quick Start
162
187
 
163
188
  ### Claude Code (Primary)
@@ -386,9 +411,16 @@ NEXO Brain builds on ideas from several open-source projects. We're grateful for
386
411
  | [claude-mem](https://github.com/nicobailey/claude-mem) | Hook auto-capture (extracting decisions and facts from conversations) |
387
412
  | [ClawMem](https://github.com/nicobailey/ClawMem) | Co-activation reinforcement (memories retrieved together strengthen connections) |
388
413
 
389
- ## Contributing
414
+ ## Support the Project
415
+
416
+ If NEXO Brain is useful to you, consider:
417
+
418
+ - **Star this repo** — it helps others discover the project and motivates continued development
419
+ - **[Sponsor on GitHub](https://github.com/sponsors/wazionapps)** — support ongoing development directly
420
+ - **Share your experience** — tell others how you're using cognitive memory in your AI workflows
421
+ - **Contribute** — see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines. Issues and PRs welcome
390
422
 
391
- See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines. Issues and PRs welcome.
423
+ [![Star History Chart](https://api.star-history.com/svg?repos=wazionapps/nexo&type=Date)](https://star-history.com/#wazionapps/nexo&Date)
392
424
 
393
425
  ## License
394
426
 
@@ -396,4 +428,4 @@ MIT -- see [LICENSE](LICENSE)
396
428
 
397
429
  ---
398
430
 
399
- Built by [WAzion](https://www.wazion.com)
431
+ Created by **Francisco Cerdà Puigserver** & **NEXO** (Claude Opus) · Built by [WAzion](https://www.wazion.com)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "nexo-brain",
3
- "version": "0.3.6",
3
+ "version": "0.5.0",
4
4
  "mcpName": "io.github.wazionapps/nexo",
5
5
  "description": "NEXO — Cognitive co-operator for Claude Code. Atkinson-Shiffrin memory, semantic RAG, trust scoring, and metacognitive error prevention.",
6
6
  "bin": {
@@ -17,7 +17,7 @@
17
17
  "openclaw",
18
18
  "openclaw-plugin"
19
19
  ],
20
- "author": "WAzion Apps <hello@wazion.com>",
20
+ "author": "NEXO Brain <info@nexo-brain.com>",
21
21
  "license": "MIT",
22
22
  "repository": {
23
23
  "type": "git",