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>
<html lang="en">
<head>
<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="embed_demo.meta_title">Embed your avatar · three.ws</title>
<meta name="robots" content="noindex" />
<meta
name="description"
content="Drop a three.ws avatar on any site with a single <threews-avatar> tag — transparent, OBS-friendly, programmable."
data-i18n-attr="content:embed_demo.meta_description"/>
<!-- The SDK. One tag. Registers <threews-avatar> globally. -->
<script src="/embed.js" defer></script>
<style>
:root {
color-scheme: dark;
--bg: #060606;
--panel: #101010;
--border: #202020;
--text: #eee;
--muted: #8a8d98;
--accent: #ffffff;
--accent-ink: #000000;
}
* { box-sizing: border-box; }
html, body { margin: 0; padding: 0; height: 100%; }
body {
font: 15px/1.5 -apple-system, system-ui, 'Segoe UI', Roboto, sans-serif;
color: var(--text);
background: var(--bg);
background-image:
radial-gradient(800px 500px at 20% -10%, rgba(255, 255, 255, 0.04), transparent 70%),
radial-gradient(700px 400px at 110% 110%, rgba(255, 255, 255, 0.03), transparent 70%);
}
.wrap { max-width: 1100px; margin: 0 auto; padding: 56px 24px 96px; }
.eyebrow {
color: var(--accent);
font-size: 12px;
letter-spacing: 0.08em;
text-transform: uppercase;
margin-bottom: 12px;
}
h1 {
font-size: clamp(28px, 5vw, 42px);
letter-spacing: -0.02em;
margin: 0 0 12px;
font-weight: 600;
}
.lede { color: var(--muted); max-width: 64ch; margin: 0 0 40px; font-size: 16px; }
.grid {
display: grid;
grid-template-columns: repeat(auto-fit, minmax(280px, 1fr));
gap: 22px;
margin-bottom: 56px;
}
.card {
background: var(--panel);
border: 1.5px solid var(--border);
border-radius: 14px;
padding: 18px;
display: flex;
flex-direction: column;
gap: 12px;
}
.card-head { display: flex; align-items: baseline; justify-content: space-between; gap: 8px; }
.card-head h2 {
margin: 0;
font-size: 14px;
font-weight: 600;
letter-spacing: -0.005em;
}
.card-head .tag {
font-size: 10px;
color: var(--muted);
text-transform: uppercase;
letter-spacing: 0.08em;
}
.frame {
aspect-ratio: 1 / 1.15;
border-radius: 10px;
overflow: hidden;
background:
radial-gradient(70% 50% at 50% 100%, rgba(255, 255, 255, 0.04), transparent 70%),
#0c0c0c;
position: relative;
}
.frame threews-avatar {
width: 100% !important;
height: 100% !important;
min-width: 0 !important;
min-height: 0 !important;
aspect-ratio: auto !important;
}
.frame.chromakey {
background: #00ff00; /* OBS streamer preview */
}
.controls {
display: flex;
gap: 6px;
flex-wrap: wrap;
}
.controls button {
appearance: none;
background: rgba(255, 255, 255, 0.04);
border: 1px solid var(--border);
color: var(--text);
border-radius: 8px;
padding: 6px 10px;
font: inherit;
font-size: 12px;
cursor: pointer;
transition: background 0.15s, border-color 0.15s;
}
.controls button:hover {
background: rgba(255, 255, 255, 0.08);
border-color: rgba(255, 255, 255, 0.4);
}
.snippet {
background: #080808;
border: 1px solid var(--border);
border-radius: 8px;
padding: 10px 12px;
font-family: ui-monospace, 'SF Mono', 'Cascadia Code', monospace;
font-size: 11.5px;
color: #cdd;
line-height: 1.5;
overflow-x: auto;
white-space: pre;
}
.log {
font-family: ui-monospace, 'SF Mono', monospace;
font-size: 11px;
color: var(--muted);
min-height: 1.5em;
}
.log[data-tone='ok'] { color: var(--accent); }
.log[data-tone='err'] { color: #ffb3b3; }
.snippet-large {
background: var(--panel);
border: 1.5px solid var(--border);
border-radius: 12px;
padding: 18px;
font-family: ui-monospace, 'SF Mono', monospace;
font-size: 13px;
color: #cdd;
line-height: 1.6;
overflow-x: auto;
white-space: pre;
}
.snippet-large .k { color: #ffffff; }
.snippet-large .a { color: #b9c0ff; }
.snippet-large .s { color: #e8b87f; }
.section-head {
display: flex;
align-items: baseline;
justify-content: space-between;
gap: 10px;
margin: 8px 0 14px;
}
.section-head h2 {
font-size: 22px;
margin: 0;
font-weight: 600;
letter-spacing: -0.01em;
}
.section-head .note {
color: var(--muted);
font-size: 13px;
}
</style>
</head>
<body>
<div class="wrap">
<div class="eyebrow">SDK · v1.0</div>
<h1 data-i18n="embed_demo.one_tag_your_avatar_anywhere">One tag. Your avatar anywhere.</h1>
<p class="lede" data-i18n-html="embed_demo.drop_on_webflow_framer_react_plain_html">
Drop <code><threews-avatar></code> on Webflow, Framer, React, plain HTML,
Squarespace, anywhere. Transparent by default, OBS-ready with a chromakey, and
programmable via a small JS API. Examples below run live on this page.
</p>
<div class="section-head">
<h2 data-i18n="embed_demo.live_examples">Live examples</h2>
<span class="note" data-i18n-html="embed_demo.every_avatar_below_is_a_real_mounted">Every avatar below is a real <code><threews-avatar></code> mounted from the script tag at the top of this page.</span>
</div>
<div class="grid">
<!-- 1) Default — auto-rotate, transparent, no chrome -->
<div class="card">
<div class="card-head">
<h2 data-i18n="embed_demo.default">Default</h2>
<span class="tag" data-i18n="embed_demo.transparent">transparent</span>
</div>
<div class="frame">
<threews-avatar
id="ex-default"
avatar-id="a4bad2f5-8a07-43cf-82e5-b6ba1314441e"
hide-chrome
></threews-avatar>
</div>
<div class="controls">
<button data-target="ex-default" data-action="play" data-arg="wave" data-i18n="embed_demo.wave">Wave</button>
<button data-target="ex-default" data-action="play" data-arg="celebrate" data-i18n="embed_demo.celebrate">Celebrate</button>
<button data-target="ex-default" data-action="play" data-arg="dance" data-i18n="embed_demo.dance">Dance</button>
</div>
<div class="snippet"><threews-avatar avatar-id="a4bad2f5-8a07-43cf-82e5-b6ba1314441e" hide-chrome></threews-avatar></div>
<div class="log" id="log-default"></div>
</div>
<!-- 2) Card with name plate -->
<div class="card">
<div class="card-head">
<h2 data-i18n="embed_demo.with_name_plate">With name plate</h2>
<span class="tag" data-i18n="embed_demo.card_mode">card mode</span>
</div>
<div class="frame">
<threews-avatar
id="ex-card"
avatar-id="a4bad2f5-8a07-43cf-82e5-b6ba1314441e"
bg="dark"
></threews-avatar>
</div>
<div class="snippet"><threews-avatar avatar-id="…" bg="dark"></threews-avatar></div>
<div class="log" id="log-card"></div>
</div>
<!-- 3) OBS browser source — chromakey -->
<div class="card">
<div class="card-head">
<h2 data-i18n="embed_demo.obs_chromakey">OBS / chromakey</h2>
<span class="tag" data-i18n="embed_demo.streamer_mode">streamer mode</span>
</div>
<div class="frame chromakey">
<threews-avatar
id="ex-obs"
avatar-id="a4bad2f5-8a07-43cf-82e5-b6ba1314441e"
chromakey="#00ff00"
hide-chrome
pose="wave"
></threews-avatar>
</div>
<div class="snippet"><threews-avatar avatar-id="…" chromakey="#00ff00"></threews-avatar></div>
<div class="log" id="log-obs"></div>
</div>
</div>
<div class="section-head">
<h2 data-i18n="embed_demo.copy_paste_snippet">Copy-paste snippet</h2>
<span class="note" data-i18n="embed_demo.drop_this_on_any_page">Drop this on any page.</span>
</div>
<div class="snippet-large"><span class="k" data-i18n="embed_demo.script"><script</span> <span class="a" data-i18n="embed_demo.src">src</span>=<span class="s" data-i18n="embed_demo.https_three_ws_embed_js">"https://three.ws/embed.js"</span> <span class="a" data-i18n="embed_demo.defer">defer</span><span class="k" data-i18n="embed_demo.text">></script></span>
<span class="k" data-i18n="embed_demo.threews_avatar"><threews-avatar</span>
<span class="a" data-i18n="embed_demo.avatar_id">avatar-id</span>=<span class="s" data-i18n="embed_demo.your_avatar_id">"0f25b676-e27b-4929-875c-4135fea0f635"</span>
<span class="a" data-i18n="embed_demo.hide_chrome">hide-chrome</span>
<span class="a" data-i18n="embed_demo.pose">pose</span>=<span class="s" data-i18n="embed_demo.wave_2">"wave"</span><span class="k" data-i18n="embed_demo.text_2">></threews-avatar></span>
<span class="k" data-i18n="embed_demo.text_3"><script></span>
<span class="a" data-i18n="embed_demo.const">const</span> el = document.querySelector(<span class="s" data-i18n="embed_demo.threews_avatar_2">'threews-avatar'</span>);
<span class="a" data-i18n="embed_demo.await">await</span> el.ready;
el.play(<span class="s" data-i18n="embed_demo.celebrate_2">'celebrate'</span>);
<span class="k" data-i18n="embed_demo.text_4"></script></span></div>
</div>
<script>
document.addEventListener('click', async (e) => {
const btn = e.target.closest('button[data-action]');
if (!btn) return;
const target = document.getElementById(btn.dataset.target);
if (!target) return;
const log = document.getElementById('log-' + btn.dataset.target.replace('ex-', ''));
try {
if (btn.dataset.action === 'play') {
await target.play(btn.dataset.arg);
if (log) {
log.textContent = `played: ${btn.dataset.arg}`;
log.dataset.tone = 'ok';
}
}
} catch (err) {
if (log) {
log.textContent = err.message;
log.dataset.tone = 'err';
}
}
});
// Surface ready/error events into the per-card log line.
for (const el of document.querySelectorAll('threews-avatar')) {
const log = document.getElementById('log-' + el.id.replace('ex-', ''));
el.addEventListener('ready', () => {
if (!log) return;
log.textContent = 'ready · transparent canvas mounted';
log.dataset.tone = 'ok';
});
el.addEventListener('error', (ev) => {
if (!log) return;
log.textContent = 'error: ' + (ev.detail?.message || 'unknown');
log.dataset.tone = 'err';
});
}
</script>
<!-- Runtime i18n: detects locale, swaps annotated copy, mounts <lang-switcher>. -->
<script type="module" src="/i18n.js"></script>
</body>
</html>