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.
three.ws integrations
First-party plugins that drive the public three.ws Forge generation pipeline
(/api/forge) from inside the tools artists already use — so a model can be
generated without leaving the DCC.
| Plugin | Folder | Host |
|---|---|---|
| Blender extension | blender/three_ws/ |
Blender 4.2+ |
| ComfyUI nodes | comfyui/three_ws_nodes/ |
ComfyUI |
| Modly extensions | modly/ (three-ws/ cloud nodes, three-ws-publish/ publish node) |
Modly |
Driving Blender from an agent rather than by hand is a different job, and it
has its own package: packages/blender-mcp/ is an MCP
server that runs Blender headlessly (no GUI, no add-on) so an assistant can
inspect, convert, render, and script 3D files, and pull a Forge generation
straight into a scene. The add-on below is the artist-facing surface; the two
install side by side.
All of them speak to the same auth-free endpoints:
POST /api/forge— text→3D and image→3DGET /api/forge?job=<id>— pollGET /api/forge?catalog— tier/backend matrixPOST /api/forge-upload— presigned image upload (image→3D)POST /api/scene-glb-upload: presigned GLB upload, so a local mesh can be rigged or remeshedPOST /api/forge?action=rigandPOST /api/forge-remesh: auto-rig and remesh a GLB by URL
Publishing to an account (POST /api/avatars) is the one call that needs a
three.ws API key.
The image pipeline (FLUX→TRELLIS) is free and platform-keyed. The
geometry pipeline (Meshy/Tripo) is BYOK — supply your own provider key in
the add-on preferences / node input and it travels as x-forge-provider-key.
Single source of truth
The Forge contract lives in exactly one file:
_pyclient/three_ws_client.py — stdlib-only
(urllib), so it runs unmodified in Blender's bundled Python and in ComfyUI with
no pip install. Each plugin ships a byte-identical vendored copy so it stays
self-contained and distributable (a Blender zip / a ComfyUI clone).
_pyclient/test_no_drift.py fails CI if a copy drifts. To update the client,
edit the canonical file and re-copy:
cp integrations/_pyclient/three_ws_client.py integrations/blender/three_ws/three_ws_client.py
cp integrations/_pyclient/three_ws_client.py integrations/comfyui/three_ws_nodes/three_ws_client.py
cp integrations/_pyclient/three_ws_client.py integrations/modly/three-ws/three_ws_client.py
cp integrations/_pyclient/three_ws_client.py integrations/modly/three-ws-publish/three_ws_client.py
Tests
No live network — every test runs an in-process stub of the Forge contract.
# shared client + drift guard
python -m unittest discover -s integrations/_pyclient -p 'test_*.py'
# comfyui nodes
( cd integrations/comfyui/three_ws_nodes && python -m unittest test_nodes )
# modly extensions (loads generator.py the way Modly does)
python -m unittest discover -s integrations/modly/tests -p 'test_*.py'
The Blender add-on is import-guarded on bpy (only present inside Blender); its
syntax is validated in CI via ast.parse.