$git clone https://github.com/agentic-box/memoraCore Storage - πΎ Persistent Storage - SQLite with optional cloud sync (S3, R2, D1) - π Hierarchical Organization - Section/subsection structure with auto-hierarchy assignment - π¦ Export/Import - Backup and restore with merge strategies
| 1 | <h1 align="center"><img src="media/memora_new.gif" width="60" alt="Memora Logo" align="absmiddle"> Memora</h1> |
| 2 | Β |
| 3 | <p align="center"><sub><sub><i>"You never truly know the value of a moment until it becomes a memory."</i></sub></sub></p> |
| 4 | Β |
| 5 | <p align="center"> |
| 6 | <b>Give your AI agents persistent memory</b><br> |
| 7 | An MCP memory layer for agents: structured storage, semantic retrieval, graph relations, and source-backed cross-session context. |
| 8 | </p> |
| 9 | Β |
| 10 | <p align="center"> |
| 11 | <a href="https://github.com/agentic-box/memora/releases"><img src="https://img.shields.io/github/v/tag/agentic-box/memora?label=version&color=blue" alt="Version"></a> |
| 12 | <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-green" alt="License"></a> |
| 13 | <a href="https://github.com/thedotmack/awesome-claude-code"><img src="https://awesome.re/mentioned-badge.svg" alt="Mentioned in Awesome Claude Code"></a> |
| 14 | </p> |
| 15 | Β |
| 16 | <p align="center"> |
| 17 | <img src="media/memora-absorb-digest-flow.gif" alt="Memora absorb and digest flow" width="820"> |
| 18 | </p> |
| 19 | Β |
| 20 | <p align="center"> |
| 21 | <b>Absorb agent work into durable graph memory, then use <code>memory_digest(topic)</code> to retrieve relevant memories, TODOs/issues, related edges, and source IDs.</b> |
| 22 | </p> |
| 23 | Β |
| 24 | <p align="center"> |
| 25 | <b><a href="#features">Features</a></b> Β· <b><a href="#preview">Preview</a></b> Β· <b><a href="#install">Install</a></b> Β· <b><a href="#usage">Usage</a></b> Β· <b><a href="#configuration">Config</a></b> Β· <b><a href="#live-graph-server">Live Graph</a></b> Β· <b><a href="#cloud-graph">Cloud Graph</a></b> Β· <b><a href="#chat-with-memories">Chat</a></b> Β· <b><a href="#semantic-search--embeddings">Semantic Search</a></b> Β· <b><a href="#document-storage">Documents</a></b> Β· <b><a href="#llm-deduplication">LLM Dedup</a></b> Β· <b><a href="#memory-linking">Linking</a></b> Β· <b><a href="#neovim-integration">Neovim</a></b> |
| 26 | </p> |
| 27 | Β |
| 28 | ## Features |
| 29 | Β |
| 30 | **Core Storage** |
| 31 | - πΎ **Persistent Storage** - SQLite with optional cloud sync (S3, R2, D1) |
| 32 | - π **Hierarchical Organization** - Section/subsection structure with auto-hierarchy assignment |
| 33 | - π¦ **Export/Import** - Backup and restore with merge strategies |
| 34 | Β |
| 35 | **Search & Intelligence** |
| 36 | - π **Semantic Search** - Vector embeddings (TF-IDF, sentence-transformers, OpenAI) |
| 37 | - π― **Advanced Queries** - Full-text, date ranges, tag filters (AND/OR/NOT), hybrid search |
| 38 | - π **Cross-references** - Auto-linked related memories based on similarity |
| 39 | - π€ **LLM Deduplication** - Find and merge duplicates with AI-powered comparison |
| 40 | - π **Memory Linking** - Typed edges, importance boosting, and cluster detection |
| 41 | Β |
| 42 | **Document Storage** |
| 43 | - π **Structured Documents** - Store markdown documents as searchable fragment trees (claims, plan items, references, risks) |
| 44 | - π **Fragment Integrity** - Guards against accidental delete/merge/absorb of document fragments |
| 45 | - π **Granular Search** - Individual claims and findings are semantically searchable while the full document remains retrievable as a unit |
| 46 | Β |
| 47 | **Tools & Visualization** |
| 48 | - β‘ **Memory Automation** - Structured tools for TODOs, issues, and sections |
| 49 | - πΈοΈ **Knowledge Graph** - Interactive visualization with Mermaid rendering and cluster overlays |
| 50 | - π **Live Graph Server** - Built-in HTTP server with cloud-hosted option (D1/Pages) |
| 51 | - π¬ **Chat with Memories** - RAG-powered chat panel with LLM tool calling to search, create, update, and delete memories via streaming chat |
| 52 | - π‘ **Event Notifications** - Poll-based system for inter-agent communication |
| 53 | - π **Statistics & Analytics** - Tag usage, trends, and connection insights |
| 54 | - π§ **Memory Insights** - Activity summary, stale detection, consolidation suggestions, and LLM-powered pattern analysis |
| 55 | - π **Action History** - Track all memory operations (create, update, delete, merge, boost, link) with grouped timeline view |
| 56 | Β |
| 57 | ## Preview |
| 58 | Β |
| 59 | <p align="center"> |
| 60 | <img src="media/demo.gif" alt="Memora memory graph demo" width="320"> |
| 61 | <img src="media/demo2.gif" alt="Memora memory interaction demo" width="320"> |
| 62 | </p> |
| 63 | Β |
| 64 | ## Install |
| 65 | Β |
| 66 | ```bash |
| 67 | pip install git+https: |