SDK
Eight verbs, one memory model
The SDK speaks the language of an agent remembering things. Each verb maps 1:1 to an operation in the OMEM standard. There are no hidden semantics, and you can always drop to the raw operations when you need to.
The verbs
| Verb | Signature and effect |
|---|---|
| remember | remember(agent, about, claim, because=None, scope=None) Record a belief, optionally grounded in events. |
| believes | believes(about, claim) -> State The four-valued belief state at the current time. |
| why | why(assertion_id) -> Provenance Evidence, grounding, interval, and contradictions. |
| recall | recall(about=None, *, agent=None, context=None, as_of=None, limit=10) Retrieve what is relevant, with belief state and conflicts attached. |
| contradict | contradict(claim_a, claim_b) Declare two claims opposed. OMEM never infers this. |
| observe | observe(agent, interaction, source=None, scope=None) Feed a raw interaction; OMEM decides what becomes memory. |
| about | about(entity) -> [Belief] Every open belief whose subject includes this entity. |
| share | share(assertion_id, scope, granted_by=None) Promote a memory's visibility: org, team:<id>, agent:<id>, user:<id>. |
The same call, everywhere
from omem import Memory
mem = Memory(api_key="omem_sk_...",
base_url="http://127.0.0.1:8787",
project="proj_...")
mem.remember(agent="support-bot",
about="customer:alice",
claim="prefers_annual_billing")
mem.believes(about="customer:alice",
claim="prefers_annual_billing") # 'BELIEVED_TRUE'