> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pipecat.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Pipecat Subagents

> A distributed multi-agent framework for building coordinated AI systems with Pipecat.

Pipecat Subagents is a distributed multi-agent framework for [Pipecat](/pipecat/get-started/introduction). Each agent runs its own pipeline and communicates with other agents through a shared message bus. The programming model stays the same whether agents run locally in a single process or distributed across machines.

<Card title="Quickstart" icon="rocket" href="/subagents/quickstart">
  Build a multi-agent voice bot with agent handoff in under 10 minutes
</Card>

## What You Can Build

<CardGroup cols={3}>
  <Card title="Agent Handoff" icon="arrows-repeat">
    Specialized agents that transfer control seamlessly during a conversation.
  </Card>

  {" "}

  <Card title="Parallel Workers" icon="users">
    Dispatch work to multiple agents in parallel and collect their results.
  </Card>

  {" "}

  <Card title="Mixed Agent Types" icon="diagram-project">
    Combine free-form LLM agents with structured Flows agents in the same system.
  </Card>

  {" "}

  <Card title="Custom Voices" icon="microphone">
    Give each agent its own TTS voice so users hear a different voice when
    transferred to a different agent.
  </Card>

  {" "}

  <Card title="Distributed Agents" icon="server">
    Run agents across separate processes or machines, sharing the same bus and
    scaling each independently.
  </Card>

  <Card title="Proxy Agents" icon="globe">
    Connect agents on different buses for point-to-point communication.
  </Card>
</CardGroup>

## Installation

```bash theme={null}
uv add pipecat-ai-subagents
```

Optional extras:

```bash theme={null}
uv add "pipecat-ai-subagents[flows]"      # Pipecat Flows integration
uv add "pipecat-ai-subagents[redis]"       # Redis bus for distributed setups
uv add "pipecat-ai-subagents[websocket]"   # WebSocket proxy agents
```

Requires Python 3.11+ and `pipecat-ai`.

## Next Steps

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/subagents/quickstart">
    Build a multi-agent voice bot with agent handoff
  </Card>

  <Card title="Learn the Concepts" icon="book-open" href="/subagents/learn/overview">
    Walk through agents, the bus, handoff, and task coordination step by step
  </Card>

  <Card title="Fundamentals" icon="wrench" href="/subagents/fundamentals/understanding-the-bus-bridge">
    Deep dives into the bus bridge, tools, Flows, distributed setups, and more
  </Card>

  <Card title="Examples" icon="code" href="/subagents/examples/overview">
    Complete working examples for every pattern
  </Card>
</CardGroup>