Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.agenthuman.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

AgentHumanVideoService is a Pipecat AIService that slots into your pipeline right after your TTS service. It receives TTS audio frames, sends them to the AgentHuman avatar via a LiveKit data stream, and injects the avatar’s video and audio frames back into the pipeline for your output transport to publish.
We are currently in the application process to be listed on the Pipecat framework GitHub repository.
Perfect for:
  • Voice AI applications with a visual presenter
  • Conversational agents with animated avatars
  • Real-time speech-driven video generation
  • Interactive AI assistants

​
How It Works

User mic → Transport input → STT → LLM → TTS → AgentHumanVideoService → Transport output
                                                       ↑                        ↑
                                             Sends audio to avatar    Receives avatar video
AgentHumanVideoService handles everything internally:
  1. Creates an AgentHuman session via the REST API on startup
  2. Connects to the returned LiveKit room
  3. Resamples TTS audio to 16 kHz mono and streams it to the avatar
  4. Forwards the avatar’s video and audio frames downstream to your transport

​
Installation

pip install pipecat-ai[agenthuman]
The integration lives in pipecat.services.agenthuman: import AgentHumanVideoService from pipecat.services.agenthuman.video and NewSessionRequest from pipecat.services.agenthuman.api.
The agenthuman extra installs the LiveKit SDK (livekit) required for the avatar data stream. The Examples use additional Pipecat extras (daily, deepgram, elevenlabs, google, and python-dotenv) — install those alongside agenthuman when you run the full bot.

​
Environment Variables

VariableDescription
AGENTHUMAN_API_KEYYour AgentHuman API key

​
Next Steps

Quick Start

Add AgentHumanVideoService to your pipeline in minutes

Configuration

All parameters and transport requirements

Examples

Complete working bot examples

API Reference

Underlying session API