> ## 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.

# Pipecat Integration

> Add a talking avatar to any Pipecat voice AI pipeline with AgentHuman

## 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.

<Warning>
  We are currently in the application process to be listed on the Pipecat framework GitHub repository.
</Warning>

**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

```bash theme={null}
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`.

<Note>
  The `agenthuman` extra installs the LiveKit SDK (`livekit`) required for the avatar data stream. The [Examples](/documentation/pipecat/examples) use additional Pipecat extras (`daily`, `deepgram`, `elevenlabs`, `google`, and `python-dotenv`) — install those alongside `agenthuman` when you run the full bot.
</Note>

## Environment Variables

| Variable             | Description             |
| -------------------- | ----------------------- |
| `AGENTHUMAN_API_KEY` | Your AgentHuman API key |

## Next Steps

<CardGroup cols={2}>
  <Card title="Quick Start" icon="bolt" href="/documentation/pipecat/quick-start">
    Add AgentHumanVideoService to your pipeline in minutes
  </Card>

  <Card title="Configuration" icon="sliders" href="/documentation/pipecat/configuration">
    All parameters and transport requirements
  </Card>

  <Card title="Examples" icon="code" href="/documentation/pipecat/examples">
    Complete working bot examples
  </Card>

  <Card title="API Reference" icon="book" href="/api-reference/endpoints/create-session">
    Underlying session API
  </Card>
</CardGroup>