atomicstrata/atomicmemory
Portable semantic memory for AI agents: core engine, TypeScript SDK, framework adapters, MCP server, CLI, and host plugins.
422 ★37 forksTypeScriptUpdated 2d ago
What you need to know
Inspectable, portable semantic memory layer for agents and applications — a memory store you embed where AI code runs via SDK, CLI, MCP server, framework adapters, and host plugins, designed as a self-hostable alternative to hosted black-box memory products.
Install
npm install @atomicmemory/sdk npm install -g @atomicmemory/cli npm install @atomicmemory/vercel-ai @atomicmemory/sdk (framework adapter example) Core backend is Docker-deployable (packages/core Dockerfile)
Usage
- •Create a MemoryClient with a providers config (e.g. apiUrl http://localhost:17350), then memory.initialize(), memory.ingest({ mode: 'messages', ... }), and memory.search({ query, scope })
- •Use the CLI for setup, diagnostics, capture, retrieval, and context packaging
- •MCP server (@atomicmemory/mcp-server) and host plugins (Claude Code, OpenClaw, Hermes) install per host contract
Key features
- ✓Portable single memory protocol consumed by SDK, CLI, MCP server, framework adapters, and host plugins
- ✓Inspectable Core: open source, self-hostable, durable context with Postgres/pgvector storage
- ✓Correction-aware memory: supersession, clarification, deletion, no-op decisions, lineage, and trust-sensitive revision
- ✓Framework adapters for Vercel AI SDK, OpenAI Agents SDK, LangChain, LangGraph, Mastra
- ✓Host plugins for Claude Code, OpenClaw, Hermes (Codex and Cursor plugin source present but 'coming soon')
- ✓Benchmark claims: leading performance/cost on BEAM-100K, BEAM-1M, LoCoMo10 under matched methodology
Best for
Teams that want self-hostable, inspectable agent memory with a portable, model-agnostic interface
Caveats
- ⚠Codex and Cursor host plugins are 'coming soon' — not installable until marketplace manifests are validated
- ⚠Python SDK lives in a separate repository (not part of this monorepo)
- ⚠Until latency benchmarks are linked, treat the engine as 'designed for single-digit-ms local retrieval' — a design target, not a guarantee
- ⚠Core DB-backed tests require Postgres/pgvector provisioning
Platforms: Local/Docker self-host · Hosted profile availableClients: Claude Code · OpenClaw · Hermes · Codex (coming soon) · Cursor (coming soon)
Documentation ↗Reviewed 2026-08-07
Topics
agent-infrastructureagent-memoryai-agentsai-memoryclicontext-engineeringdeveloper-toolsllmlocal-firstmcpmemory-layermodel-context-protocolopen-sourcepgvectorpostgresretrievalsdkself-hostedsemantic-memorytypescript
- Stars
- 422★
- Forks
- 37
- Language
- TypeScript
- License
- NOASSERTION
- Created
- 2026-05-18
- Last push
- 2026-08-05