Skip to main content
New to Pipecat Subagents? Check out the introduction and quickstart first.
Pipecat Subagents is a multi-agent framework for Pipecat that lets you build AI applications with multiple coordinated agents. Agents communicate through a shared bus, can hand off to each other, and coordinate work through structured task protocols.

​
Installation

pip install pipecat-ai-subagents
Optional extras for specific features: 
# Pipecat Flows integration
pip install "pipecat-ai-subagents[flows]"

# Redis distributed bus
pip install "pipecat-ai-subagents[redis]"

# WebSocket proxy agents
pip install "pipecat-ai-subagents[websocket]"

​
Reference Pages

​
Agents

BaseAgent

Core agent class with lifecycle, bus communication, and task coordination

LLMAgent

Agent with LLM pipeline and automatic tool registration

FlowsAgent

Agent with Pipecat Flows integration for structured conversations

​
Infrastructure

AgentRunner

Lifecycle orchestrator for multi-agent systems

Bus

Bus infrastructure for inter-agent messaging

Messages

All bus message types for agent communication

​
Decorators & Types

Decorators

@tool, @task, and @agent_ready decorators

Types

Shared types, enums, and data classes

Exceptions

Error types for task coordination

​
Distributed

Proxy Agents

WebSocket proxy agents for distributed deployments

Serializers

Message serialization for network transport

​
Agent Type Hierarchy

ClassParentDescription
BaseAgent-Core agent with lifecycle, bus, and task coordination
LLMAgentBaseAgentAdds LLM pipeline and @tool registration
FlowsAgentBaseAgentAdds Pipecat Flows integration
WebSocketProxyClientAgentBaseAgentForwards bus messages to a remote server
WebSocketProxyServerAgentBaseAgentReceives bus messages from a remote client