Trugen AI

# Trugen AI

Build real-time conversational video agents — AI-powered avatars that see, hear, speak, and reason with users in under 1 second of latency.

| | |
|---|---|
| **API Base URL** | `https://api.trugen.ai` |
| **Authentication** | `x-api-key: <your-api-key>` header on all requests |
| **Official Docs** | [docs.trugen.ai](https://docs.trugen.ai/docs/overview) |
| **Developer Portal** | [app.trugen.ai](https://app.trugen.ai) |

## Required Credentials

| Variable | Description | Where to Get |
|----------|-------------|--------------|
| `TRUGEN_API_KEY` | Primary API key for all Trugen API calls (sent as `x-api-key` header) | [Developer Portal](https://app.trugen.ai) |
| `TRUGEN_AVATAR_ID` | (Optional) Default avatar ID for LiveKit integration | [Developer Portal](https://app.trugen.ai) |

> **Security**: Never expose `TRUGEN_API_KEY` in client-side code. For widget/iFrame embeds, use a server-side proxy to keep keys secret. See [references/embedding.md](references/embedding.md) for details.

## Platform Pipeline

| Step | Component | Function |
|------|-----------|----------|
| 1 | **WebRTC** | Bidirectional audio/video streaming |
| 2 | **STT** (Deepgram) | Streaming speech-to-text |
| 3 | **Turn Detection** | Natural conversation boundary detection |
| 4 | **LLM** (OpenAI, Groq, custom) | Contextual response generation |
| 5 | **Knowledge Base** | Grounding answers in your data |
| 6 | **TTS** (ElevenLabs) | Natural, expressive speech synthesis |
| 7 | **Huma-01** | Neural avatar video generation with lip sync & microexpressions |

## Quickstart

1. Create an agent → `POST /v1/ext/agent` — see [references/agents.md](references/agents.md)
2. Embed via iFrame or Widget — see [references/embedding.md](references/embedding.md)

## API Endpoints Overview

| Resource | Endpoints | Reference |
|----------|-----------|-----------|
| **Agents** | Create, Get, List, Update, Delete, Create from Template | [agents.md](references/agents.md) |
| **Knowledge Base** | Cre...