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
View on GitHub ↗
Stars
422★
Forks
37
Language
TypeScript
License
NOASSERTION
Created
2026-05-18
Last push
2026-08-05