# Agent Squad Python

Builds Python multi-agent apps on the agent-squad orchestration package.

- Repository: https://github.com/2FastLabs/agent-squad (7796 stars)
- Category: AI and agents
- License: Apache-2.0
- Last updated: 2026-10-08
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add 2FastLabs/agent-squad --skill agent-squad-python -g -a claude-code -y`
Codex: `npx skills add 2FastLabs/agent-squad --skill agent-squad-python -g -a codex -y`
Cursor: `npx skills add 2FastLabs/agent-squad --skill agent-squad-python -g -a cursor -y`
Gemini CLI: `npx skills add 2FastLabs/agent-squad --skill agent-squad-python -g -a gemini-cli -y`

## Description

Use when building or modifying a Python app that uses the agent-squad Python package, async multi-agent orchestration for Python 3.11+: orchestrator, agents (BedrockLLMAgent, AnthropicAgent, OpenAIAgent, SupervisorAgent, GroundedAgent, ChainAgent, and more), classifier routing (Bedrock, Anthropic, OpenAI), storage (in-memory, DynamoDB, SQL/Turso), retrievers (Amazon KB, Dakera), tools (AgentTools, MCPToolProvider), and custom implementations.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# agent-squad Python, assistant guide

Async-first, dependency-optional multi-agent orchestration framework (Python 3.11+). This is a
guide and a map, **not an API reference**. Read exact signatures from the source
(`python/src/agent_squad/`) and the docs site (`docs/src/content/docs/`); this file tells you
*what to use, when, and what to watch out for*.

## When to use what

- **One assistant**, a single `Agent` subclass; no orchestrator needed, call `process_request`
  directly.
- **Several specialists**, multiple agents + an `AgentSquad` orchestrator; the classifier routes
  each turn to the right agent automatically.
- **Answers must not drift from data** (prices, balances, live stock), `GroundedAgent`: a gatherer
  LLM calls tools and sees raw results but never speaks to the user; an isolated presenter LLM
  writes the reply grounded only on curated facts.
- **Fixed pipeline**, `ChainAgent`: routes the output of one agent as the input to the next,
  sequentially.
- **Team coordination**, `SupervisorAgent`: a lead `BedrockLLMAgent` or `AnthropicAgent` delegates
  to a team of sub-agents via an internal tool loop, maintaining shared context. Can itself be
  registered in an `AgentSquad`.
- **External tool servers**, `MCPToolProvider` (requires `agent-squad[mcp]`) connects any number
  of MCP servers (stdio or SSE) and makes their tools available to any agent.

## How to install

All third-party integrations are optional extras, never forced on users who don't need them.

The rest: https://github.com/2FastLabs/agent-squad/blob/HEAD/python/SKILL.md