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.
Worker and avatar rules
Rules for agents touching Python model workers or avatar animation. CLAUDE.md links here so the base context stays small; read this before editing either area.
Shared worker code is vendored
Each worker's Docker build context is its own directory, so ../ is unreachable. Shared modules (worker_security.py, oin.py, oin_upload.py, gltf_meshopt.py, test_gltf_meshopt.py) therefore live as a byte-identical copy inside every worker that needs them.
- Fix the canonical copy.
- Mirror it to every worker that vendors it.
- Rerun
npm run check:vendored(scripts/check-vendored-workers.mjs, wired intonpm run gate). It prints the exactcpcommand for each drifted copy.
Caller-supplied glTF is meshopt-decoded before it is read
Most three.ws avatars ship with EXT_meshopt_compression, which trimesh cannot decode. A worker that loads a caller's mesh must route it through gltf_meshopt.decode_if_meshopt first (stylize, remesh, texture, segment and rig already do) and ship the pinned gltfpack binary in its image. A new mesh-consuming worker inherits that requirement.
Avatar animation is universal: no rig allowlist
Any humanoid avatar drives the pre-baked clip library. src/glb-canonicalize.js maps its bone names (Mixamo, Avaturn, Unreal, VRM/VRoid, VRM 1.0, Daz/Genesis, MakeHuman, Blender .L, simple shoulderL rigs) to the canonical set, and src/animation-retarget.js retargets idle/walk onto them, legs included.
- A rig that genuinely cannot be skeleton-driven (no skin, non-humanoid prop) falls back to the default rig (the
AnimationManager.supportsCanonicalClips()gate), never a bind-pose T-pose. - Hit a new skeleton convention? Add its bone-name mapping to
glb-canonicalize.jsand cover it with a case intests/glb-canonicalize.test.js. Do not hardcode a curated rig list.