What it does

Memory OS is a local-first memory infrastructure for Hermes Agent. It captures conversations, extracts structured facts, builds a self-curating wiki, and injects relevant context back into prompts — all running on your machine via Docker (Qdrant, Redis, ARQ) with any LLM provider you already use.

The core pitch is straightforward: stop re-explaining your project to an agent that forgot yesterday’s decisions. The system handles recall automatically, then uses an explicit “Ground Truth” hierarchy to instruct the agent that injected memory is authoritative — not something to re-verify.

The interesting bit

Layer 7 is the twist. The README argues convincingly that perfect memory injection is useless if the agent treats it as suspicious context and re-discovers it via tool calls. Memory OS solves this with SOUL.md and rulebook.md files that rank injected memory as authoritative, stopping the “memory-zero behavior” of agents that ignore what’s already in their prompt.

Key highlights

• Seven layers: workspace files → SQLite sessions → structured facts with trust scoring → cross-session Fabric recall → Qdrant hybrid search (dense + BM25 sparse, with 4-level fallback) → auto-curating LLM wiki → Ground Truth identity layer
• One-command install via curl-to-bash script; v0.2.0 added smoke tests and verified on modest hardware
• Heavily forked Icarus plugin bundled; not upstream-compatible (LLM-powered extraction, multi-source injection, CREATIVE.md isolation)
• Weekly decay scanner + semantic deduplication (cosine >0.92 merges) + per-session dedup to keep token use surgical
• Explicit comparison table against mem0, Zep, Letta — all marked as cloud-first, lacking local infrastructure and Ground Truth hierarchy

Caveats

• Requires Hermes Agent specifically; not a generic memory layer for other agent frameworks
• One-command install is curl-to-bash — convenient, but the security-conscious will want to read the script first
• The Icarus fork is bundled and diverged enough to be a maintenance burden; upstream compatibility is explicitly broken

Verdict

Worth a look if you run Hermes daily and are exhausted by amnesiac agents. Skip it if you’re not on Hermes, or if you’re satisfied with cloud-hosted memory subscriptions and don’t mind re-explaining yourself.