picoagents
Teach the building blocks of production multi-agent systems through small, testable primitives.
Description
Minimal multi-agent framework published as companion code for Victor Dibia's book Designing Multi-Agent Systems (O'Reilly 2025). Pedagogic in scope but published on PyPI and actively maintained; demonstrates composable termination conditions, a pre/post/error middleware chain, and first-class interruptibility (cancellation + external signals) as separately-tested primitives.
Solution
An imperative async agent loop assembled from small, separately-tested primitives: each step passes through a pre/post/error middleware chain, the loop keeps running until a composable termination condition fires, and execution stays interruptible throughout via cancellation tokens and external signals. Multi-agent work is coordinated by actor-style message passing between independently-addressable agents.
Primary use cases
- Book companion code for working through multi-agent design exercises
- Reference implementation of composable termination and middleware contracts
Open the full interactive page →
Diagram, neighbourhood map, code examples, related patterns and full provenance.