YourMemory — Persistent Memory for AI Agents | MCP Compatible

# YourMemory > Persistent memory for AI agents — built on the science of how humans remember. YourMemory is an open-source, local-first memory layer for AI agents (Claude, Cursor, Cline, Windsurf, and any MCP-compatible client). It gives AI assistants persistent memory across sessions using the Ebbinghaus forgetting curve, hybrid BM25 + vector retrieval, and an entity-based knowledge graph. One `pip install`, zero infrastructure required. ## Key Features - **Ebbinghaus decay** — memories fade exponentially over time; importance and recall frequency slow that decay. Weak memories are pruned automatically every 24 hours. - **Hybrid retrieval** — BM25 keyword scoring + cosine vector similarity, combined as `0.4 × bm25 + 0.6 × cosine`. - **Entity graph** — spaCy NER links memories that share named entities, enabling multi-hop reasoning across facts that have low embedding similarity. - **Subject-aware deduplication** — incoming memories are merged, reinforced, or replaced based on semantic similarity and contradiction detection. Never merges facts about different entities. - **Spatial memory** — memories tagged with file/directory paths get a retrieval boost when the agent is working in that context. - **`yourmemory ask`** — CLI command that answers factual questions from memory using a local Ollama model. Zero cloud API calls, zero tokens. - **Memory dashboard** — built-in browser UI at `localhost:3033/ui` to browse, filter, and sort memories by strength, category, and agent. - **Graph visualization** — interactive Cytoscape.js graph at `localhost:3033/graph` showing how memories are connected. - **Multi-agent support** — isolated private memories per agent with controlled access to shared context. ## Benchmark Results | Benchmark | Metric | Score | |-----------|--------|-------| | LongMemEval-S (500 questions) | Recall-all@5 | 84.8% | | LoCoMo-10 (1,534 QA pairs) | Recall@5 | 59% vs Zep Cloud 28% | | HotpotQA distractor (200 multi-hop quest