# kuzu-memory

> Lightweight, embedded graph-based memory system for AI applications. Fast (<3ms recall), offline-first, with MCP server support for Claude and other AI tools.

- **URL**: https://www.freshcrate.ai/projects/kuzu-memory
- **Author**: bobmatnyc
- **Category**: MCP Servers
- **Latest version**: `v1.12.11` (2026-05-21)
- **License**: Unknown
- **Source**: https://github.com/bobmatnyc/kuzu-memory
- **Homepage**: https://pypi.org/project/kuzu-memory/
- **Language**: Python
- **GitHub**: 23 stars, 3 forks
- **Registry**: github
- **Tags**: `python`

## Description

Lightweight, embedded graph-based memory system for AI applications. Fast (<3ms recall), offline-first, with MCP server support for Claude and other AI tools.

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `v1.12.11` | 2026-05-21 | High | **Full Changelog**: https://github.com/bobmatnyc/kuzu-memory/compare/v1.12.10...v1.12.11 |
| `v1.12.9` | 2026-04-09 | High | ## Bug Fix  ### Fixed - **Remove `valid_to` expiry filter from `_recall_all_memories`** (closes #51) — EPISODIC memories default to `valid_to = created_at + 30 days`. Historical benchmark sessions are all "expired" by wall-clock, so the `WHERE valid_to > now` guard returned 0 rows, silently blocking the full-corpus cosine scan since #49. Expiry is an operational retention policy, not a search-relevance filter.  **Full Changelog**: https://github.com/bobmatnyc/kuzu-memory/compare/v1.12.8...v1.12. |
| `v1.12.8` | 2026-04-09 | Medium | ## Bug Fix  ### Fixed - **Full-corpus fallback now fires when HNSW returns `[]`** (closes #50) — `_recall_with_hnsw()` returns `[]` (not `None`) when the query succeeds but finds zero neighbours. The condition `hnsw_memories is None` was False for `[]`, silently blocking the full-corpus cosine scan introduced in #49. This is why v1.12.7 SSA R@10 remained 62.5% unchanged. Fix: changed to `not hnsw_memories`.  **Full Changelog**: https://github.com/bobmatnyc/kuzu-memory/compare/v1.12.7...v1.12.8 |
| `v1.12.7` | 2026-04-08 | High | ## Bug Fix  ### Fixed - **Full-corpus cosine scan when HNSW unavailable** (closes #49) — when `use_semantic_search=True` and HNSW index is absent, keyword pre-filter in graph strategies excluded sessions whose answer vocabulary only appears in assistant turns (not indexed). Fix: replace filtered candidates with a full no-filter corpus scan so cosine similarity ranks all sessions. Expected SSA R@10: 62.5% -> 88-91%.  **Full Changelog**: https://github.com/bobmatnyc/kuzu-memory/compare/v1.12.6...v |
| `v1.12.6` | 2026-04-08 | Medium | ## Bug Fix  ### Fixed - **Entity match weight reduced 0.10 -> 0.03** (closes #48) — a single common-entity hit on a wrong session could override a Jaccard-leading correct session in fresh/small DBs where all memories share identical importance/confidence defaults. At 0.03 a wrong session needs 3+ entity matches to flip a typical Jaccard advantage. Expected SSA R@10 improvement: 62.5% -> ~80-84%.  **Full Changelog**: https://github.com/bobmatnyc/kuzu-memory/compare/v1.12.5...v1.12.6 |
| `v1.12.5` | 2026-04-08 | Medium | ## Bug Fix  ### Fixed - **Speaker intent filter zero-result guard** (closes #47) — when all memories use the default `source_speaker="user"` and the classifier fires `ASSISTANT_TURN`, the filter no longer wipes 100% of candidates. Falls back to the full ranked list until callers opt in to tagging assistant turns. Recovers 15 LongMemEval single-session-assistant regressions introduced in v1.12.4.  **Full Changelog**: https://github.com/bobmatnyc/kuzu-memory/compare/v1.12.4...v1.12.5 |
| `v1.12.4` | 2026-04-08 | Medium | ## What's Changed  ### Added - `relevance_score` and `ranking_explanation` runtime-only fields on Memory model (excluded from serialization, used by recall coordinator for scoring transparency) - Pre-migration JSON backup in KuzuAdapter — exports all Memory nodes to a timestamped backup file before executing any ALTER TABLE schema migrations - `memory_exporter` utility module for JSON export of Memory nodes - `kuzu-memory memory export` CLI command with `--output`, `--format`, and `--include-arc |
| `v1.8.2` | 2026-03-19 | Low | **Full Changelog**: https://github.com/bobmatnyc/kuzu-memory/compare/v1.8.1...v1.8.2 |
| `v1.8.1` | 2026-03-14 | Low | **Full Changelog**: https://github.com/bobmatnyc/kuzu-memory/compare/v1.8.0...v1.8.1 |
| `v1.8.0` | 2026-03-13 | Low | **Full Changelog**: https://github.com/bobmatnyc/kuzu-memory/compare/v1.7.0...v1.8.0 |

## Citation

- HTML: https://www.freshcrate.ai/projects/kuzu-memory
- Markdown: https://www.freshcrate.ai/projects/kuzu-memory.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/kuzu-memory/deps

_Generated by freshcrate.ai. Indexes github releases for AI-agent ecosystem packages._