Installation

Install Kitaru with uv or pip

Kitaru requires Python 3.11 or newer.

You can verify your interpreter with:

python --version

uv (recommended)

uv add kitaru

pip

This gives you the full SDK, CLI, and everything you need to run flows locally.

Optional extras

Extra	What it adds
local	Local server and UI for browsing executions in a local web UI
mcp	MCP server for querying executions from AI assistants
pydantic-ai	PydanticAI adapter for wrapping agents in checkpoints

uv add "kitaru[mcp,pydantic-ai,local]"
# or: pip install "kitaru[mcp,pydantic-ai,local]"

If you use Claude Code or another MCP-capable assistant, install kitaru[mcp] so your assistant can query executions, inspect logs and artifacts, provide input to waiting runs, and start replays through structured tool calls. See MCP Server for setup.

Verify Installation

uv project

uv run kitaru --version
uv run kitaru --help

pip environment

Local UI

If you installed the local extra, you can start a local server with a web UI for browsing executions:

kitaru login

This launches the Kitaru server on your machine and opens the UI in your browser. You can inspect flows, checkpoints, logs, and artifacts from any execution you have run locally.

Next Steps

Head to the Quickstart to explore what's available, see Execution management for lifecycle operations, or open MCP Server for assistant-native querying.