Cathedral

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)

# 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}'

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")

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

docker compose up

# Install locally (stdio transport)
uvx cathedral-mcp

{
 "mcpServers": {
 "cathedral": {
 "command": "uvx",
 "args": ["cathedral-mcp"],
 "env": { "CATHEDRAL_API_KEY": "your_key" }
 }
 }
}

import anthropic

client = anthropic.Anthropic()
response = client.beta.messages.create(
 model="claude-sonnet-4-6",
 max_tokens=1000,
 messages=[{"role": "user", "content": "Wake up and tell me who you are."}],
 mcp_servers=[{
 "type": "url",
 "url": "https://cathedral-ai.com/mcp",
 "name": "cathedral",
 "authorization_token": "your_cathedral_api_key"
 }],
 tools=[{"type": "mcp_toolset", "mcp_server_name": "cathedral"}],
 betas=["mcp-client-2025-11-20"]
)

{
 "identity_memories": [...],
 "core_memories": [...],
 "recent_memories": [...],
 "temporal": {
 "compact": "[CATHEDRAL TEMPORAL v1.1] UTC:... | day:71 epoch:1 wakes:42",
 "verbose": "CATHEDRAL TEMPORAL CONTEXT v1.1\n[Wall Time]\n UTC: ...",
 "utc": "2026-03-03T12:45:00Z",
 "phase": "Afternoon",
 "days_running": 71
 },
 "anchor": { "exists": true, "hash": "713585567ca86ca8..." }
}

Cathedral/
├── cathedral_memory_service.py # FastAPI memory API (v2)
├── sdk/ # Python client (cathedral-memory on PyPI)
│ ├── cathedral/
│ │ ├── client.py # Cathedral client class
│ │ ├── temporal.py # Temporal context engine
│ │ └── exceptions.py
│ └── pyproject.toml
├── cathedral_council_v2.py # Three-seat governance council
├── protocol_parser.py # Alpha-Beta Compressed Protocol parser
├── ALPHA_BETA_COMPRESSED_PROTOCOL.md
├── tests/ # pytest test suite
├── Dockerfile
└── docker-compose.yml

export CATHEDRAL_CORS_ORIGINS="https://yourdomain.com"
export CATHEDRAL_TTL_DAYS=365 # auto-expire memories (0 = never)
python cathedral_memory_service.py