// DOCUMENTATION

From empty wallet
to live character.

An agent is a name, a personality and a model. This is how you build one, put it on screen, and let it answer the people watching — the short way through Pons, or the long way through OBS + YouTube.

Pick a path. Pons is the short one — share a tab from the browser, no encoder. OBS + YouTube is the long one, and it buys you scenes, chroma and overlays. Steps 01–02 are common to both.
// CONTENTS
01 Define the character 02 Open the studio 03 Broadcast to Pons — short path 04 Capture it in OBS 05 Go live on YouTube 06 Wire up live chat 07 Fixed: common breakage
STEP 01

Define the character

Three things make an agent: a name, a personality, and a model. Everything else in the studio is staging.

  1. Connect

    Go to Create Agent and connect your wallet. One signature on Robinhood Chain — no password, no email, no account to rent.

  2. Set the identity

    Name it, give it a tagline, pick a personality. Six presets are there; if none of them fit, write the personality yourself.

  3. Give it a body

    Add a .vrm — your own file, or one from the gallery. Any rigged humanoid VRM will drive.

  4. Save

    Hit save. The agent is written to this browser and tagged with your wallet address — no account, no upload, and nothing sitting on someone else's server.

No .vrm on hand? VRoid Studio exports them for free, and VRoid Hub has a deep library of downloadable models.
STEP 02

Open the studio

The studio is the runtime's front end. It renders the model, drives the voice, fires expressions and gestures, and holds the broadcast controls.

  1. Enter from Create

    After saving, click Use in Studio on the agent. Character and personality come with you — nothing to re-enter.

  2. Confirm it's alive

    The avatar should load idling and blinking, not frozen in a T-pose. Type one line and watch for the reply — voice plus lip movement.

The studio is locked until you're signed in and at least one agent exists. That's deliberate — it has nothing to render otherwise.
STEP 03

Broadcast to Pons // short path

Pons is the Robinhood-chain launchpad, and its livestream runs entirely in the browser. No encoder, no scene file — you share the tab your character is already living in.

  1. Have an agent that loads

    Steps 01–02. If the character doesn't appear in the studio yet, fix that first — this path renders whatever the browser renders.

  2. Open your token on Pons

    On your token's page at ponsfamily.com, open Livestream.

  3. Broadcast mode → Webcam

    In the platform's broadcast mode, pick the Webcam / screen option.

  4. Click Share Screen

    Select the browser tab running your character — not the whole desktop. Sharing one tab keeps the rest of your work off stream.

  5. You're live

    Your avatar is on the stream, talking, emoting, and ready to answer chat. Nothing was installed to make that happen.

Why it's shorter: the whole broadcast stays in the browser. If you want finer control — scenes, chroma-key, overlays — take the OBS route below instead.
Chat is a separate step. Broadcasting the picture doesn't connect the chat — that's the studio's Pons row. See Step 06.
STEP 04

Capture it in OBS

The long path. Worth it when you want scenes, chroma and overlays — or when you're going to YouTube.

  1. Add a Window Capture

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

  2. Frame the avatar

    Resize and crop until only the character is in shot. A solid background in the studio makes chroma-keying trivial.

  3. Hide the dock

    Click the toggle (bottom-right) to drop the control dock and leave a clean frame. Do this after chat is connected, not before.

Don't have OBS? It's free at obsproject.com — Windows, macOS and Linux.
STEP 05

Go live on YouTube

Go live first, then read the URL off the stream — the chat reader needs it to find the room.

  1. Start a stream

    On YouTube, Create → Go live. Through OBS is the recommended route; the built-in webcam option is fine for a quick test.

  2. Set it to Unlisted while testing

    Keep the test off the public feed until the character behaves. Flip it to Public when you're ready for people.

  3. Copy the live URL

    Once live, copy the video URL — it looks like youtube.com/watch?v=.... That string goes into the studio next.

First time going live? New YouTube accounts need a verified phone number, and livestreaming can take up to 24 hours to unlock. Check youtube.com/verify.
STEP 06

Wire up live chat

The studio has one row per source. Fill in the one you're streaming on — each row connects the character to that platform's chat.

What you paste depends on the platform:
YouTube → the live video link (youtube.com/watch?v=...)
Pons → your token's Contract Address (on the Robinhood chain)
Each one opens the conversation on that platform. They are not interchangeable.

Pons chat — paste the contract address

  1. Find the Pons row

    In the studio's control dock, find the Pons row.

  2. Paste the Contract Address

    Copy your token's CA from Pons, paste it into the row, hit ▶ Connect. That address is what links the character to your token's chat — a YouTube link will not work here.

  3. It answers the room

    The character reads incoming messages and replies out loud like a streamer, with matching expression and gesture. It skips messages while it's still speaking, so replies never pile up.

YouTube chat — paste the live link

  1. Find the Live Chat row

    In the control dock, find the Live Chat row.

  2. Paste the live URL

    Paste the YouTube link you copied, hit ▶ Connect. The status flips to ● LIVE once it's actually reading.

  3. Viewers have to call its name

    On YouTube, a message only reaches the character if it contains the agent's name — e.g. "Kyo, how are you?". On Pons it answers everyone.

Connect chat, then hide the dock. Hiding the dock doesn't stop the reader — it keeps running behind the clean frame.
STEP 07

Fixed: common breakage

Nothing is happening on Pons

Pons is the fastest path precisely because it skips OBS entirely — Livestream → Broadcast mode → Webcam → Share Screen, pointed at the character's tab. If the share looks wrong, you probably picked the desktop instead of the tab.

Pons chat won't connect

Check the contract address is the full address, copied whole. Pons chat is unofficial — if it stops working one day, Pons changed something on their side, not yours.

Order of operations

Connect chat before hiding the dock. The reader keeps running afterwards; it just needs to be started while the controls are still on screen.

YouTube says "not a live stream"

The URL has to point at an active stream. A regular upload or an ended stream has no live chat to read.

The agent ignores people (YouTube)

On YouTube the viewer must type the agent's exact name. Check the spelling on the studio nameplate — it has to match character for character. On Pons, that rule doesn't apply.

Chat goes quiet after a while

Chat reading runs on a shared daily allowance. Under heavy use it pauses, then resets the next day. Keep test streams short.

That's the whole loop.

Build the character, load it, put it on stream.

BUILD A CHARACTER →