Quickstart

Get Kizuna-Mem running and make your first observation in under 5 minutes.

1. Unpack and run

# Unpack the signed release artifact provided with your license
tar -xzf kizuna-mem-v0.1.0.tar.gz
cd kizuna-mem
KIZUNA_LICENSE_KEY=your-key docker compose up -d

This starts the Zig core and Rust sidecar as separate containers with shared persistent storage. License keys are issued on purchase.

2. Verify health

curl http://localhost:50051/v1/health

Response

{
  "status": "healthy",
  "version": "0.1.0",
  "uptime_seconds": 12
}

3. Make your first observation

curl -X POST http://localhost:50051/v1/observe \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "tenant_id": "user-42",
    "speaker": "user",
    "text": "I prefer dark mode and use Python primarily"
  }'

4. Retrieve context

curl -X POST http://localhost:50051/v1/retrieve \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "tenant_id": "user-42",
    "query": "What are the user preferences?",
    "top_k": 5
  }'

5. Install an SDK

Pythonpip install kizuna-mem

TypeScriptnpm i @kizuna/mem

Rustcargo add kizuna-mem

Elixir{:kizuna_mem, "~> 0.1"}