Tutorials

Each tutorial is a mini-project: a small, complete build you can run end to end, written around one of the repo's tested examples/ directories. They are ordered roughly by dependency — later tutorials assume you can compile a basic tree — but each one stands alone.

Tutorial	You build	Features it motivates	Read alongside
Support-ticket triage bot	A dispatcher routing tickets to billing/tech specialist subagents	Agent trees, TemplateSlot, subagents, Task-tool + primary-mode dispatch	Agent model, Workflows and subagents
Database reporting agent	A daily-report agent over a resource-bound SQLite tool, tested mock-only in CI	ScriptTool, AccessProfile resources, MockResponse, ToolTest/AgentTest, oac test	Tools, Testing
One agent, three models	The same summarizer compiled for a strong cloud model, a cheap cloud model, and local vLLM	ModelPreset, VariantSpec, SplitProfile	Variants and profiles, Registry and compilation
Self-improving agent	A weak agent measurably improved, promoted, and auto-reloaded	OptimisationCriterion, mutators, IterativeLoop, oac promote, apply_promoted_to_agent	Improvement loop, Philosophy
Fast chat, slow worker	An in-process chat agent dispatching heavy jobs to a compiled worker	Interactive tier, build_interactive_spec, run_interactive, SpawnAgentTool, event sinks	Execution tiers, Interactive tier

New to the framework entirely? Start with installation, then do the triage bot first — it introduces the registry → template → compile flow every other tutorial builds on. The tested source projects for all five live under examples/ in the repository.