Thanks — I understand you're trying to show the Beyond Presence ("bey") avatar in your Next.js app and it's not rendering even though you followed the docs. I’ll help you narrow down where it might be failing and what to check next. First, quick checklist of the most common causes and what to verify: • Backend: Confirm

bey.AvatarSession

is created and started before the

AgentSession

. The avatar must join the room as a separate participant for a video track to be published. ◦ Verify your code calls

avatar.start(session, room=...)

(or equivalent) and that it completes without exception. ◦ Ensure your

BEY_API_KEY

is set and valid in the environment where the backend runs. • Frontend: Confirm you’re using the

useVoiceAssistant()

hook (from

@livekit/components-react

) or otherwise subscribing to the avatar worker’s video track. ◦

useVoiceAssistant()

exposes

videoTrack

and `audioTrack`; if

videoTrack

is null, the avatar worker either didn’t join or didn’t publish video. ◦ Make sure your component attaches the track to a <video> element (autoplay, playsInline, muted for preview). • Room participants: The avatar appears as a separate participant (kind: Agent) with attributes like

lk.publish_on_behalf

. If that participant is missing, the avatar session didn’t start. • Errors & fallbacks: Avatar failures fall back to audio-only rather than crash the agent. Check backend logs for exceptions such as

BeyException

or authentication/connectivity errors when starting the avatar session. If you want me to pinpoint the issue, please share any of the following (the more, the faster I can diagnose): 1. Backend logs around the time you start the agent/ avatar (any errors or stack traces). 2. The backend snippet that creates/starts

bey.AvatarSession

and the

AgentSession

. 3. The frontend snippet where you render the agent (how you use

useVoiceAssistant()

or subscribe to tracks). 4. Output from the frontend: Does

useVoiceAssistant()

return

videoTrack

as null or undefined? 5. A console log of room participants (e.g.,

room.participants.forEach(...)

) — do you see the avatar participant? 6. Environment details: running locally, Agents Playground, or deployed; and the version of

@livekit/components-react

. If you prefer, paste the small backend and frontend snippets and I’ll point out exactly what to change. Sources: Beyond Presence virtual avatar integration guide | LiveKit Documentation | Virtual avatar models overview | LiveKit Documentation | examples/avatar_agents | livekit/livekit_composite | DeepWiki | Web and mobile frontends | LiveKit Documentation