victordibia/designing-multiagent-systems

What is it?

Key features

• 01Builds agents with tools, memory, streaming, and middleware from first principles
• 02Provides workflow and orchestration modules, including round-robin, LLM-driven, and plan-based patterns
• 03Includes a Playwright-based computer-use agent for browser automation
• 04Offers an evaluation framework with LLM-as-judge and reference-based checks
• 05Ships a web UI that auto-discovers agents and workflows
• 06Works with OpenAI, Azure OpenAI, Anthropic, and OpenAI-compatible local endpoints

Use cases

• Learning how multi-agent systems work internally before adopting a larger framework
• Comparing the same agent patterns across PicoAgents, LangGraph, and Google ADK
• Prototyping an orchestrated agent team with a web UI for debugging runs
• Building browser automation agents with a vision-capable model

Quick start

1. 1

   Clone the repository

   git clone https://github.com/victordibia/designing-multiagent-systems.git
2. 2

   Enter the PicoAgents directory

   cd picoagents
3. 3

   Install the package in editable mode

   pip install -e .
4. 4

   Set your OpenAI API key

   export OPENAI_API_KEY="your-api-key-here"

Things to know

• !Requires an OpenAI API key or another LLM provider key to run the examples.
• !Built as a teaching framework, so it is not positioned as a production-ready library.

Topics

FAQ

What is designing-multiagent-systems?

Companion code for the book Designing Multi-Agent Systems, including PicoAgents, a multi-agent framework built from scratch for teaching. This repository accompanies the book Designing Multi-Agent Systems and contains PicoAgents, a multi-agent framework written from scratch so developers can see how agent loops, tool calling, memory, workflows, and orchestration work internally. The code is organized by book chapter, with runnable examples for each topic.

Is designing-multiagent-systems free to use? What license does it have?

designing-multiagent-systems is open source under the Apache-2.0 license. Check the license terms before using it in commercial products.

Is designing-multiagent-systems still maintained?

Updated within 6 months. The last commit to designing-multiagent-systems was on Aug 24, 2026.

What can I use designing-multiagent-systems for?

Learning how multi-agent systems work internally before adopting a larger framework Comparing the same agent patterns across PicoAgents, LangGraph, and Google ADK Prototyping an orchestrated agent team with a web UI for debugging runs Building browser automation agents with a vision-capable model

How do I install designing-multiagent-systems?

Clone the repository: git clone https://github.com/victordibia/designing-multiagent-systems.git Enter the PicoAgents directory: cd picoagents Install the package in editable mode: pip install -e . Set your OpenAI API key: export OPENAI_API_KEY="your-api-key-here"

Where can I get designing-multiagent-systems?

The source code and installation instructions are on GitHub: https://github.com/victordibia/designing-multiagent-systems