Skip to content
Zizkadb edited this page Jun 11, 2026 · 2 revisions

Welcome to the ZizkaDB wiki!

ZizkaDB Wiki

The operational database for AI agents — causal lineage, semantic search, time travel, and fleet dashboards.

Resource Link
Live product db.zizka.ai
Interactive docs db.zizka.ai/docs
API explorer db.zizka.ai/swagger
GitHub Zizka-ai/ZizkaDB
PyPI SDK zizkadb-sdk
PyPI MCP zizkadb-mcp
npm SDK zizkadb-sdk

What is ZizkaDB?

ZizkaDB stores every agent decision as an event with optional parent_id links, so you can:

Need Primitive
Why did the agent do that? why(event_id)
What did it know at 2pm Tuesday? at(agent, timestamp)
Find similar past failures search() / context_for()
Is this agent drifting? Behavioral baseline + dashboard

Quick start

  1. Sign up
  2. Dashboard → Create agent (e.g. my-bot) — copy API key once
  3. pip install zizkadb-sdk
  4. Log with the same agent name as in the dashboard
  5. Events appear at db.zizka.ai/dashboard

Golden rule: agent name in code = agent name in dashboard (or use a tenant-wide key — see Agents-and-API-Keys)


Wiki pages

Wiki page title Copy from file
Getting-Started wiki/Getting-Started.md
Agents-and-API-Keys wiki/Agents-and-API-Keys.md
Python-SDK wiki/Python-SDK.md
TypeScript-SDK wiki/TypeScript-SDK.md
MCP-and-Cursor wiki/MCP-and-Cursor.md
REST-API wiki/REST-API.md
Multi-Agent-Apps wiki/Multi-Agent-Apps.md
Self-Hosting wiki/Self-Hosting.md
Production-Deployment wiki/Production-Deployment.md
Troubleshooting wiki/Troubleshooting.md
Architecture wiki/Architecture.md
Wiki page title Copy from file
Getting-Started wiki/Getting-Started.md
Agents-and-API-Keys wiki/Agents-and-API-Keys.md
Python-SDK wiki/Python-SDK.md
TypeScript-SDK wiki/TypeScript-SDK.md
MCP-and-Cursor wiki/MCP-and-Cursor.md
REST-API wiki/REST-API.md
Multi-Agent-Apps wiki/Multi-Agent-Apps.md
Self-Hosting wiki/Self-Hosting.md
Production-Deployment wiki/Production-Deployment.md
Troubleshooting wiki/Troubleshooting.md
Architecture wiki/Architecture.md

Clone this wiki locally