Show HN: OpensourceDB Tamper-evident,checksum-backed decision and session replay

Zizka-ai released ZizkaDB, an open-source, self-hosted audit trail for AI agents that logs each agent step with a parent_id so teams can trace a tool call or response back to its root cause. The stack ships via a Docker-based quickstart and includes Python and TypeScript SDKs plus integrations for LangChain, CrewAI, LiveKit voice agents, and MCP, with a managed Pro/Team cloud hosted at db.zizka.ai. The operator admin console and VPC deploy remain in the private zizkadb-cloud repository.

When your agent misbehaves, see why. Self-hosted audit trail for AI agents — one command or one dashboard click from any step back to root cause. This repository is the open-source self-host stack API, tenant dashboard, SDKs, MCP . Operator admin console and VPC deploy live in private zizkadb-cloud https://github.com/Zizka-ai/zizkadb-cloud — see docs/REPO SPLIT.md https://github.com/ZIZKA-AI-SL/ZizkaDB/blob/main/docs/REPO SPLIT.md . Requires Docker https://docs.docker.com/get-docker/ . First image pull may take 5–10 minutes. curl -fsSL https://raw.githubusercontent.com/Zizka-ai/ZizkaDB/main/scripts/quickstart-remote.sh | bash You should see: tool call · lookup order · ORD-8842 └── llm response · gpt-4o └── user message · Why was my order delayed? Run again anytime: pip install zizkadb-sdk && zizkadb demo git clone https://github.com/Zizka-ai/ZizkaDB.git && cd ZizkaDB bash scripts/setup-local.sh | Service | URL | |---|---| | API | http://localhost:8000 http://localhost:8000 | | Dashboard | http://localhost:3001/login http://localhost:3001/login | | Swagger | http://localhost:8000/swagger http://localhost:8000/swagger | Full guide: DEVELOPMENT.md https://github.com/ZIZKA-AI-SL/ZizkaDB/blob/main/DEVELOPMENT.md · Troubleshooting: wiki/Troubleshooting.md https://github.com/ZIZKA-AI-SL/ZizkaDB/blob/main/wiki/Troubleshooting.md Every agent team asks: Why did it say that? Why did it call that tool? 1. Log agent steps with parent id each step links to the one that caused it . 2. Ask why — terminal: zizkadb why <event id or Python: await db.why event id .print 3. See the chain — walk back to the user message, wrong tool, or bad context. Dashboard same chain : Activity → support-bot http://localhost:3001/dashboard/activity?agent=support-bot → click an event → Why? causal tab. python import asyncio from zizkadb import ZizkaDB async def main : async with ZizkaDB host="http://localhost:8000" as db: user = await db.log agent="my-bot", event="user message", data={"text": "Why is my order late?"} tool = await db.log agent="my-bot", event="tool call", data={"tool": "lookup order"}, parent id=user.event id await db.why tool.event id .print asyncio.run main Full guides: CONNECT.md https://github.com/ZIZKA-AI-SL/ZizkaDB/blob/main/CONNECT.md · LangChain https://github.com/ZIZKA-AI-SL/ZizkaDB/blob/main/CONNECT.md langchain · CrewAI https://github.com/ZIZKA-AI-SL/ZizkaDB/blob/main/CONNECT.md crewai · LiveKit voice https://github.com/ZIZKA-AI-SL/ZizkaDB/blob/main/CONNECT.md livekit-agents-voice · MCP / Cursor https://github.com/ZIZKA-AI-SL/ZizkaDB/blob/main/mcp/README.md | Python | TypeScript | LangChain | CrewAI | LiveKit | MCP | REST | |---|---|---|---|---|---|---| | zizkadb-sdk https://pypi.org/project/zizkadb-sdk/ | zizkadb-sdk https://www.npmjs.com/package/zizkadb-sdk | zizkadb-langchain https://pypi.org/project/zizkadb-langchain/ | zizkadb-crewai https://pypi.org/project/zizkadb-crewai/ | zizkadb-livekit https://pypi.org/project/zizkadb-livekit/ | uvx zizkadb-mcp | Swagger https://db.zizka.ai/swagger | Scaffold a project: zizkadb init my-agent --template basic pip install zizkadb-livekit One LiveKit call → one Session in Activity transcript only, no audio in ZizkaDB . Full guide: CONNECT.md → LiveKit https://github.com/ZIZKA-AI-SL/ZizkaDB/blob/main/CONNECT.md livekit-agents-voice · docs/integrations/livekit.md https://github.com/ZIZKA-AI-SL/ZizkaDB/blob/main/docs/integrations/livekit.md · example https://github.com/ZIZKA-AI-SL/ZizkaDB/blob/main/examples/livekit-agent . Managed cloud Pro / Team — optional Same Why? feature — hosted at db.zizka.ai https://db.zizka.ai . No Docker to maintain. The operator admin console, VPC deploy, and cloud-only marketing routes live in the private zizkadb-cloud https://github.com/Zizka-ai/zizkadb-cloud repo — see docs/REPO SPLIT.md https://github.com/ZIZKA-AI-SL/ZizkaDB/blob/main/docs/REPO SPLIT.md . | | Pro | Team | |---|---|---| | Price | €29 / mo | €69 / mo | | Events / mo† | 50k | 100k | | API keys | 2 | 5 | † Plan targets on managed cloud; not enforced in API yet. See docs/README.md https://github.com/ZIZKA-AI-SL/ZizkaDB/blob/main/docs/README.md plan-limits-honest . More features — drift, time-travel, search, GDPR | Function | What it does | |---|---| | db.baseline | Detect when agent behavior drifts vs past sessions | | db.at | Reconstruct what the agent knew at a timestamp | | db.search | Semantic search over agent history | | db.context for | Inject relevant past events into prompts | | db.forget | GDPR erasure by metadata filter | FAQ Do I need to clone this repo? No — the curl quickstart downloads config + Docker images only. Do I need an API key locally? No — http://localhost:8000 uses a built-in dev key. Dashboard: localhost:3001/login http://localhost:3001/login . How is this different from Langfuse / LangSmith? They observe span trees. ZizkaDB audits with explicit parent id chains and db.why on your Postgres — self-host under AGPL, no trace billing. Voice agents with LiveKit? Install zizkadb-livekit — one pip command, connect to Docker with ZIZKADB HOST=http://localhost:8000 . See LiveKit guide https://github.com/ZIZKA-AI-SL/ZizkaDB/blob/main/CONNECT.md livekit-agents-voice . zizkadb demo connection refused? Start the stack: curl -fsSL …/quickstart-remote.sh | bash or bash scripts/setup-local.sh . Docs & community | Worked example | worked/01-support-order-delay https://github.com/ZIZKA-AI-SL/ZizkaDB/blob/main/worked/01-support-order-delay | | Examples | examples/ https://github.com/ZIZKA-AI-SL/ZizkaDB/blob/main/examples — includes LiveKit voice agent https://github.com/ZIZKA-AI-SL/ZizkaDB/blob/main/examples/livekit-agent | | LiveKit integration | docs/integrations/livekit.md https://github.com/ZIZKA-AI-SL/ZizkaDB/blob/main/docs/integrations/livekit.md | | Self-hosting | DEVELOPMENT.md https://github.com/ZIZKA-AI-SL/ZizkaDB/blob/main/DEVELOPMENT.md · wiki/Self-Hosting https://github.com/Zizka-ai/ZizkaDB/wiki/Self-Hosting | | Troubleshooting | wiki/Troubleshooting.md https://github.com/ZIZKA-AI-SL/ZizkaDB/blob/main/wiki/Troubleshooting.md | | Integrate any agent | docs/integrate/ https://github.com/ZIZKA-AI-SL/ZizkaDB/blob/main/docs/integrate | | Issues · Discussions | Issues https://github.com/Zizka-ai/ZizkaDB/issues · Discussions https://github.com/Zizka-ai/ZizkaDB/discussions | | Contributing · Security | CONTRIBUTING.md https://github.com/ZIZKA-AI-SL/ZizkaDB/blob/main/CONTRIBUTING.md · SECURITY.md https://github.com/ZIZKA-AI-SL/ZizkaDB/blob/main/SECURITY.md | | AI-assisted development | AGENTS.md https://github.com/ZIZKA-AI-SL/ZizkaDB/blob/main/AGENTS.md · docs/ai/CODING STANDARDS.md https://github.com/ZIZKA-AI-SL/ZizkaDB/blob/main/docs/ai/CODING STANDARDS.md | <sub AGPL-3.0 · MCP server MIT · Disable telemetry: export ZIZKADB TELEMETRY=false </sub