Skip to main content

​
Overview

HeyGenTransport enables your Pipecat bot to join the same virtual room as a HeyGen avatar and human participants. The transport integrates with the HeyGen LiveAvatar platform to create interactive AI-powered video avatars that respond naturally in real-time conversations. The service handles bidirectional audio/video streaming, avatar animations, voice activity detection, and conversation interruptions to deliver engaging conversational AI experiences with lifelike visual presence. When used, the Pipecat bot connects to a LiveKit room alongside the HeyGen avatar and user. The bot receives audio input from participants, processes it through your pipeline, and sends TTS audio to the HeyGen avatar for synchronized video rendering.

HeyGen Trasnport API Reference

Pipecat’s API methods for HeyGen video integration

Example Implementation

Complete example with interactive avatar

HeyGen Documentation

Official HeyGen API documentation and guides

HeyGen Platform

Access interactive avatars and API keys

​
Installation

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

​
Prerequisites

​
HeyGen Account Setup

Before using HeyGen video services, you need:
  1. HeyGen Account: Sign up at HeyGen Platform
  2. API Key: Generate an API key from your account dashboard
  3. Avatar Selection: Choose from available interactive avatars
  4. Streaming Setup: Configure real-time avatar streaming capabilities

​
Required Environment Variables

  • HEYGEN_LIVE_AVATAR_API_KEY: Your HeyGen LiveAvatar API key for authentication