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.

Installation

To use TavusTransport, install the required dependencies:
pip install "pipecat-ai[tavus]"

Prerequisites

Tavus Platform Setup

Before using TavusTransport, you need:
  1. Tavus Account: Sign up at Tavus.io
  2. API Key: Generate a Tavus API key for authentication
  3. Replica ID: Create or obtain a Tavus replica model ID
  4. 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 authentication
  • TAVUS_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