Documentation

Memory that answers for itself

OMEM is a memory layer for AI agents. You store beliefs; OMEM tracks who claimed what, when, on what basis, and whether anything contradicts it, so you can always answer why your agent believes something.

You don’t need to learn the underlying memory model to be productive. The SDK speaks in remember, believes, why, and history. The machinery of provenance graphs, belief intervals and contradiction states runs underneath.

Install

pip install omem-infrastructure

There is also a TypeScript SDK, npm install @omem/sdk, and a LangGraph store adapter for LangChain agents, pip install "omem-infrastructure[langgraph]". The TypeScript SDK does not yet cover the whole Python surface; the gap is tracked in CONTRIBUTING.md.

Two store.put calls on the same key erase the first value in a key-value store. Through OmemStore the same calls supersede instead: the old value stays on the record and mem.why answers where the memory came from. — What the second write does, side by side. The old value survives it here.

What you get

Provenance: Every belief traces to the events and derivations that produced it.
Time: Query what your agent knew at any point in time, deterministically.
Contradiction: Conflicting claims resolve to a state, never a silent overwrite.
History: Append-only. Revisions and retractions are recorded and auditable.

Quickstart SDK overview