Memory API
Memories
Store, retrieve, update, and delete memories. Memories are the core building blocks of Hebbrix - they store knowledge that your AI can recall later.
Overview
A memory is a piece of information that you want your AI to remember. This could be:
- User preferences ("User prefers dark mode")
- Facts from conversations ("User's birthday is January 15th")
- Knowledge from documents ("The API rate limit is 100 requests per minute")
- Any structured or unstructured data you want to store
Endpoints
Code Examples
Create a Memory
Python
from hebbrix import Hebbrix
client = Hebbrix()
# Simple memory
memory = client.memories.create(
content="User's favorite color is blue"
)
# Memory with metadata
memory = client.memories.create(
content="User completed Python certification on 2024-01-15",
tags=["education", "python"],
metadata={
"certification_provider": "Coursera",
"completion_date": "2024-01-15"
}
)Batch Create
Python
# Create multiple memories at once
memories = [
{"content": "User prefers email over phone calls"},
{"content": "User works in software development"},
{"content": "User is based in EST timezone"},
]
result = client.memories.batch_create(memories=memories)
print(f"Created {result.created} memories")List and Filter
Python
# List all memories
memories = client.memories.list(limit=50)
# Filter by collection
memories = client.memories.list(
collection_id="col_customer_support",
limit=20
)
# Paginate through all
cursor = None
while True:
result = client.memories.list(cursor=cursor, limit=100)
for memory in result.memories:
process(memory)
if not result.next_cursor:
break
cursor = result.next_cursorcURL Examples
POST
/v1/memoriescurl -X POST "https://api.hebbrix.com/v1/memories" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"content": "User prefers dark mode",
"tags": [
"preferences"
]
}'GET
/v1/memories?limit=10curl -X GET "https://api.hebbrix.com/v1/memories?limit=10" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json"DELETE
/v1/memories/mem_abc123curl -X DELETE "https://api.hebbrix.com/v1/memories/mem_abc123" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json"Memory Lifecycle
When you create a memory, Hebbrix automatically:
1
Embeds the Content
Converts text to vector embeddings for semantic search.
2
Calculates Importance
Analyzes content to determine relevance and priority.
3
Extracts Entities
Identifies people, places, concepts and adds to knowledge graph.
4
Indexes for Search
Adds to BM25 index for keyword matching alongside vectors.