Give your agent a memory in five lines.
remember() writes. recall() retrieves. Every record comes back typed and source-linked, with audit built in. Bring your own model keys; we run the memory.
MCP-compatible interface
Protocol-native by default.
The memory layer is MCP-compatible end to end. A focused public MCP interface exposes read, write, and retrieval. Advanced orchestration and behavioural enforcement remain internal.
Runtime primitive
Three verbs. One mental model.
Remember creates the record. Recall returns scoped context. Forget removes records while preserving the audit trail.
await octa.remember({
scope: "acme/launch",
type: "episodic",
content: "Beta opens March 20.",
sources: ["linear:OCT-42"]
});id
mem_01HZ
source
linear:OCT-42
audit
evt_3921
§ 01API surface
Clean, consistent endpoints.
The same memory primitives across every interface. Pick the surface that matches your runtime. The contract is identical between REST, the Python and JavaScript SDKs, and MCP.
Authentication
Bearer · X-API-Key
OCTAMEM_API_KEY in the Authorization header.
Memory · add
POST /api/memory/add
Store content as memory with optional prior context.
Memory · search
POST /api/memory/search
Query memory in natural language and get the result back.
Usage & account
GET /api/memory/details
Key validity, plan, memory used, and wallet balance.
Python SDK
pip install octamem
Typed, async-first. Works with any async runtime.
JavaScript SDK
npm install octamem
TypeScript-first. Edge-runtime compatible.
§ 02Quick start
Quick start examples.
Remember a record, recall it, inspect the source. Same shape across Python, JavaScript, and the REST API.
from octamem import OctaMem
client = OctaMem(api_key="YOUR_API_KEY")
client.add(
content="Launch date set for April 15. Beta opens March 20.",
previous_context="Q1 product planning meeting",
)§ 03Use cases
Where builders plug it in.
Long-term memory plugs into the shapes teams are already building. Four common patterns OctaMem is shaped for.
- 01
Chatbots.
Long-term memory across sessions and model switches. The chatbot stops repeating itself.
- 02
AI Agents.
Agents retain behavioural context, decisions, and preferences across tasks.
- 03
Copilots.
Developer copilots that remember project structure, conventions, and patterns.
- 04
RAG Pipelines.
Augment retrieval with structured user memory for personalised, traceable results.
§ 04Ready to integrate
Get your API key. Start building.
Builder includes 5,000 MOps a month, 10 GB of memory, and full SDK access for $49 a month. Move to larger workspaces, longer audit retention, or sovereign deployment when you need them. The code stays the same.
Builder · $49/month · 5,000 MOps · 10 GB included.