Interactive Avatar: Quickstarts

Runnable recipes for Synthesia Interactive Avatars: photoreal, lip-synced avatars you can talk to in your browser.

Each recipe is self-contained — its own README, dependencies, and .env.example — so you can copy a directory out and build on it directly.

RecipeWhat it shows
minimalThe smallest useful app: a Python LiveKit voice agent (STT → LLM → TTS) with the avatar integration in three lines. Start here.
ragA LiveKit agent grounded in a knowledge base (public Wikipedia out of the box, AWS Bedrock for your own corpus) — it speaks only from retrieved source material.
toolsAn avatar that acts, not just talks: LLM function tools fill a booking form in the browser live, and your edits flow back — tool calling + UI state sync over LiveKit data channels.

Prerequisites

You need two things before you start:

  1. A Synthesia API key with Interactive Avatar access. This authenticates you to the Interactive Avatar API.

  2. The Synthesia plugin, installed via pip:

   pip install livekit-plugins-synthesia

Each recipe's README lists everything else it needs on top of these — providers, keys, and how to run it.