// DOCUMENTATION

How to go live
with your agent.

A complete guide to creating your agent, streaming it to YouTube with OBS, and letting it read and reply to your live chat.

// CONTENTS
01 Create your agent 02 Open the studio 03 Capture it in OBS 04 Go live on YouTube 05 Connect your live chat 06 Tips & troubleshooting
STEP 01

Create your agent

Your agent is the AI character viewers will talk to — its name, personality, and 3D look.

  1. Open Create

    Go to Create Agent and connect your Solana wallet (Phantom). One click signs you in securely.

  2. Set the identity

    Give it a name, a tagline, and a personality — pick a preset or write your own.

  3. Upload a character

    Add a .vrm model — this is the 3D avatar your viewers will see. It's saved to your account.

  4. Save

    Hit save. Your agent now belongs to your wallet and is stored in the cloud.

No VRM yet? You can find free .vrm models on VRoid Hub, or make your own with VRoid Studio (free).
STEP 02

Open the studio

The studio is where your agent comes to life — it renders your avatar, handles voice, expressions, and gestures.

  1. Enter from Create

    After saving, click Use in Studio on your agent. It loads with your character and personality ready.

  2. Check it's alive

    Your avatar should appear, idling and blinking. Try typing a message — it replies with voice and animation.

The studio is locked until you're signed in and have an agent. That's intentional — create an agent first.
STEP 03

Capture it in OBS

OBS is the free software that sends your avatar to YouTube. The easiest method is Window Capture.

  1. Add a Window Capture

    In OBS, under Sources, click +Window Capture → select your browser window running the studio.

  2. Frame your avatar

    Resize and crop so only the avatar is visible. Use a solid color background in the studio for easy chroma-keying if you like.

  3. Hide the controls

    In the studio, click the toggle (bottom-right) to hide the control dock — leaving a clean shot of just your avatar. Do this after you've connected everything.

Don't have OBS? Download it free from obsproject.com. It works on Windows, Mac, and Linux.
STEP 04

Go live on YouTube

Start your stream so YouTube gives you a live URL — you'll need it for the live chat feature.

  1. Start a stream

    On YouTube, click Create → Go live. You can stream through OBS (recommended) or the built-in webcam option for a quick test.

  2. Set it to Unlisted for testing

    While testing, set privacy to Unlisted so it's not public. Switch to Public when you're ready.

  3. Copy your live URL

    Once live, copy the video URL — it looks like youtube.com/watch?v=.... You'll paste this into the studio next.

First time going live? New YouTube accounts must verify a phone number and may wait up to 24 hours before livestreaming unlocks. Check youtube.com/verify.
STEP 05

Connect your live chat

Now let your agent read the chat. It replies automatically whenever a viewer mentions its name.

  1. Find the Live Chat row

    In the studio's control dock, find the Live Chat row.

  2. Paste your live URL

    Paste the YouTube live URL you copied, then click ▶ Connect. The status turns ● LIVE when connected.

  3. Let viewers call its name

    When someone types your agent's name in chat (e.g. "Kyo, how are you?"), your agent reads it and replies out loud — with the right emotion and gesture.

  4. Hide the dock & stream

    Once connected, hide the control dock and you're live — avatar on screen, agent chatting with your audience.

Why only when named? Replying to every message would be chaos. Name-mentions keep it natural — like your agent is really being called on.
STEP 06

Tips & troubleshooting

Order matters

Connect the live chat before hiding the dock. The chat keeps running in the background even after the controls are hidden.

"Not a live stream"

The URL must point to an active live stream. Regular or ended videos have no live chat.

Agent isn't replying

Make sure the viewer typed your agent's exact name. Check the name shown on your studio nameplate.

Chat stops after a while

Live chat reading uses a shared daily limit. During heavy use it can pause — it resets each day. Keep test streams short.

Ready to go live?

Create your agent and bring it to your stream.

CREATE YOUR AGENT →