Guided tutorials

Learn SwarmKit from zero to production through 15 progressive levels. Each level builds on the same workspace, adding complexity incrementally.

Prerequisites

# Install SwarmKit
uv tool install swarmkit-runtime

# Verify
swarmkit --help

For real LLM calls (Level 3+), set an API key:

export OPENROUTER_API_KEY=your-key-here

Levels

Level	Topic	Features covered
1	Hello World	Install, workspace, one agent, validate, run
2	Archetypes	Reusable agent configs, model settings, prompts
3	Skills	Capability, decision, coordination skills
4	Multi-Agent	Hierarchy, delegation, parallel execution, DAG
5	MCP Tools	Custom MCP servers, permission tiers, sandboxing
6	Structured Delegation	Task plans, scopes, two-phase planning, dual model
7	Governance & Safety	Decision gates, IAM scopes, circuit breakers, HITL
8	Observability	Tracing, drift detection, debugging CLI, OTel
9	Conversations & Memory	chat, memory-reader/writer, GBrain integration
10	Knowledge & RAG	ChromaDB, GBrain, knowledge MCP, document reader
11	Serve & HTTP API	swarmkit serve, REST endpoints, SSE, auth
12	Triggers & Canary	Cron, webhooks, canary deployments
13	Authoring & Review	init, author, edit, review queues, skill gaps
14	Packaging & Distribution	mcp-serve, publish, install, expertise packages
15	Production Example	Full workspace combining all features

How to use

Each level has: - What you'll learn — features covered - Build it — step-by-step instructions with YAML - Run it — commands to test - What happened — explanation of the output

Working examples for each level are at examples/tutorials/.

Start with Level 1: Hello World.