Livekit Integration

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

1. To your existing Livekit agent, import the trugen plugin from livekit.plugins.

from livekit.plugins import trugen

2. Instantiate a new instance of AvatarSession from the trugen plugin and set the avatar id.

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

3. Start the trugen_avatar session using the start method, while 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
    )

4. Gracefully shutdown Livekit agent; use ctx.room.disconnect() to close the room connection or use ctx.shutdown() to end the JobContext.
   This step is ensures that your TruGen Avatar session shuts down correctly. We automatically stop the session when the room is disconnected or when the primary participant is disconnected