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

Stars
604★
Forks
3
Language
Python
License
Apache-2.0
Created
2026-07-20
Last push
2026-08-14