MaxFreedomPollard/Compartment
View on GitHub ↗Encrypted, fully offline agentic memory. One click install, GUI w/ memory map, all OS and agents. Superior memory creation, storage and retrieval.
604 ★3 forksPythonUpdated 21d ago
What you need to know
Compartment is a fully-offline, encrypted-at-rest agentic memory MCP server plus desktop app — a single portable vault shared by Hermes, Claude, OpenClaw and 28+ other MCP agents, with local embeddings, deterministic importance-ranked retrieval, and cryptographically sealed storage.
Install
pip install compartment && compartment init compartment integrate claude (or hermes / openclaw) to wire the agent macOS one-click: open Compartment.pkg from the latest release (Python, model, deps included)
Usage
- •Serve via stdio: {compartment: {command: 'compartment', args: ['serve']}} in any MCP client
- •Type /compartmentalize in Claude to sweep the whole conversation into the vault before compaction
- •compartment dash opens the vault in a local browser (127.0.0.1, random token, read-only); compartment recent/status to inspect memory
Key features
- ✓Encrypted at rest (XChaCha20-Poly1305 AEAD incl. vectors), Argon2id passphrase + optional 2FA keyfile, crypto-shred forget, hash-chained tamper-evident audit log
- ✓100% offline: runtime guard aborts on any network attempt, CI-proven on macOS/Windows/Linux; no API key, no LLM in the hot path, one pinned embedding space
- ✓Deterministic importance tiers (decisions 0.90 → pleasantries 0.20), hybrid vector+keyword recall (p95 0.68 ms vector search), relation graph with validity windows
- ✓Ships 6,718 seeded curated facts (constants, hardware specs, ports, encodings, shell/git/regex/SQL, countries) for offline agents; MCP memory tools (memory_search/store/forget/link/relations/lock)
Best for
Privacy-conscious agent users running Claude/Hermes/OpenClaw offline who want durable, fast, encrypted agent memory shared across agents on one machine.
Caveats
- ⚠Memory unlocks by default for weeks until restart/power loss or manual lock; restart always locks the vault
- ⚠Local embeddings use ~300 MB RAM; a host-model API key still needed for the agent's actual reasoning
- ⚠Vault is single-file and transferable; forgetting is by crypto-shred, not soft delete
Platforms: macOS · Windows · LinuxClients: Claude Code · Claude Desktop · Hermes · OpenClaw · Cursor · VS Code · Cline · Zed · Codex CLI · Gemini CLI · 28+ MCP clients
Documentation ↗Reviewed 2026-08-11
Topics
agent-memoryai-agentsai-memoryclaudeclaude-codeclaude-desktopencryptionhermeshermes-agentlocal-firstlong-term-memorymcpmcp-servermodel-context-protocolofflineopenclawprivacyragsemantic-searchvector-database
- Stars
- 604★
- Forks
- 3
- Language
- Python
- License
- Apache-2.0
- Created
- 2026-07-20
- Last push
- 2026-08-14