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.

995 B
Raw Blame

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`.