Skip to content

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.

3.1 KB
Raw Blame

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→3D
  • GET /api/forge?job=<id> — poll
  • GET /api/forge?catalog — tier/backend matrix
  • POST /api/forge-upload — presigned image upload (image→3D)
  • POST /api/scene-glb-upload: presigned GLB upload, so a local mesh can be rigged or remeshed
  • POST /api/forge?action=rig and POST /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.