Top AI Repos — open-source AI, indexed and scored
Top AI Repos tracks AI repositories on GitHub and answers two different questions about each one: is it moving right now, and would you bet a product on it.
Top AI Repos tracks AI repositories on GitHub and answers two different questions about each one: is it moving right now, and would you bet a product on it.
Reliable Multi-Agent Orchestration Framework
| Date | Stars |
|---|---|
| 2026-07-31 | 4505 |
| 2026-08-02 | 4512 |
| 2026-08-06 | 4512 |
Today
— stars today
This week
— stars this week
This month
— stars this month
Momentum
35.0
growth rate 0.00%/day
# 🐝 Agency Swarm
.jpg?alt=media&token=8c681331-2a7a-4a69-b21b-3ab1f9bf1a23)
## Overview
The **Agency Swarm** is a framework for building multi-agent applications. It leverages and extends the [OpenAI Agents SDK](https://github.com/openai/openai-agents-python), providing specialized features for creating, orchestrating, and managing collaborative swarms of AI agents.
This framework continues the original vision of Arsenii Shatokhin (aka VRSEN) to simplify the creation of AI agencies by thinking about automation in terms of real-world organizational structures, making it intuitive for both agents and users.
**Migrating from v0.x?** Please see our [Migration Guide](https://agency-swarm.ai/migration/guide) for details on adapting your project to this new SDK-based version.
[](https://agency-swarm.ai)
[](https://github.com/VRSEN/agency-swarm/actions?query=branch%3Amain+event%3Apush)
[](https://youtube.com/@vrsen/)
[](https://twitter.com/__vrsen__)
[](https://discord.gg/cw2xBaWfFM)
[](https://agents.vrsen.ai)
### Key Features
- **Customizable Agent Roles**: Define distinct agent roles (e.g., CEO, Virtual Assistant, Developer) with tailored instructions, tools, and capabilities within the Agency Swarm framework, leveraging the underlying OpenAI Agents SDK.
- **Full Control Over Prompts/Instructions**: Maintain complete control over each agent’s guiding prompts (instructions) for precise behavior customization.
- **Type-Safe Tools**: Develop tools using Pydantic models for automatic argument validation, compatible with the OpenAI Agents SDK’s `FunctionTool` format.
- **Orchestrated Agent Communication**: Agents communicate via a dedicated `send_message` tool, with interactions governed by explicit, directional `communication_flows` defined on the `Agency`.
- **Flexible State Persistence**: Manage conversation history by providing `load_threads_callback` and `save_threads_callback` to the `Agency`, enabling persistence across sessions (e.g., DB/file storage).
- **Multi-Agent Orchestration**: Build agent workflows on the OpenAI Agents SDK foundation, enhanced by Agency Swarm’s structured orchestration layer.
- **Production-Ready Focus**: Built for reliability and designed for easy deployment in real-world environments.
## Installation
```bash
pip install -U agency-swarm
```
> **v1.x note:** The framework targets the OpenAI Agents SDK + Responses API.
> Migrating from v0.x? See the [Migration Guide](https://agency-swarm.ai/migration/guide).
### Compatibility
- **Python**: 3.12+
- **Model backends:**
- **OpenAI (native):** GPT-5 family, GPT-4o, etc.
- **Via LiteLLM (router):** Anthropic (Claude), Google (Gemini), Grok (xAI), Azure OpenAI, **OpenRouter (gateway)**, etc.
- **OS**: macOS, Linux, Windows
If you hit environment issues, see the [Installation guide](https://agency-swarm.ai/welcome/installation).
## Getting Started
> **Recommended**: Start with the [Agency Starter Template](https://github.com/agency-ai-solutions/agency-starter-template) before you customize anything.
1. **Set Your OpenAI Key**:
- Create a `.env` file with `OPENAI_API_KEY=your_key` (auto-loaded), or export it in your shell:
```bash
export OPENAI_API_KEY="YOUR_API_KEY"
```
2. **Create Tools**:
Define tools using the modern Excerpt of 10,732 characters
Read on GitHub
Nick Bobrowski · @VRSEN · Portugal
1.6k
Arseny Shatokhin
476
Artemii
441
32
28
Mykhailo · https://www.upwork.com/freelancers/mishareactsuperstar · Ukraine
9
8
5
5
3
3
Rin · Vietnam
2
2
1
1
Ryan
1
1
1
Syed Osama Ali Shah · Attimo · United Kingdom
1
1
Would you bet a product on this? Bounded 0–100 and slow moving.
matched fp:673ec2d164e31d88, desc:multi-agent, desc:multi agent, desc:agent orchestration