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
fix(avatar-sdk): mount the react-sdk demo on one React and correct the SDK docs rows
nirholas8529f2123d07
diff --git a/ARCHITECTURE.md b/ARCHITECTURE.mdindex f79ea38b1..1b90d9edb 100644--- a/ARCHITECTURE.md+++ b/ARCHITECTURE.md@@ -887,9 +887,9 @@ Full 52-blendshape ARKit vocabulary with cross-format mapping. Falls back to jaw| SDK | Package | Path | Description ||-----|---------|------|-------------|-| `<three-ws-viewer>` web component | `@three-ws/avatar` v0.2.0 | `avatar-sdk/src/viewer.js` | Lightweight GLB viewer: OrbitControls, PMREM, ResizeObserver |-| `<agent-3d>` web component | `@three-ws/avatar` v0.2.0 | `avatar-sdk/src/agent.js` | Full chat loop, voice, lipsync, emotion morphs (~3.3 MB) |-| AvatarCreator iframe modal | `@three-ws/avatar` v0.2.0 | `avatar-sdk/src/creator.js` | Opens Avatar Studio or Avaturn iframe, resolves to GLB Blob |+| `<three-ws-viewer>` web component | `@three-ws/avatar` v0.2.2 | `avatar-sdk/src/viewer.js` | Lightweight GLB viewer: OrbitControls, PMREM, ResizeObserver |+| `<agent-3d>` web component | `@three-ws/avatar` v0.2.2 | `src/element.js` (the SDK ships it prebuilt; `avatar-sdk/src/agent.js` lazy-loads it) | Full chat loop, voice, lipsync, emotion morphs (~3.3 MB) |+| AvatarCreator iframe modal | `@three-ws/avatar` v0.2.2 | `avatar-sdk/src/creator.js` | Opens Avatar Studio or Avaturn iframe, resolves to GLB Blob || Walk Companion | `@three-ws/walk` v0.1.0 | `walk-sdk/src/companion.js` | 200×280px fixed-position corner avatar || Walk Playground | `@three-ws/walk` v0.1.0 | `walk-sdk/src/playground.js` | Full-page stroll/platformer || Page Agent | `@three-ws/page-agent` v0.1.0 | `page-agent-sdk/src/page-agent.js` | Drop-in 3D narrator that auto-walks through page content |@@ -1084,7 +1084,7 @@ All remote servers implement **MCP 2025-06-18 Streamable HTTP transport** (JSON-| `@three-ws/agent-payments` | 3.2.0 | `agent-payments-sdk/` | TypeScript | pump.fun agent payments: PumpAgent/PumpAgentOffline, EvmAgent, CrossChainPaymentClient || `@three-ws/agent-protocol-sdk` | 0.2.0 | `agent-protocol-sdk/` | TypeScript | On-chain A2A invocation: `deriveAgentPda()`, `invokeSkill()` (Anchor) || `@three-ws/agent-ui` | 0.2.0 | `agent-ui-sdk/` | JS (ESM) | Three.js GLB overlay: `createAgentUI()`, idle/walk clips, DOM-anchored behaviors |-| `@three-ws/avatar` | 0.2.0 | `avatar-sdk/` | JS (ESM) | `<three-ws-viewer>` + `<agent-3d>` web components + AvatarCreator iframe |+| `@three-ws/avatar` | 0.2.2 | `avatar-sdk/` | JS (ESM) | `<three-ws-viewer>` + `<agent-3d>` web components + AvatarCreator iframe || `@three-ws/walk` | 0.1.0 | `walk-sdk/` | JS (ESM) | Walk companion + playground: `loadWalkAvatar()`, AnimationManager || `@three-ws/page-agent` | 0.1.0 | `page-agent-sdk/` | JS (ESM) | Drop-in 3D narrator + SpeechNarrator + AvatarPicker || `@three-ws/tour` | 0.1.0 | `tour-sdk/` | JS (ESM) | Guided tour SDK: TourDirector, GuideAvatar, curriculum, spotlight |@@ -2691,7 +2691,7 @@ The seeder autonomously mass-produces public, rigged 3D avatars into the `avatar| `@three-ws/agent-payments` | 3.2.0 | pump.fun payments SDK (TypeScript) || `@three-ws/agent-protocol-sdk` | 0.2.0 | On-chain A2A invocation (TypeScript) || `@three-ws/agent-ui` | 0.2.0 | Three.js GLB overlay SDK |-| `@three-ws/avatar` | 0.2.0 | `<three-ws-viewer>` + `<agent-3d>` web components |+| `@three-ws/avatar` | 0.2.2 | `<three-ws-viewer>` + `<agent-3d>` web components || `@three-ws/walk` | 0.1.0 | Walk companion + playground SDK || `@three-ws/page-agent` | 0.1.0 | Drop-in 3D narrator SDK || `@three-ws/tour` | 0.1.0 | Guided product tour SDK |diff --git a/data/changelog.json b/data/changelog.jsonindex 18d3e2f14..56c232a75 100644--- a/data/changelog.json+++ b/data/changelog.json@@ -1,6 +1,17 @@{"$comment": "Curated changelog entries for three.ws, the editorial layer of the public changelog. New PAGE launches are tracked automatically via the `added` field in data/pages.json; this file is for everything else holders care about: improvements, fixes, SDK releases, trading/payments capabilities, security work. scripts/build-page-index.mjs merges both sources into CHANGELOG.md, public/changelog.json, and public/changelog.xml. Newest first. Allowed tags: feature, improvement, fix, sdk, infra, docs, security. `link` is optional and must be a live three.ws path.","entries": [+ {+ "date": "2026-08-15",+ "title": "Avatar SDK: the React entry finally loads, and the viewer answers to properties as well as attributes",+ "summary": "The React bindings in @three-ws/avatar shipped as a .jsx file even though they contain no JSX, which meant Node refused to import them and browsers refused to run them as a module script: the live React SDK demo had been failing with a MIME type error. That entry is now plain JavaScript, so 'import ... from \"@three-ws/avatar/react\"' works in Node, in Next.js, and straight from a browser import map, and the demo page renders all four bindings again. The lightweight <three-ws-viewer> element now also accepts src, alt, background, ar and autoRotate as properties, not only as attributes, so frameworks that assign properties (React 19, Vue, or any Object.assign helper) drive it correctly, including values set before the element upgrades. The package's documentation was corrected in the same pass: the element method list now matches the methods that actually exist, the Avatar Studio default URL is the real one, the license is stated correctly, and the two dependency-free runtime entry points are documented.",+ "tags": [+ "sdk",+ "fix",+ "docs"+ ],+ "link": "/demos/react-sdk"+ },{"date": "2026-08-15","title": "Grind-Bounty Market: shared bounty links now open the bounty, and \"Grind this\" grinds that one",diff --git a/public/demos/react-sdk.html b/public/demos/react-sdk.htmlindex e0c3b1cb0..257280c69 100644--- a/public/demos/react-sdk.html+++ b/public/demos/react-sdk.html@@ -120,8 +120,14 @@ const { avatar, loading, error } = useAvatar(id);</pre><script src="/nav.js" defer></script><script type="module">- import { createRoot } from 'react-dom/client';- import { createElement as h, useState, useCallback } from 'react';+ // Absolute CDN URLs on purpose, matching the import map above exactly.+ // The dev server rewrites bare specifiers in an inline module script to+ // its own optimized copy of React while serving /avatar-sdk/src/*.js+ // untouched, which loads two React instances and throws "Invalid hook+ // call" locally. Naming the same URL in both places keeps one instance+ // in dev and in production.+ import { createRoot } from 'https://esm.sh/[email protected]/client?dev&[email protected]';+ import { createElement as h, useState, useCallback } from 'https://esm.sh/[email protected]?dev';import {Avatar,AgentAvatar,