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
docs(figures): show the page each tutorial is about instead of only claiming a figure exists
nirholas303c17ce3aa6
diff --git a/docs/sign-language.md b/docs/sign-language.mdindex 94e68c811..9879aa2cd 100644--- a/docs/sign-language.md+++ b/docs/sign-language.md@@ -4,6 +4,10 @@ three.ws avatars communicate in American Sign Language. Words that have a sign aNew here? The step-by-step walkthrough is [Tutorial: make your avatar sign](https://three.ws/tutorials/sign-with-your-avatar). This page is the reference: every surface, the developer API, and how the engine works.+[](/sign-language)++*Type anything: the avatar signs the words it has signs for and spells the rest.*+## Start here| I want to | Go here | What happens |@@ -102,6 +106,10 @@ Another 41 everyday spellings route to those same signs, so ordinary sentences w[/asl-alphabet](https://three.ws/asl-alphabet) is the reference for the manual alphabet itself. Every letter A-Z and digit 0-9 is formed by a live rig you can orbit, so you see the handshape from any angle rather than from one photographed side.+[](/asl-alphabet)++*Every letter of the manual alphabet on a hand you can turn around.*+- **Click a key, or press it.** Typing `q` signs a Q. A single letter holds its pose so you can study it; a word settles back to rest the way a signer finishes.- **Every letter is described**, with the letters it is confused with named explicitly (F against 9, M against N, K against V, G against Q). Look-alikes are where reading breaks down, so they are called out rather than left to be discovered.- **Spell any word** and each key lights up as the hand reaches it. The word is also laid out under the input, one cell per letter, lit in the same cadence, so a long word can be followed without scrolling back to the A-to-Z grid. The highlight comes from the clip builder itself, not from a timer guessed alongside it, so it stays in step at any speed.diff --git a/docs/tutorials/animate-your-agent.md b/docs/tutorials/animate-your-agent.mdindex 29b0a4056..4c4b99597 100644--- a/docs/tutorials/animate-your-agent.md+++ b/docs/tutorials/animate-your-agent.md@@ -6,6 +6,10 @@ By the end of this tutorial your agent will move on its own: nod when a model fi**Time:** about 12 minutes.+[](/pose)++*Animation Studio drives the same canonical clip library the embeds use.*+---## What you're buildingdiff --git a/docs/tutorials/animate-your-avatar.md b/docs/tutorials/animate-your-avatar.mdindex 87eba4e3f..059373d69 100644--- a/docs/tutorials/animate-your-avatar.md+++ b/docs/tutorials/animate-your-avatar.md@@ -4,6 +4,10 @@ By the end of this tutorial you'll be able to take any rigged avatar, browse the**Prerequisites:** a three.ws account and at least one rigged avatar ([create one](/create), or load any public avatar). No code required, everything here happens in the browser. Light JavaScript familiarity helps only for the optional "how retargeting works" section.+[](/pose)++*Animation Studio drives the same canonical clip library the embeds use.*+---## What you're buildingdiff --git a/docs/tutorials/build-a-scene.md b/docs/tutorials/build-a-scene.mdindex 1b368af5c..a990e7140 100644--- a/docs/tutorials/build-a-scene.md+++ b/docs/tutorials/build-a-scene.md@@ -6,6 +6,10 @@ Along the way you'll learn how the editor's panels fit together, why the scene a**Prerequisites:** a desktop browser (the editor is keyboard- and gizmo-driven). At least one GLB or glTF model to import — generate one for free from text at [/forge](/forge), or use any GLB file you already have. No account required.+[](/scene)++*Scene Studio composes objects and avatars into one shareable scene.*+---## What you're buildingdiff --git a/docs/tutorials/character-library-to-embed.md b/docs/tutorials/character-library-to-embed.mdindex 8d49c6fcc..ee9adf5ef 100644--- a/docs/tutorials/character-library-to-embed.md+++ b/docs/tutorials/character-library-to-embed.md@@ -20,6 +20,10 @@ Ten minutes is not marketing. The list is: two minutes reading the library manif- No account, no API key, no payment. The library is free and public, and so is the embed runtime.- Background reading, if you want it: [Character Library](/docs/character-library.md) for the gallery and manifest, [Embedding Guide](/docs/embedding.md) for the full `<agent-3d>` contract.+[](/character-library)++*Every character here is a real rigged GLB you can embed as-is.*+---## Step 1 - Read the librarydiff --git a/docs/tutorials/claim-threews-name.md b/docs/tutorials/claim-threews-name.mdindex 9fa12871e..b5ed790fe 100644--- a/docs/tutorials/claim-threews-name.md+++ b/docs/tutorials/claim-threews-name.md@@ -6,6 +6,10 @@ Along the way you'll understand what the subdomain points at on-chain, why the m**Prerequisites:** a signed-in three.ws account with a **username set** (the subdomain label must match it) and at least one agent — creating an agent provisions the Solana wallet that receives the name ([create one](/create)). Light JavaScript familiarity for the pay-by-name section; the claim itself is no-code.+[](/threews/claim)++*Claiming a name is one field and one signature.*+---## What you're buildingdiff --git a/docs/tutorials/custom-skill.md b/docs/tutorials/custom-skill.mdindex 619a46326..ccbc4358e 100644--- a/docs/tutorials/custom-skill.md+++ b/docs/tutorials/custom-skill.md@@ -6,6 +6,10 @@ Along the way you'll understand the skill bundle format, how the LLM decides whe**Prerequisites:** JavaScript familiarity, a text editor, and a place to host static files (a free GitHub Pages or Vercel account works fine).+[](/skills)++*Skills are sold, trialled and installed from this catalogue.*+---## What you're buildingdiff --git a/docs/tutorials/customize-appearance.md b/docs/tutorials/customize-appearance.mdindex 813a71d69..8e72f1861 100644--- a/docs/tutorials/customize-appearance.md+++ b/docs/tutorials/customize-appearance.md@@ -13,6 +13,10 @@ This tutorial walks through every appearance attribute the `<agent-3d>` element**Prerequisites:** A page with the embed working from [Embed in 30 seconds](/tutorials/embed-in-30-seconds). You can write the attributes here straight into that page.+[](/avatar-studio)++*Avatar Studio: the rig on the left, every appearance control on the right.*+---## Step 1 — How the element reads your attributesdiff --git a/docs/tutorials/embed-in-30-seconds.md b/docs/tutorials/embed-in-30-seconds.mdindex 3e5c3e065..a127b6da4 100644--- a/docs/tutorials/embed-in-30-seconds.md+++ b/docs/tutorials/embed-in-30-seconds.md@@ -12,6 +12,10 @@ This tutorial walks through those two lines end to end. By the time you finish,**Prerequisites:** A text editor and a browser. You do not need Node, npm, a framework, or any 3D experience.+[](/studio)++*Widget Studio writes the embed snippet while you watch the result.*+---## Step 1 — Get an agent IDdiff --git a/docs/tutorials/embed-on-website.md b/docs/tutorials/embed-on-website.mdindex a58158158..c04718b84 100644--- a/docs/tutorials/embed-on-website.md+++ b/docs/tutorials/embed-on-website.md@@ -9,6 +9,10 @@ This tutorial walks you through every path for adding a three.ws agent to your s- Add it to Webflow, WordPress, or Squarespace- Show or hide the agent based on scroll position, page URL, or a timer+[](/studio)++*Widget Studio writes the embed snippet while you watch the result.*+---## Before you startdiff --git a/docs/tutorials/explore-docs-world.md b/docs/tutorials/explore-docs-world.mdindex e5665ce6b..2d8cac198 100644--- a/docs/tutorials/explore-docs-world.md+++ b/docs/tutorials/explore-docs-world.md@@ -2,6 +2,10 @@Time: about 5 minutes. You need a browser and nothing else. By the end you will have walked the documentation, read a page inside the scene, and entered the world wearing a custom avatar.+[](/docs/world)++*The documentation as a place you can walk through.*+## 1. Enter the worldOpen [three.ws/docs/world](https://three.ws/docs/world).diff --git a/docs/tutorials/first-agent.md b/docs/tutorials/first-agent.mdindex 0ad9b269b..58c850153 100644--- a/docs/tutorials/first-agent.md+++ b/docs/tutorials/first-agent.md@@ -10,6 +10,10 @@ By the end of this tutorial you will have a live, talking 3D character on a page**Prerequisites:** Basic HTML and JavaScript. You don't need to know Three.js, WebGL, or anything 3D-specific.+[](/start)++*The getting-started checklist is the shortest path from account to first agent.*+---## Step 1 — Pick a 3D avatardiff --git a/docs/tutorials/first-prompt-to-3d.md b/docs/tutorials/first-prompt-to-3d.mdindex 0c9e2cb92..645c276b6 100644--- a/docs/tutorials/first-prompt-to-3d.md+++ b/docs/tutorials/first-prompt-to-3d.md@@ -11,6 +11,10 @@ Type one sentence into ChatGPT and get a real, textured 3D model back: spin it i**Prerequisites:** A ChatGPT account. A smartphone (iPhone or Android) for the AR step; every other step works on a computer.+[](/create/prompt)++*Describe it to 3D: the prompt field and the tier picker are the whole interface.*+---## Step 1: Add the 3D Studio to ChatGPTdiff --git a/docs/tutorials/generate-3d-api.md b/docs/tutorials/generate-3d-api.mdindex 1a9f2ac4e..b2ddbd2ba 100644--- a/docs/tutorials/generate-3d-api.md+++ b/docs/tutorials/generate-3d-api.md@@ -6,6 +6,10 @@ Everything the [Forge](/forge) does in the browser is available as a plain HTTP**Prerequisites:** comfortable with `fetch` or `curl`. Examples use Node.js 18+ (built-in `fetch`), but any language with an HTTP client works the same way.+[](/forge)++*The Forge accepts a sentence or an image and returns a textured GLB.*+---## The flow in one picturediff --git a/docs/tutorials/getting-started.md b/docs/tutorials/getting-started.mdindex 4f73533bd..9ef81439f 100644--- a/docs/tutorials/getting-started.md+++ b/docs/tutorials/getting-started.md@@ -6,6 +6,10 @@ This is the easiest entry point on the platform. Everything you do here is edita**Prerequisites:** a modern browser (Chrome, Firefox, or Safari) and an email address. No coding experience, no 3D files, and no crypto required. You'll sign in once, partway through, to save your work.+[](/start)++*The getting-started checklist is the shortest path from account to first agent.*+---## What you're buildingdiff --git a/docs/tutorials/greeting-and-first-speech.md b/docs/tutorials/greeting-and-first-speech.mdindex 4f019a20e..2525f012a 100644--- a/docs/tutorials/greeting-and-first-speech.md+++ b/docs/tutorials/greeting-and-first-speech.md@@ -15,6 +15,10 @@ This tutorial covers the greeting flow end to end: waiting for the `agent:ready`**Prerequisites:** A page with the embed working from [Embed in 30 seconds](/tutorials/embed-in-30-seconds). Your agent should already be saved with a brain configured.+[](/voice)++*Voice Lab previews every voice the speech and lipsync stack can drive.*+---## Step 1 — The minimal greetingdiff --git a/docs/tutorials/image-to-3d.md b/docs/tutorials/image-to-3d.mdindex 84ada01cb..31ce7eec5 100644--- a/docs/tutorials/image-to-3d.md+++ b/docs/tutorials/image-to-3d.md@@ -6,6 +6,10 @@ Have a real object you want in 3D? Photograph it from a few angles, drop the pho**Prerequisites:** none. A phone camera is plenty.+[](/image-to-3d)++*Drop a photo here and the same pipeline returns a mesh instead of a render.*+---## Step 1 — Take good photosdiff --git a/docs/tutorials/import-avatar-url.md b/docs/tutorials/import-avatar-url.mdindex 984343ce2..6a9e08243 100644--- a/docs/tutorials/import-avatar-url.md+++ b/docs/tutorials/import-avatar-url.md@@ -6,6 +6,10 @@ This tutorial walks the URL-import path end to end. It's the sibling of [Upload**Prerequisites:** a three.ws account (the importer redirects you to sign in if you're not), and a live, publicly reachable URL to a glTF 2.0 `.glb` file. No command line, no Blender, no local tooling required — the whole flow runs in the browser.+[](/gallery)++*Every avatar in the gallery is a real GLB with a public render URL.*+---## What you're buildingdiff --git a/docs/tutorials/prompts-for-3d.md b/docs/tutorials/prompts-for-3d.mdindex d6f74dfd0..eff39291a 100644--- a/docs/tutorials/prompts-for-3d.md+++ b/docs/tutorials/prompts-for-3d.md@@ -16,6 +16,10 @@ a sci-fi combat helmet, brushed metalIf you haven't generated your first model yet, do the five-minute [text-to-3D tutorial](/tutorials/text-to-3d) first, then come back here for ideas.+[](/forge)++*The Forge accepts a sentence or an image and returns a textured GLB.*+---## The four rulesdiff --git a/docs/tutorials/sell-a-skill-with-a-trial.md b/docs/tutorials/sell-a-skill-with-a-trial.mdindex 6572169a9..bf0cb54f5 100644--- a/docs/tutorials/sell-a-skill-with-a-trial.md+++ b/docs/tutorials/sell-a-skill-with-a-trial.md@@ -8,6 +8,10 @@ The interesting part is not the listing. It is the middle. A free trial that nev**Time:** about 15 minutes.+[](/skills)++*Skills are sold, trialled and installed from this catalogue.*+---## What you're buildingdiff --git a/docs/tutorials/share-your-agent.md b/docs/tutorials/share-your-agent.mdindex ef3eb4eb5..f51194b19 100644--- a/docs/tutorials/share-your-agent.md+++ b/docs/tutorials/share-your-agent.md@@ -13,6 +13,10 @@ This tutorial covers the full sharing surface: finding the public URL, generatin**Prerequisites:** A saved agent on three.ws. The agent should have a body and a name — covered in [Embed in 30 seconds](/tutorials/embed-in-30-seconds) and [Pick and swap an avatar in Studio](/tutorials/swap-avatar-in-studio).+[](/marketplace)++*Published agents land here, forkable by anyone.*+---## Step 1 — Find your agent's public URLdiff --git a/docs/tutorials/swap-avatar-in-studio.md b/docs/tutorials/swap-avatar-in-studio.mdindex c2a62c898..3d848a798 100644--- a/docs/tutorials/swap-avatar-in-studio.md+++ b/docs/tutorials/swap-avatar-in-studio.md@@ -12,6 +12,10 @@ This tutorial covers both halves of that. You swap the body in the agent editor'**Prerequisites:** A saved agent on three.ws. If you've worked through [Embed in 30 seconds](/tutorials/embed-in-30-seconds), you already have one.+[](/avatar-studio)++*Avatar Studio: the rig on the left, every appearance control on the right.*+---## Step 1: Know which surface does whatdiff --git a/docs/tutorials/text-to-3d.md b/docs/tutorials/text-to-3d.mdindex 00cf567f5..4c1121e9e 100644--- a/docs/tutorials/text-to-3d.md+++ b/docs/tutorials/text-to-3d.md@@ -6,6 +6,10 @@ Type a sentence, get a downloadable 3D model. That's the whole tutorial. By the**Prerequisites:** none. No account, no wallet, no code. Just a browser.+[](/create/prompt)++*Describe it to 3D: the prompt field and the tier picker are the whole interface.*+---## Step 1 — Open the Forgediff --git a/docs/tutorials/upload-custom-glb.md b/docs/tutorials/upload-custom-glb.mdindex efa0a7cdc..43bc6a653 100644--- a/docs/tutorials/upload-custom-glb.md+++ b/docs/tutorials/upload-custom-glb.md@@ -12,6 +12,10 @@ This tutorial covers the whole pipeline. Where compatible GLBs come from, what m**Prerequisites:** Comfort with a file manager and the command line. Some familiarity with Blender helps for the optional baking step but is not required. You should have an existing agent in [three.ws/my-agents](https://three.ws/my-agents) to swap a body into.+[](/gallery)++*Every avatar in the gallery is a real GLB with a public render URL.*+---## Step 1: Understand what the runtime expectsdiff --git a/docs/tutorials/view-in-ar.md b/docs/tutorials/view-in-ar.mdindex e32ff6c27..b7f460de4 100644--- a/docs/tutorials/view-in-ar.md+++ b/docs/tutorials/view-in-ar.md@@ -11,6 +11,10 @@ This tutorial walks you through every step of seeing a three.ws model in augment**Prerequisites:** A smartphone (iPhone or Android). For the embedding section, a basic HTML file you can edit.+[](/walk)++*Walk on a phone: the same rig, the same clips, thumb-sized controls.*+---## Step 1 — Get a 3D modeldiff --git a/docs/tutorials/voice-and-lipsync.md b/docs/tutorials/voice-and-lipsync.mdindex c278e2510..bdb196f8c 100644--- a/docs/tutorials/voice-and-lipsync.md+++ b/docs/tutorials/voice-and-lipsync.md@@ -6,6 +6,10 @@ Along the way you'll understand why three.ws extracts visemes from the audio its**Prerequisites:** a three.ws account with at least one agent ([create one](/create)), a browser with Web Audio + WebGL (any modern desktop browser), and a microphone if you want to clone a voice or try the mic lab. No code is required for the labs; the live-agent step assumes light JavaScript familiarity.+[](/voice)++*Voice Lab previews every voice the speech and lipsync stack can drive.*+---## What you're buildingdiff --git a/docs/tutorials/walk-companion.md b/docs/tutorials/walk-companion.mdindex 6b01ad3ff..306e743da 100644--- a/docs/tutorials/walk-companion.md+++ b/docs/tutorials/walk-companion.md@@ -6,6 +6,14 @@ Along the way you'll see what the [/walk](/walk) product offers, live demos acro**Prerequisites:** a website you can edit and a WebGL-capable browser. The iframe path needs no tooling at all; the npm path assumes light JavaScript familiarity and that you already bundle [Three.js](https://threejs.org) (>= 0.150).+[](/walk)++*Walk on a phone: the same rig, the same clips, thumb-sized controls.*++[](/walk)++*Captured live: the default rig running the canonical walk clip.*+---## What you're buildingdiff --git a/public/docs/img/scene-studio.webp b/public/docs/img/scene-studio.webpnew file mode 100644index 000000000..d8de35dd5Binary files /dev/null and b/public/docs/img/scene-studio.webp differdiff --git a/public/docs/media-manifest.json b/public/docs/media-manifest.jsonindex 35ac91864..5c784bf12 100644--- a/public/docs/media-manifest.json+++ b/public/docs/media-manifest.json@@ -1,6 +1,6 @@{"generatedBy": "scripts/capture-doc-media.mjs",- "generatedAt": "2026-07-31T19:25:22.123Z",+ "generatedAt": "2026-09-08T17:25:34.474Z","shots": {"animation-studio": {"id": "animation-studio",@@ -180,6 +180,23 @@"width": 1800,"height": 1125},+ "scene-studio": {+ "id": "scene-studio",+ "src": "/docs/img/scene-studio.webp",+ "alt": "Scene Studio with a 3D scene in the viewport and the object rail",+ "caption": "Scene Studio composes objects and avatars into one shareable scene.",+ "route": "/scene",+ "viewport": "desktop",+ "animated": false,+ "authenticated": false,+ "capturedAt": "2026-09-08T17:25:32.557Z",+ "capturedFrom": "https://three.ws",+ "commit": "7f812445c",+ "sha256": "e81750217c6d3850efe7d9a0e73f135599d8a83935d7b33e27f6193a1a8ad96c",+ "bytes": 59536,+ "width": 1800,+ "height": 1125+ },"sign-api-console": {"id": "sign-api-console","src": "/docs/img/sign-api-console.webp",