Installation

Kendra Orchestrator SDK requires Python 3.10 or newer.

Base install

pip install korchestrator

No GitHub credential needed — Kendralabs/korch-sdk is public and korchestrator is published on PyPI via Trusted Publishing (see ADR 0021).

The base install depends on pydantic alone — no LLM SDK, no workflow engine, nothing heavy. It imports cleanly and lets you construct configuration and typed models, but it cannot yet run a swarm: reasoning is built on DSPy and needs the [dspy] extra (see below).

Install what you need

Everything beyond pydantic is an optional extra — install only what your use case needs.

Extra	Adds	Needed for
[dspy]	dspy	Actually running a swarm — every reasoning agent is built on it. Almost everyone needs this one.
[temporal]	temporalio	The durable, replayable runtime (survives process crashes, supports pause/resume)
[routing]	sentence-transformers, numpy	Semantic model routing (routing by embedding similarity)
[mcp]	mcp	Connecting to Model Context Protocol tool servers
[remote]	httpx	KorchestratorClient — driving a remote, hosted Kendra Orchestrator engine
[otel]	opentelemetry-api, opentelemetry-sdk	Optional tracing/metrics export
[all]	every extra above	Development, or when you're not sure yet what you'll need

Extras compose — request as many as you need in one install:

# The common case: run swarms locally, durably, with real tools.
pip install "korchestrator[dspy,temporal,mcp]"

# Everything.
pip install "korchestrator[all]"

Installing an unreleased commit

To try something not yet in a tagged release (a dev-branch fix, an unmerged PR), install directly from git instead of PyPI:

pip install "korchestrator[dspy] @ git+https://github.com/Kendralabs/korch-sdk.git@dev"

Or, working from a local clone (editable, for actually developing the SDK itself):

git clone git@github.com:Kendralabs/korch-sdk.git && cd korch-sdk
pip install -e ".[dspy]"

Verify the install

python -c "import korchestrator; print(korchestrator.__version__)"

This works on the base install — no extras, no network, no API key required.

Next

Continue to the Quick Start to run your first swarm.