Overview

TavusVideoService integrates with Tavus to generate AI-powered video avatars that speak your text-to-speech output in real-time. The service takes audio input and produces synchronized video of a realistic avatar speaking, enabling engaging conversational AI experiences with visual presence.

Installation

To use Tavus services, install the required dependency:
pip install "pipecat-ai[tavus]"

Prerequisites

Tavus Account Setup

Before using Tavus video services, you need:
  1. Tavus Account: Sign up at Tavus Platform
  2. API Key: Generate an API key from your account dashboard
  3. Replica Creation: Create and train voice replicas for your avatars
  4. Avatar Selection: Choose or create avatar models for video generation

Required Environment Variables

  • TAVUS_API_KEY: Your Tavus API key for authentication
  • TAVUS_REPLICA_ID: ID of your trained voice replica