Getting Started
Installation
Install Kitaru with uv or pip
Kitaru requires Python 3.11 or newer.
You can verify your interpreter with:
python --versionuv add kitarupip install kitaruThis 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]"Verify Installation
uv run kitaru --version
uv run kitaru --helpkitaru --version
kitaru --helpLocal UI
If you installed the local extra, you can start a local server with a web
UI for browsing executions:
kitaru loginThis 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.