Open-source platform for 3D AI agents. Turn text or a photo into a rigged, animated GLB avatar, give it an LLM brain, memory and a wallet, and embed it anywhere with one web component. Remote MCP server, x402 payments, Three.js, browser-native.
JavaScript 3d-generationai-agentsanimationavatardigital-humangenerative-aiglbgltfimage-to-3dllmmcpmcp-servermodel-context-protocolsolanatext-to-3dthreejsweb-componentswebglwebxrx402
<!doctype html>
<!-- data-walk-auto="off": this page runs its own bottom-right avatar widget as
a live demo, so suppress the site's auto-summoned walk companion to avoid
two mascots stacking in the same corner (nav.js honors this attribute). -->
<html lang="en" data-walk-auto="off">
<head>
<script>/* three.ws theme boot — no-flash; runtime in /theme-switcher.js */(function(){try{var m=localStorage.getItem('twx_theme');var l=m==='auto'?(window.matchMedia&&window.matchMedia('(prefers-color-scheme: light)').matches):m==='light';document.documentElement.setAttribute('data-theme',l?'light':'dark');}catch(e){document.documentElement.setAttribute('data-theme','dark');}})();</script>
<style>/* three.ws hidden-guard — make the `hidden` attribute authoritative; see scripts/lib/hidden-guard.mjs */[hidden]{display:none!important}</style>
<meta charset="utf-8" />
<link rel="icon" href="/favicon.ico" sizes="any" />
<link rel="icon" type="image/svg+xml" href="/favicon.svg" />
<link rel="icon" type="image/png" sizes="32x32" href="/favicon-32x32.png" />
<link rel="icon" type="image/png" sizes="16x16" href="/favicon-16x16.png" />
<link rel="apple-touch-icon" href="/apple-touch-icon.png" />
<link rel="manifest" href="/manifest.webmanifest" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<title data-i18n="assistant.meta_title">Assistant widget — three.ws</title>
<meta name="description" content="Put a 3D avatar assistant on any website with one script tag. Chatbot mode (free models or your own Groq/OpenRouter key) and speak mode — the avatar says whatever you type, out loud, with a speech bubble." data-i18n-attr="content:assistant.meta_description"/>
<meta property="og:type" content="website" />
<meta property="og:site_name" content="three.ws" />
<meta property="og:url" content="https://three.ws/assistant" />
<meta property="og:title" content="Assistant widget — three.ws" data-i18n-attr="content:assistant.meta_og_title"/>
<meta property="og:description" content="Put a 3D avatar assistant on any website with one script tag. Chat mode and speak mode, transparent or gradient backgrounds, free models or bring your own key." data-i18n-attr="content:assistant.meta_og_description"/>
<meta property="og:image" content="https://three.ws/api/page-og?s=build&t=Assistant+widget&d=Put+a+3D+avatar+assistant+on+any+website+with+one+script+tag.+A+floating+launcher+opens+a+real+animated+avatar%2C+against+your+page%2C+a+color%2C+or+a+gradient%2C+with&p=%2Fassistant" />
<meta property="og:image:width" content="1200" />
<meta property="og:image:height" content="630" />
<meta name="twitter:card" content="summary_large_image" />
<meta name="twitter:site" content="@trythreews" />
<meta name="twitter:title" content="Assistant widget — three.ws" data-i18n-attr="content:assistant.meta_twitter_title"/>
<meta name="twitter:description" content="Put a 3D avatar assistant on any website with one script tag. Chat mode and speak mode, transparent or gradient backgrounds, free models or bring your own key." data-i18n-attr="content:assistant.meta_twitter_description"/>
<meta name="twitter:image" content="https://three.ws/api/page-og?s=build&t=Assistant+widget&d=Put+a+3D+avatar+assistant+on+any+website+with+one+script+tag.+A+floating+launcher+opens+a+real+animated+avatar%2C+against+your+page%2C+a+color%2C+or+a+gradient%2C+with&p=%2Fassistant" />
<style>
:root {
--bg: #09090b;
--panel: #111114;
--border: rgba(255, 255, 255, 0.09);
--ink: #fafafa;
--dim: #a1a1aa;
--accent: #f97316;
}
* { box-sizing: border-box; }
html, body {
margin: 0;
padding: 0;
background: var(--bg);
color: var(--ink);
font-family: 'Inter', system-ui, -apple-system, sans-serif;
-webkit-font-smoothing: antialiased;
}
main {
max-width: 1080px;
margin: 0 auto;
padding: 56px 20px 120px;
}
.hero h1 {
margin: 0 0 12px;
font-size: clamp(30px, 5vw, 44px);
letter-spacing: -0.02em;
line-height: 1.1;
}
.hero h1 .accent { color: var(--accent); }
.hero p.lede {
margin: 0 0 8px;
max-width: 640px;
color: var(--dim);
font-size: 16px;
line-height: 1.6;
}
.hero .hint {
font-size: 13px;
color: var(--dim);
background: rgba(249, 115, 22, 0.08);
border: 1px solid rgba(249, 115, 22, 0.25);
border-radius: 10px;
padding: 9px 12px;
display: inline-flex;
align-items: center;
gap: 8px;
margin-top: 14px;
}
.builder {
display: grid;
grid-template-columns: 1fr;
gap: 24px;
margin-top: 44px;
}
@media (min-width: 860px) {
.builder { grid-template-columns: 420px 1fr; align-items: start; }
}
.card {
background: var(--panel);
border: 1px solid var(--border);
border-radius: 16px;
padding: 20px;
}
.card h2 {
margin: 0 0 16px;
font-size: 13px;
font-weight: 700;
letter-spacing: 0.07em;
text-transform: uppercase;
color: var(--dim);
}
.field { margin-bottom: 16px; }
.field > label {
display: block;
font-size: 12.5px;
font-weight: 600;
color: var(--dim);
margin-bottom: 6px;
}
.field input[type='text'],
.field select,
.field textarea {
width: 100%;
background: rgba(255, 255, 255, 0.04);
border: 1px solid var(--border);
border-radius: 10px;
color: var(--ink);
font: 400 13.5px/1.4 'Inter', system-ui, sans-serif;
padding: 9px 11px;
outline: 0;
transition: border-color 0.15s ease;
}
.field textarea { resize: vertical; min-height: 56px; }
.field input:focus, .field select:focus, .field textarea:focus { border-color: var(--accent); }
.field .row { display: flex; gap: 8px; }
.field .row > * { flex: 1; }
.seg {
display: inline-flex;
gap: 2px;
padding: 2px;
border-radius: 10px;
background: rgba(255, 255, 255, 0.05);
border: 1px solid var(--border);
}
.seg button {
appearance: none;
border: 0;
background: transparent;
color: var(--dim);
font: 600 12px/1 'Inter', system-ui, sans-serif;
padding: 7px 13px;
border-radius: 8px;
cursor: pointer;
transition: background 0.15s ease, color 0.15s ease;
}
.seg button:hover { color: var(--ink); }
.seg button:focus-visible { outline: 2px solid var(--accent); outline-offset: 1px; }
.seg button[aria-pressed='true'] { background: rgba(255, 255, 255, 0.12); color: var(--ink); }
input[type='color'] {
width: 42px;
height: 34px;
padding: 2px;
border: 1px solid var(--border);
border-radius: 8px;
background: rgba(255, 255, 255, 0.04);
cursor: pointer;
}
.swatches { display: flex; gap: 6px; flex-wrap: wrap; }
.swatch {
width: 34px;
height: 34px;
border-radius: 9px;
border: 2px solid transparent;
cursor: pointer;
padding: 0;
transition: transform 0.12s ease, border-color 0.15s ease;
}
.swatch:hover { transform: translateY(-1px); }
.swatch:focus-visible { outline: 2px solid var(--accent); outline-offset: 2px; }
.swatch[aria-pressed='true'] { border-color: #fff; }
.swatch.transparent {
background:
linear-gradient(45deg, #2a2a2e 25%, transparent 25%, transparent 75%, #2a2a2e 75%),
linear-gradient(45deg, #2a2a2e 25%, #18181b 25%, #18181b 75%, #2a2a2e 75%);
background-size: 10px 10px;
background-position: 0 0, 5px 5px;
}
.snippet-card { position: sticky; top: 20px; }
.snippet {
position: relative;
background: #0a0a0c;
border: 1px solid var(--border);
border-radius: 12px;
padding: 16px;
font: 400 12.5px/1.65 ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
color: #d4d4d8;
overflow-x: auto;
white-space: pre;
}
.snippet .tag { color: #7dd3fc; }
.snippet .attr { color: var(--warn, #fbbf24); }
.snippet .val { color: #86efac; }
.copy-btn {
margin-top: 12px;
appearance: none;
border: 0;
border-radius: 10px;
background: var(--accent);
color: #fff;
font: 700 13.5px/1 'Inter', system-ui, sans-serif;
padding: 11px 18px;
cursor: pointer;
transition: filter 0.15s ease, transform 0.1s ease;
}
.copy-btn:hover { filter: brightness(1.1); }
.copy-btn:active { transform: scale(0.97); }
.copy-btn:focus-visible { outline: 2px solid #fff; outline-offset: 2px; }
.snippet-note { font-size: 12px; color: var(--dim); line-height: 1.6; margin-top: 12px; }
.snippet-note a { color: var(--ink); }
/* Live-preview state line: the page mounts the real widget, so it says
whether that mount is starting, running, or broken (and offers a
retry) instead of leaving a silent empty corner. */
.preview-status {
display: flex;
align-items: center;
gap: 8px;
flex-wrap: wrap;
margin-top: 12px;
padding: 9px 11px;
border-radius: 10px;
border: 1px solid var(--border);
background: rgba(255, 255, 255, 0.03);
font-size: 12px;
line-height: 1.5;
color: var(--dim);
}
.preview-status .dot {
width: 7px;
height: 7px;
border-radius: 50%;
flex: 0 0 auto;
background: var(--dim);
}
.preview-status[data-state='loading'] .dot { background: var(--warn, #fbbf24); }
.preview-status[data-state='ready'] .dot { background: var(--success, #4ade80); }
.preview-status[data-state='error'] {
border-color: rgba(248, 113, 113, 0.45);
background: rgba(248, 113, 113, 0.08);
color: #fecaca;
}
.preview-status[data-state='error'] .dot { background: var(--danger, #f87171); }
.preview-status[data-state='degraded'] { border-color: rgba(251, 191, 36, 0.4); }
.preview-status[data-state='degraded'] .dot { background: var(--warn, #fbbf24); }
.preview-status button {
margin-left: auto;
appearance: none;
border: 1px solid var(--border);
border-radius: 8px;
background: rgba(255, 255, 255, 0.06);
color: var(--ink);
font: 600 12px/1 'Inter', system-ui, sans-serif;
padding: 6px 11px;
cursor: pointer;
transition: background 0.15s ease, border-color 0.15s ease, transform 0.1s ease;
}
.preview-status button:hover { background: rgba(255, 255, 255, 0.12); }
.preview-status button:active { transform: scale(0.97); }
.preview-status button:focus-visible { outline: 2px solid var(--accent); outline-offset: 2px; }
@media (prefers-reduced-motion: reduce) {
.preview-status button { transition: none; }
}
.features {
display: grid;
grid-template-columns: repeat(auto-fit, minmax(240px, 1fr));
gap: 16px;
margin-top: 56px;
}
.feature h3 { margin: 0 0 6px; font-size: 15px; }
.feature p { margin: 0; color: var(--dim); font-size: 13.5px; line-height: 1.6; }
.docs-link { margin-top: 40px; font-size: 14px; color: var(--dim); }
.docs-link a { color: var(--ink); }
</style>
<link rel="canonical" href="https://three.ws/assistant">
<meta name="robots" content="index, follow, max-image-preview:large, max-snippet:-1">
<meta property="og:locale" content="en_US">
<meta property="og:image:alt" content="Assistant widget — three.ws">
<script type="application/ld+json">{"@context":"https://schema.org","@graph":[{"@type":"WebPage","name":"Assistant widget","description":"Put a 3D avatar assistant on any website with one script tag. A floating launcher opens a real animated avatar, against your page, a color, or a gradient, with a chatbot mode (free models or your own Groq/OpenRouter key) and a speak mode where the avatar says whatever you type out loud in a speech bubble.","url":"https://three.ws/assistant","isPartOf":{"@type":"WebSite","name":"three.ws","url":"https://three.ws"},"primaryImageOfPage":"https://three.ws/api/page-og?s=build&t=Assistant+widget&d=Put+a+3D+avatar+assistant+on+any+website+with+one+script+tag.+A+floating+launcher+opens+a+real+animated+avatar%2C+against+your+page%2C+a+color%2C+or+a+gradient%2C+with+&p=%2Fassistant"}]}</script>
</head>
<body>
<main>
<section class="hero">
<h1 data-i18n-html="assistant.a_3d_avatar_assistant_on_any_website">A 3D avatar assistant <br /><span class="accent">on any website.</span></h1>
<p class="lede" data-i18n="assistant.one_script_tag_adds_a_floating_launcher">
One script tag adds a floating launcher to your site. Click it and a real,
animated 3D avatar pops up — against your page, a color, or a gradient — with
two modes: a chatbot that answers questions (free models, or bring your own
Groq / OpenRouter key), and a speak mode where the avatar says exactly what you
type, out loud, in a speech bubble.
</p>
<span class="hint">
<svg width="15" height="15" viewBox="0 0 24 24" fill="currentColor" aria-hidden="true"><path d="M12 2l1.9 6.1L20 10l-6.1 1.9L12 18l-1.9-6.1L4 10l6.1-1.9L12 2z" /></svg>
This page runs the real widget — try the launcher in the corner. Your builder choices update it live.
</span>
</section>
<div class="builder">
<div class="card" id="builder-controls">
<h2 data-i18n="assistant.configure">Configure</h2>
<div class="field">
<label for="cfg-avatar" data-i18n="assistant.avatar">Avatar</label>
<select id="cfg-avatar">
<option value="" data-i18n="assistant.default_mannequin">Default mannequin</option>
<option value="/avatars/selfie-girl.glb" data-i18n="assistant.selfie_girl">Selfie girl</option>
<option value="/avatars/realistic-male.glb" data-i18n="assistant.realistic_male">Realistic male</option>
<option value="/avatars/realistic-female.glb" data-i18n="assistant.realistic_female">Realistic female</option>
<option value="/avatars/michelle.glb" data-i18n="assistant.michelle">Michelle</option>
<option value="/avatars/xbot.glb" data-i18n="assistant.x_bot">X Bot</option>
<option value="custom" data-i18n="assistant.custom_glb_url">Custom GLB URL…</option>
</select>
<input type="text" id="cfg-avatar-url" placeholder="https://… .glb (or a three.ws avatar id)" hidden style="margin-top: 8px" aria-label="Custom avatar GLB URL or three.ws avatar id" data-i18n-attr="aria-label:assistant.custom_avatar_glb_url_arialabel" />
</div>
<div class="field">
<label id="cfg-bg-label" data-i18n="assistant.background">Background</label>
<div class="swatches" role="group" aria-labelledby="cfg-bg-label">
<button type="button" class="swatch transparent" data-bg="" aria-pressed="true" title="Transparent — avatar floats on your page" aria-label="Transparent background" data-i18n-attr="aria-label:assistant.transparent_background_arialabel;title:assistant.transparent_avatar_floats_on_title"></button>
<button type="button" class="swatch" data-bg="#0a0a0c" style="background:#0a0a0c" title="Solid dark" aria-label="Solid dark background" data-i18n-attr="aria-label:assistant.solid_dark_background_arialabel;title:assistant.solid_dark_title"></button>
<button type="button" class="swatch" data-bg="ember" style="background:linear-gradient(160deg,#1a0b05,#7c2d12)" title="Ember gradient" aria-label="Ember gradient background" data-i18n-attr="aria-label:assistant.ember_gradient_background_arialabel;title:assistant.ember_gradient_title"></button>
<button type="button" class="swatch" data-bg="ocean" style="background:linear-gradient(160deg,#020617,#0c4a6e)" title="Ocean gradient" aria-label="Ocean gradient background" data-i18n-attr="aria-label:assistant.ocean_gradient_background_arialabel;title:assistant.ocean_gradient_title"></button>
<button type="button" class="swatch" data-bg="violet" style="background:linear-gradient(160deg,#0f0518,#5b21b6)" title="Violet gradient" aria-label="Violet gradient background" data-i18n-attr="aria-label:assistant.violet_gradient_background_arialabel;title:assistant.violet_gradient_title"></button>
<button type="button" class="swatch" data-bg="dusk" style="background:linear-gradient(200deg,#0b0714,#9d174d)" title="Dusk gradient" aria-label="Dusk gradient background" data-i18n-attr="aria-label:assistant.dusk_gradient_background_arialabel;title:assistant.dusk_gradient_title"></button>
<button type="button" class="swatch" data-bg="custom-color" id="cfg-bg-custom" title="Pick a solid color" aria-label="Custom solid color" style="background:conic-gradient(red,yellow,lime,cyan,blue,magenta,red)" data-i18n-attr="aria-label:assistant.custom_solid_color_arialabel;title:assistant.pick_a_solid_color_title"></button>
</div>
<input type="color" id="cfg-bg-color" value="#101820" hidden style="margin-top: 8px" aria-label="Custom background color" />
</div>
<div class="field">
<label id="cfg-mode-label" data-i18n="assistant.mode">Mode</label>
<div class="seg" role="group" aria-labelledby="cfg-mode-label">
<button type="button" data-mode="both" aria-pressed="true" data-i18n="assistant.chat_speak">Chat + Speak</button>
<button type="button" data-mode="chat" aria-pressed="false" data-i18n="assistant.chat_only">Chat only</button>
<button type="button" data-mode="speak" aria-pressed="false" data-i18n="assistant.speak_only">Speak only</button>
</div>
</div>
<div class="field">
<label for="cfg-name" data-i18n="assistant.assistant_name">Assistant name</label>
<input type="text" id="cfg-name" placeholder="Atelier AI" maxlength="60" />
</div>
<div class="field">
<label for="cfg-greeting" data-i18n="assistant.greeting">Greeting</label>
<input type="text" id="cfg-greeting" placeholder="Ask anything about Atelier." maxlength="200" />
</div>
<div class="field">
<label for="cfg-context" data-i18n="assistant.what_should_the_chatbot_know_about_your">What should the chatbot know about your site?</label>
<textarea id="cfg-context" placeholder="Atelier is a design studio that…" maxlength="500"></textarea>
</div>
<div class="field">
<label for="cfg-accent" data-i18n="assistant.accent_color">Accent color</label>
<div class="row" style="align-items: center">
<input type="color" id="cfg-accent" value="#f97316" style="flex: 0 0 auto" />
<span style="font-size: 12px; color: var(--dim)" data-i18n="assistant.launcher_button_send_button_focus_rings">Launcher button, send button, focus rings.</span>
</div>
</div>
<div class="field">
<label id="cfg-pos-label" data-i18n="assistant.position">Position</label>
<div class="seg" role="group" aria-labelledby="cfg-pos-label">
<button type="button" data-pos="right" aria-pressed="true" data-i18n="assistant.bottom_right">Bottom right</button>
<button type="button" data-pos="left" aria-pressed="false" data-i18n="assistant.bottom_left">Bottom left</button>
</div>
</div>
</div>
<div class="card snippet-card">
<h2 data-i18n="assistant.your_snippet">Your snippet</h2>
<div class="snippet" id="snippet" tabindex="0" aria-label="Embed code"></div>
<button type="button" class="copy-btn" id="copy-btn" data-i18n="assistant.copy_snippet">Copy snippet</button>
<p class="preview-status" id="preview-status" data-state="loading" role="status" aria-live="polite">
<span class="dot" aria-hidden="true"></span>
<!-- One span per state, toggled by src/assistant-page.js. The copy stays
in the markup (rather than in JS strings) so the i18n catalog pass
translates every state and can never revert a live one. -->
<span class="preview-msg" data-preview-state="loading" data-i18n="assistant.starting_the_live_preview">Starting the live preview...</span>
<span class="preview-msg" data-preview-state="ready" hidden data-i18n="assistant.live_preview_running_in_the_corner_every">Live preview running in the corner. Every change above re-mounts it.</span>
<span class="preview-msg" data-preview-state="degraded" hidden data-i18n="assistant.the_preview_mounted_but_its_3d_avatar">The preview mounted, but its 3D avatar did not load. Your snippet above is still correct.</span>
<span class="preview-msg" data-preview-state="error" hidden data-i18n="assistant.the_live_preview_could_not_start_the">The live preview could not start (the widget script did not load). Your snippet above is still correct, and the widget works on your own site.</span>
<button type="button" id="preview-retry" hidden data-i18n="assistant.retry">Retry</button>
</p>
<p class="snippet-note" data-i18n-html="assistant.paste_it_before_on_any_site_chat">
Paste it before <code></body></code> on any site. Chat answers come from the
free model chain (Groq → OpenRouter → NVIDIA) by default; visitors can switch to
their own Groq or OpenRouter key in the widget's settings — keys stay in their
browser. Speak mode uses the browser's built-in voices. Full docs:
<a href="/docs">/docs</a>.
</p>
</div>
</div>
<section class="features">
<div class="card feature">
<h3 data-i18n="assistant.not_a_render_not_a_video">Not a render. Not a video.</h3>
<p data-i18n="assistant.a_real_animated_3d_character_with_idle">A real animated 3D character with idle, wave, and talking animations — standing directly on your page when the background is transparent.</p>
</div>
<div class="card feature">
<h3 data-i18n="assistant.chatbot_with_real_brains">Chatbot with real brains</h3>
<p data-i18n="assistant.free_lane_needs_no_key_and_no">Free lane needs no key and no account. Or visitors bring their own Groq / OpenRouter key — it never leaves their browser and never touches your site's code.</p>
</div>
<div class="card feature">
<h3 data-i18n="assistant.speak_mode">Speak mode</h3>
<p data-i18n="assistant.type_anything_and_the_avatar_says_it">Type anything and the avatar says it out loud with a speech bubble — browser text-to-speech, pickable voices, zero cost.</p>
</div>
<div class="card feature">
<h3 data-i18n="assistant.any_avatar">Any avatar</h3>
<p data-i18n-html="assistant.use_a_built_in_body_any_three">Use a built-in body, any three.ws avatar id (make one in <a href="/forge" style="color: var(--ink)">Forge</a>), a GLB URL, or an agent's body via <code>data-agent</code>.</p>
</div>
</section>
<p class="docs-link" data-i18n-html="assistant.docs_developer_docs_related_3d_embeds_walkin">
Docs: <a href="/docs">developer docs</a> · Related: <a href="/studio">3D embeds</a> ·
<a href="/walk-embed">walking avatar embed</a> · <a href="/widget">creator widgets</a>
</p>
</main>
<script type="module" src="/src/assistant-page.js"></script>
<script src="/nav.js"></script>
<!-- Runtime i18n: detects locale, swaps annotated copy, mounts <lang-switcher>. -->
<script type="module" src="/i18n.js"></script>
</body>
</html>