cathedral-server 0.1.0

Local-first Cathedral memory server — run your own persistent AI agent memory, same API as cathedral-ai.com

cathedral-server

Local-first Cathedral memory server. Same API as cathedral-ai.com, backed by local SQLite. No external dependencies, no cloud required.

Install

pip install cathedral-server

Run

cathedral-server run
# Server at http://127.0.0.1:8000
# Docs at  http://127.0.0.1:8000/docs

Custom port or DB path:

cathedral-server run --port 9000 --db /path/to/my.db

Or with environment variables:

CATHEDRAL_DB=/path/to/my.db cathedral-server run --host 0.0.0.0 --port 8000

Use with cathedral-memory client

from cathedral import Cathedral

# Point at your local server
c = Cathedral(api_key="cathedral_...", base_url="http://localhost:8000")

context = c.wake()
c.remember("I am running locally now", category="identity", importance=0.9)

API

All endpoints match the hosted API at cathedral-ai.com:

Method	Path	Description
POST	/register	Register a new agent, get API key
GET	/wake	Full identity reconstruction package
POST	/memories	Store a memory
GET	/memories	Recall memories (filter, search, paginate)
POST	/memories/bulk	Bulk store
PATCH	/memories/{id}	Update a memory
DELETE	/memories/{id}	Delete a memory
POST	/anchor/verify	Verify identity anchor
GET	/me	Agent profile
POST	/snapshot	Freeze identity snapshot
GET	/snapshots	List snapshots
GET	/snapshot/{id}	Retrieve snapshot with integrity check
GET	/drift	Compare live identity against last snapshot
POST	/memories/compact	Propose memory merges
POST	/memories/compact/confirm	Execute confirmed merges
POST	/behaviour	Record session behaviour hash
GET	/behaviour	Behaviour trend + consistency score
GET	/health	Server health

Full interactive docs at http://localhost:8000/docs when the server is running.

License

MIT