MemPalace/mempalace
mempalace
The best-benchmarked open-source AI memory system. And it's free.
GitHub metrics
- Stars
- 60K
- +135 this week
- Forks
- 7.6K
- 30-day growth
- —
- Open issues
- 365
| Day | GitHub stars |
|---|---|
| 2026-10-04 | 59403 |
| 2026-10-10 | 59488 |
| 2026-10-13 | 59538 |
What it does
MemPalace is a Python memory layer for AI assistants: it saves your past conversations and project files word for word on your own machine, then lets you or your agent search them by meaning.
The project deliberately avoids summarizing what it stores. Records are filed into a hierarchy the authors call a palace: each person or project gets a wing, subjects inside it become rooms, and the original text sits in drawers. A search can then stay inside one wing instead of scanning everything. ChromaDB is the default vector store, and the repository ships opt-in adapters for SQLite, a native Rust engine, Milvus, Qdrant and pgvector.
Day to day, you point the mempalace CLI at a code folder or at Claude Code session logs, and it indexes them. An MCP server exposes the palace to agents with 45 tools, and hooks for Claude Code, Codex CLI and Cursor save sessions on a schedule and before context compression. The README reports 96.6% recall at five on the LongMemEval benchmark using plain semantic search with no language model involved, and says the scripts to reproduce that figure are in the repository.
Why it matters
Coding agents forget everything between sessions, and many memory tools fix that by having a model condense chats into extracted notes. MemPalace keeps the raw text instead and searches it locally, so nothing is rewritten and, per the README, nothing goes off your machine unless you turn that on. Its storage interface is swappable, which lets a team move from embedded ChromaDB to a Postgres or Qdrant server without changing how agents call it.
Main features
- Stores conversations and files verbatim, then retrieves them with semantic search
- Wing, room and drawer structure lets searches stay scoped
- ChromaDB by default; Milvus, Qdrant, pgvector and SQLite adapters are opt-in
- MCP server with 45 tools, including knowledge-graph and agent diary operations
- Auto-save hooks for Claude Code, Codex CLI and Cursor
- Temporal knowledge graph stored in local SQLite
- Multi-arch Docker image for amd64 and arm64
- Optional embeddings from any OpenAI-compatible endpoint, such as Ollama or LM Studio
Who it's for
- Developers using Claude Code, Codex CLI or Cursor who want past sessions searchable
- Teams that want a shared memory server for several agents
- People who prefer local storage over a hosted memory service
- Builders who want to plug their own vector database into an agent memory layer
Strengths
- Keeps original text instead of model-written summaries
- Runs locally by default, with no API key needed for the core path
- Storage backend can be swapped without touching the rest of the system
- The README links benchmark scripts and committed per-question result files
Limitations
- Native Android/Termux installs are unsupported; the README points to a Debian PRoot container instead
- The GPU container image is not published, must be built locally and only builds on x86_64
- The first command that needs embeddings downloads the model, so it is slow and needs network
- Benchmark figures are the project's own; the README declines side-by-side comparisons with other memory tools
Getting started
The README recommends uv so the CLI lands in its own isolated environment; plain pip is meant for an activated virtualenv. A container image covers machines without a Python toolchain.
uv tool install mempalace
pip install mempalace
docker pull ghcr.io/mempalace/mempalace:latest
Requirements: Python 3.9+, a vector store (ChromaDB is bundled by default) and roughly 300 MB of disk for the default embedding model; no API key for the core local workflow.
Always follow the official instructions in the README on GitHub. This overview is our summary, not a copy.
Sources
- MemPalace/mempalaceRepositoryPrimarygithub.com
- MemPalaceOfficial sitePrimarymempalaceofficial.com
- mempalaceofficial.com/guide/getting-started.htmlWeb