Livekit Integration - TruGen AI Documentation

Give a face to your LiveKit agents with TruGen Avatars, using our official LiveKit Agents plugin.

Python
JavaScript

Install the plugin

Install the TruGen plugin from the LiveKit registry:

uv add "livekit-agents[trugen]~=1.3" # When using UV

pip install "livekit-agents[trugen]~=1.3" # When using PIP

Generate an API key

Using the TruGen Developer Platform, generate an API key from the developers page.
Set the newly generated API key as TRUGEN_API_KEY environment variable in your .env file.

Add Avatar session to your LiveKit Agent

Import the trugen plugin from livekit.plugins:

from livekit.plugins import trugen

Instantiate a new AvatarSession and set the avatar ID:

avatar_id = os.getenv("TRUGEN_AVATAR_ID") or "45e3f732"
trugen_avatar = trugen.AvatarSession(avatar_id=avatar_id)

Start the avatar session, passing the current agent session and room context:

await trugen_avatar.start(session, room=ctx.room)

Complete Example

from livekit.plugins import trugen

async def entrypoint(ctx: JobContext):
    session = AgentSession(
      # Your existing configuration
    )

    avatar_id = os.getenv("TRUGEN_AVATAR_ID") or "45e3f732"
    trugen_avatar = trugen.AvatarSession(avatar_id=avatar_id)
    await trugen_avatar.start(session, room=ctx.room)

    await session.start(
      # Start agent session as usual
    )

To gracefully shut down, use ctx.room.disconnect() to close the room connection or ctx.shutdown() to end the JobContext.

TruGen automatically stops the session when the room is disconnected or the primary participant disconnects.

Install the plugin

npm

npm install @livekit/agents-plugin-trugen

pnpm

pnpm add @livekit/agents-plugin-trugen

Set up environment variables

Add the following to your .env file:

.env

TRUGEN_API_KEY=your-trugen-api-key
TRUGEN_AVATAR_ID=your-avatar-id

LIVEKIT_URL=your-livekit-url
LIVEKIT_API_KEY=your-livekit-api-key
LIVEKIT_API_SECRET=your-livekit-api-secret

Add Avatar session to your LiveKit Agent

import { AvatarSession } from '@livekit/agents-plugin-trugen';

const avatarSession = new AvatarSession({
  avatarId: process.env.TRUGEN_AVATAR_ID,
  apiKey: process.env.TRUGEN_API_KEY,
});

await avatarSession.start(agentSession, room, {
  livekitUrl: process.env.LIVEKIT_URL,
  livekitApiKey: process.env.LIVEKIT_API_KEY,
  livekitApiSecret: process.env.LIVEKIT_API_SECRET,
});

import { AvatarSession } from '@livekit/agents-plugin-trugen';

const avatarSession = new AvatarSession({
  avatarId: process.env.TRUGEN_AVATAR_ID,
  apiKey: process.env.TRUGEN_API_KEY,
});

await avatarSession.start(agentSession, room, {
  livekitUrl: process.env.LIVEKIT_URL,
  livekitApiKey: process.env.LIVEKIT_API_KEY,
  livekitApiSecret: process.env.LIVEKIT_API_SECRET,
});

Option	Required	Default	Description
`apiKey`	Yes	—	Your TruGen API key
`avatarId`	No	Stock avatar	The avatar ID to use
`apiUrl`	No	`https://api.trugen.ai`	TruGen API base URL
`avatarParticipantIdentity`	No	`trugen-avatar`	LiveKit participant identity
`avatarParticipantName`	No	`Trugen Avatar`	Display name in the room
`connOptions`	No	—	Connection retry configuration

More Resources

Available Avatars

Explore the full list of ready-to-use avatars.

TruGen Examples

Official GitHub examples for LiveKit + TruGen.

LiveKit Plugin Examples

Explore LiveKit Agent plugin examples.

LiveKit Documentation

Explore the full LiveKit documentation.

​Complete Example

​More Resources

Available Avatars

TruGen Examples

LiveKit Plugin Examples

LiveKit Documentation

Complete Example

More Resources