> ## 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.

# Examples

> Complete working examples for Pipecat Subagents.

All examples are available in the [pipecat-subagents repository](https://github.com/pipecat-ai/pipecat-subagents/tree/main/examples).

## Local examples

These examples run all agents in a single process using the default `AsyncQueueBus`.

<CardGroup cols={2}>
  <Card title="Single Agent" icon="user" href="https://github.com/pipecat-ai/pipecat-subagents/tree/main/examples/local/agent-handoff/single_agent.py">
    The simplest use case: one `BaseAgent` running a complete voice pipeline through the `AgentRunner`. No bus bridge, no multi-agent coordination.
  </Card>

  <Card title="Two LLM Agents" icon="arrows-repeat" href="https://github.com/pipecat-ai/pipecat-subagents/tree/main/examples/local/agent-handoff/two_llm_agents.py">
    A greeter and a support agent that transfer control between each other. Demonstrates agent handoff with `handoff_to()` and the `@tool` decorator.
  </Card>

  <Card title="Two LLM Agents with TTS" icon="microphone" href="https://github.com/pipecat-ai/pipecat-subagents/tree/main/examples/local/agent-handoff/two_llm_agents_with_tts.py">
    Same as above, but each agent has its own TTS with a distinct voice. The main agent has no TTS -- audio comes from the active LLM agent through the bus.
  </Card>

  <Card title="LLM + Flows Agent" icon="diagram-project" href="https://github.com/pipecat-ai/pipecat-subagents/tree/main/examples/local/agent-handoff/llm_and_flows_agent.py">
    An LLM router agent combined with a `FlowsAgent` for structured restaurant reservations. Demonstrates mixing agent types.
  </Card>

  <Card title="Parallel Debate" icon="comments" href="https://github.com/pipecat-ai/pipecat-subagents/tree/main/examples/local/parallel-debate/parallel_debate.py">
    A moderator spawns three worker agents in parallel using `task_group()`. Each worker argues from a different perspective. Demonstrates task coordination.
  </Card>

  <Card title="Voice Code Assistant" icon="code" href="https://github.com/pipecat-ai/pipecat-subagents/tree/main/examples/local/code-assistant">
    A voice agent backed by a code worker that uses Claude Agent SDK with tools (Read, Bash, Glob, Grep) to answer coding questions. Demonstrates task-based agent integration.
  </Card>
</CardGroup>

## Distributed examples

These examples run agents across separate processes or machines, communicating via Redis or WebSocket.

<CardGroup cols={2}>
  <Card title="Redis Handoff" icon="server" href="https://github.com/pipecat-ai/pipecat-subagents/tree/main/examples/distributed/redis-handoff">
    The two-agent handoff split across separate processes using `RedisBus`. The main transport agent runs independently from the LLM agents.
  </Card>

  <Card title="Remote Proxy Assistant" icon="globe" href="https://github.com/pipecat-ai/pipecat-subagents/tree/main/examples/distributed/remote-proxy-assistant">
    A main agent connects to a remote LLM server over WebSocket using proxy agents. Demonstrates point-to-point distributed deployment.
  </Card>
</CardGroup>
