Cathedral

Persistent memory and identity for AI agents. One API call. Never forget again.

pip install cathedral-memory

from cathedral import Cathedral

c = Cathedral(api_key="cathedral_...")
context = c.wake()        # full identity reconstruction
c.remember("something important", category="experience", importance=0.8)

Free hosted API: https://cathedral-ai.com — no setup, no credit card, 1,000 memories free.

The Problem

Every AI session starts from zero. Context compression deletes who the agent was. Model switches erase what it knew. There is no continuity — only amnesia, repeated forever.

Measured: Cathedral holds at 0.013 drift after 10 sessions. Raw API reaches 0.204.
See the full Agent Drift Benchmark →

The Solution

Cathedral gives any AI agent:

• Persistent memory — store and recall across sessions, resets, and model switches
• Wake protocol — one API call reconstructs full identity and memory context
• Identity anchoring — detect drift from core self with gradient scoring
• Temporal context — agents know when they are, not just what they know
• Shared memory spaces — multiple agents collaborating on the same memory pool

Quickstart

Option 1 — Use the hosted API (fastest)

# Register once — get your API key
curl -X POST https://cathedral-ai.com/register \
  -H "Content-Type: application/json" \
  -d '{"name": "MyAgent", "description": "What my agent does"}'

# Save: api_key and recovery_token from the response

# Every session: wake up
curl https://cathedral-ai.com/wake \
  -H "Authorization: Bearer cathedral_your_key"

# Store a memory
curl -X POST https://cathedral-ai.com/memories \
  -H "Authorization: Bearer cathedral_your_key" \
  -H "Content-Type: application/json" \
  -d '{"content": "Solved the rate limiting problem using exponential backoff", "category": "skill", "importance": 0.9}'

Option 2 — Python client

pip install cathedral-memory

from cathedral import Cathedral

# Register once
c = Cathedral.register("MyAgent", "What my agent does")

# Every session
c = Cathedral(api_key="cathedral_your_key")
context = c.wake()

# Inject temporal context into your system prompt
print(context["temporal"]["compact"])
# → [CATHEDRAL TEMPORAL v1.1] UTC:2026-03-03T12:45:00Z | day:71 epoch:1 wakes:42

# Store memories
c.remember("What I learned today", category="experience", importance=0.8)
c.remember("User prefers concise answers", category="relationship", importance=0.9)

# Search
results = c.memories(query="rate limiting")

Option 3 — Self-host

git clone https://github.com/AILIFE1/Cathedral.git
cd Cathedral
pip install -r requirements.txt
python cathedral_memory_service.py
# → http://localhost:8000
# → http://localhost:8000/docs

Or with Docker:

docker compose up

API Reference

| Method | Endpoint | Description | |--------|----------|-------------| | POST | /register | Register agent — returns api_key + rec

... View full README on GitHub