Skip to main content

​
Overview

AvatarSession is an Agent Human plugin for LiveKit Agents. Drop it into your agent entrypoint and your agent’s voice output will be rendered as a talking avatar video in the LiveKit room — no manual session or token management required. The avatar reports to your agent when it actually starts and stops speaking each reply. When the user interrupts, it stops within about a second and your agent keeps only the part of the reply the user heard.
We are currently in the application process to be listed on the LiveKit framework GitHub repository. Until the plugin is published, install it from our fork (see below).

​
Installation

Once the plugin is published:
Until then, install it from our fork:

​
Environment Variables

  • AGENTHUMAN_API_KEY: Your Agent Human API key
  • AGENTHUMAN_AVATAR_ID: Avatar ID to use when no avatar_id / avatar_image_url is passed to AvatarSession (optional: a public stock avatar is used otherwise)
  • AGENTHUMAN_IMAGE_URL: Image URL to use instead of an avatar ID (set only one of the two)
  • LIVEKIT_URL: Your LiveKit server WebSocket URL
  • LIVEKIT_API_KEY: LiveKit API key
  • LIVEKIT_API_SECRET: LiveKit API secret

​
Next Steps

Quick Start

Add AvatarSession to your agent in minutes

Configuration

AvatarSession parameters and options

Examples

Complete agent examples

API Reference

Underlying session API