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