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
three.ws Forge: FastAPI Backend
Local Python server started and managed by Electron.
Setup
cd api
python -m venv .venv
# Windows
.venv\Scripts\activate
# macOS/Linux
source .venv/bin/activate
pip install -r requirements.txt
Run (development)
uvicorn main:app --host 127.0.0.1 --port 8765 --reload
Key endpoints
| Method | Path | Description |
|---|---|---|
| GET | /health |
Health check (used by Electron to detect readiness) |
| GET | /model/status |
Model download / load status |
| GET | /model/download |
SSE stream of download progress |
| POST | /generate/from-image |
Start image-to-3D job |
| POST | /generate/from-artifact |
Start a typed-artifact model job (scene only) |
| GET | /generate/status/{job_id} |
Poll job status |
Model
Default: TripoSR (stabilityai/TripoSR, 2.4 GB)
Downloaded on first launch to `/.three-ws-forge/models/TripoSR/. To change model: edit services/model_manager.py`.