Memory
Store, search, and manage cognitive memories across sessions.
Memory
Cerebe's Memory Fabric provides persistent, searchable memory for your AI applications. Memories survive across sessions, enabling genuine personalization and context awareness.
Memory Types
| Type | Description | Example |
|---|---|---|
semantic | Facts and knowledge | "User is a software engineer" |
episodic | Events and experiences | "User struggled with algebra last session" |
procedural | Skills and processes | "User learns best with code examples" |
Core Operations
Store a Memory
await client.memory.add(
content="User prefers dark mode and concise responses",
user_id="user_123",
session_id="session_abc",
type="semantic",
importance=0.8,
metadata={"source": "preferences", "topic": "ui"},
)Search Memories
Semantic similarity search across all stored memories:
results = await client.memory.search(
query="What UI preferences does the user have?",
session_id="session_xyz",
user_id="user_123",
limit=5,
)Harvest from Conversations
Automatically extract memories from a chat transcript:
await client.memory.harvest(
session_id="session_abc",
transcript="User: I really love how you explained that visually...",
)Consolidate
Merge near-duplicate memories to keep the fabric clean:
await client.memory.consolidate(
entity_id="user_123",
similarity_threshold=0.92,
dry_run=True, # preview before merging
)How It Works
Cerebe's Memory Fabric combines three retrieval strategies:
- Vector Search (Qdrant) — Semantic similarity via embeddings
- Graph Search (Neo4j/Graphiti) — Relationship traversal
- BM25 Keyword Search — Traditional keyword matching
Results are fused and re-ranked to return the most relevant memories.
API Reference
| Method | Endpoint | Description |
|---|---|---|
POST | /api/v1/memory/store | Store a memory |
POST | /api/v1/memory/search | Search memories |
GET | /api/v1/memory/{id} | Get specific memory |
PATCH | /api/v1/memory/{id} | Update memory |
DELETE | /api/v1/memory/{id} | Delete memory |
POST | /api/v1/memory/harvest | Extract from transcript |
POST | /api/v1/memory/consolidate | Merge duplicates |