Overview
TavusTransport enables your Pipecat bot to join the same virtual room as a Tavus avatar and human participants. The transport integrates with the Tavus platform to create conversational AI applications where a Tavus avatar provides synchronized video and audio output while your bot handles the conversation logic. When used, the Pipecat bot connects to a Daily room alongside the Tavus avatar and user. The bot receives audio input from participants, processes it through your pipeline, and sends TTS audio to the Tavus avatar for synchronized video rendering.Tavus Transport API Reference
Pipecat’s API methods for Tavus platform integration
Example Implementation
Complete Tavus avatar conversation example
Tavus API Documentation
Tavus official API reference and replica creation
Client SDK Integration
Connect using Pipecat Client SDK with Daily transport
Installation
To use TavusTransport, install the required dependencies:Prerequisites
Tavus Platform Setup
Before using TavusTransport, you need:- Tavus Account: Sign up at Tavus.io
- API Key: Generate a Tavus API key for authentication
- Replica ID: Create or obtain a Tavus replica model ID
- Persona Configuration: Set up a persona (optional, defaults to Pipecat TTS voice)
Use
persona_id="pipecat-stream"
to have Tavus use your Pipecat bot’s TTS
voice instead of a Tavus persona voice.Required Environment Variables
TAVUS_API_KEY
: Your Tavus API key for authenticationTAVUS_REPLICA_ID
: ID of the Tavus replica model to use
Key Features
- Avatar Integration: Seamlessly integrates Tavus avatars with Pipecat conversations
- Synchronized Audio/Video: Tavus avatar renders video synchronized with bot’s TTS output
- Multi-participant Rooms: Supports bot, avatar, and human participants in the same session
- Conversation Management: Handles Tavus conversation lifecycle through API
- Real-time Streaming: Bidirectional audio streaming with video avatar output
Usage
TavusTransport creates a three-way conversation between your Pipecat bot, a Tavus avatar, and human participants. The transport manages the Tavus API integration and Daily room connectivity automatically. See the complete example for a full implementation including:- Tavus transport configuration
- Avatar and replica setup
- Pipeline integration with TTS
- Event handling for participant management