> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trugen.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Quickstart
> Get your first AI avatar running in under 5 minutes.
The TruGen API provides a simple interface for implementing digital AI avatars within your web applications. This guide will walk you through the process of setting up a minimal example of an interactive AI avatar. By the end, you'll have a working avatar that can have real-time conversations in your web browser.
## Prerequisites
* A TruGen API key (get one [here](https://app.trugen.ai/api-keys))
* A TruGen Agent ID (create and get one [here](https://app.trugen.ai/teammate-library))
* A modern web browser with microphone access
* A local web server (we'll show you how to start one below)
## Create Your First Avatar
Create a new file called `index.html` and add this basic layout to display the avatar video and session status:
```html theme={null}
Hello TruGen
Chat with your AI Avatar
Your AI avatar will appear below and start automatically
Loading...
```
Add the script that will automatically authenticate and start your session. Add this `
```
Replace `your-api-key-here` and `your-agent-id-here` in the script block with your actual TruGen credentials.
This quickstart puts credentials directly in the browser for simplicity. For production deployments, always keep your API key on the server. See [Usage in Production](/docs/sdks/javascript/production) for the secure approach.
To serve your HTML file, start a local web server in the directory containing `index.html`:
```bash Python theme={null}
python -m http.server 8000
```
```bash Node (npx) theme={null}
npx serve
```
1. Navigate to `http://localhost:8000` (or the port specified by your local server) in your browser.
2. Allow microphone access when prompted.
3. The avatar will load, connect, and start speaking automatically!
## What just happened?
* **Session Token** — Your API key was exchanged for a temporary session token that enables the avatar connection.
* **WebRTC Stream** — The TruGen SDK established a real-time WebRTC video/audio stream with the TruGen server.
* **Voice Interaction** — Your avatar starts listening to your microphone input and automatically responds with natural real-time dialogue and expressions.
## What's Next?
Learn how to secure your API key using server-side session tokens.
Full example with a Node.js backend and clean connect/disconnect flow.
SDK reference for initializing, streaming, and disconnecting.
Listen to connection, speaking, and transcript events in real time.