Your First Memory

A five-step round-trip against a local server using the in-memory stub embedder.

# 1. Start a local server (stub embedder, in-memory DB)
grafomem serve -e stub --db :memory:

# 2. Create a store
curl -X POST localhost:8000/v1/stores -H 'Content-Type: application/json' -d '{}'

# 3. Write a memory
curl -X POST localhost:8000/v1/stores/default/write \
  -H 'Content-Type: application/json' \
  -d '{"content": "Aria lives in Rome"}'

# 4. Retrieve
curl -X POST localhost:8000/v1/stores/default/retrieve \
  -H 'Content-Type: application/json' \
  -d '{"query": "Where does Aria live?", "budget_tokens": 256}'

# 5. Audit — the immutable record
curl localhost:8000/v1/stores/default/audit

Verify ports and paths

The default port and exact route shapes are defined in src/aml/server/app.py (and visible in the live Swagger at /docs). Confirm them against your version before copying into production scripts.