> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.synthesia.io/docs/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.synthesia.io/docs/_mcp/server.

# Interactive Avatar: Quickstarts

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

| Recipe                                            | What it shows                                                                                                                                                         |
| ------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [minimal](/docs/interactive-avatar-minimal-quickstart) | The smallest useful app: a Python LiveKit voice agent (STT → LLM → TTS) with the avatar integration in three lines. Start here.                                       |
| [rag](/docs/interactive-avatar-rag-quickstart)         | A 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.       |
| [tools](/docs/interactive-avatar-tools-quickstart)     | LLM uses tools to fill a booking form in the browser as you speak, and your edits flow back to the agent: tool calling plus UI state sync over LiveKit data channels. |

## Prerequisites

You need two things before you start:

1. **A Synthesia API key** with [Interactive Avatar access](https://www.synthesia.io/features/avatars/interactive-avatars). This authenticates you to the Interactive Avatar API.

2. **The Synthesia plugin**, installed via pip:

```bash
   pip install "livekit-plugins-synthesia~=1.8"
```

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