cd api
docker compose up --build -d # Qdrant + MemWire on :8000
http://localhost:8000
Interactive docs: http://localhost:8000/docs
Store memory
POST /v1/memories
curl -X POST http://localhost:8000/v1/memories \
-H "Content-Type: application/json" \
-d '{
"user_id": "alice",
"app_id": "app_a",
"workspace_id": "team_1",
"messages": [
{ "role": "user", "content": "I prefer dark mode and short answers." }
]
}'
[
{
"memory_id": "mem_3f7a1c2d9e4b",
"user_id": "alice",
"content": "I prefer dark mode and short answers.",
"role": "user",
"category": "preference",
"strength": 1.0
}
]
Recall context
POST /v1/memories/recall
curl -X POST http://localhost:8000/v1/memories/recall \
-H "Content-Type: application/json" \
-d '{
"user_id": "alice",
"app_id": "app_a",
"workspace_id": "team_1",
"query": "How should I format my answers?"
}'
{
"query": "How should I format my answers?",
"supporting": [{ "tokens": ["dark", "mode"], "score": 0.87, "memories": [...] }],
"conflicting": [],
"knowledge": [],
"formatted": "alice prefers dark mode and short answers.",
"has_conflicts": false
}
Search memories
POST /v1/memories/search
curl -X POST http://localhost:8000/v1/memories/search \
-H "Content-Type: application/json" \
-d '{
"user_id": "alice",
"query": "dark mode",
"limit": 10
}'
[
{
"memory": {
"memory_id": "mem_3f7a1c2d9e4b",
"content": "I prefer dark mode and short answers.",
"category": "preference"
},
"score": 0.94
}
]