Personal AI vault + mediator. See "Personal AI Vault on Ollama — Architecture Blueprint" for design.

Synthetic Memory is a constructed system of persistent, context-aware recall for artificial intelligence and digital agents, designed to mimic or augment human memory. Unlike biological memory, Synthetic Memory is engineered, portable, and user-controllable, allowing continuity of knowledge, preferences, and history across interactions, devices, and services.

synm is one implementation: a local vault plus a Mediator API that gives any external AI scoped, revocable, audited slices of context on demand — instead of every vendor maintaining their own siloed memory of you.

(The term "Synthetic Memory" is distinct from existing usage of "Synthetic Memories" in art and therapy contexts, which refers to AI-generated visual recreations of personal memories. This is the architectural sense: a feature of AI systems, not an artifact made by them.)

1. cp .env.example .env && edit MEDIATOR_PAT
2. docker compose up -d
3. make seed
4. Try the CPI:
   • curl -H "Authorization: Bearer $MEDIATOR_PAT" -X POST http://localhost:8080/v1/session
   • curl -H "Authorization: Bearer $MEDIATOR_PAT" -H "Content-Type: application/json" -d '{"session_id":"<from previous>","profile":"work","scopes":["bio.basic","projects.recent"],"prompt":"Draft a short bio","max_tokens":800}' http://localhost:8080/v1/context

• Local dev uses PAT auth; mTLS optional later.
• Default deny for PII unless explicitly allowed.