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
feat(forge): link /forge to Forge Workflows, list the builder in STRUCTURE and the changelog, and hand the slicer the creation id
nirholas87434c5fe0d3
diff --git a/STRUCTURE.md b/STRUCTURE.mdindex c386455fa..4f27542ec 100644--- a/STRUCTURE.md+++ b/STRUCTURE.md@@ -48,6 +48,7 @@ bottom.| Modly (local GPU generation + Modly app integrations) | Hub page [pages/modly.html](pages/modly.html) `→ /modly` + [src/modly-page.js](src/modly-page.js); shared local client [src/modly-local.js](src/modly-local.js); Forge "Use your GPU" lane [src/forge-modly.js](src/forge-modly.js) wired in [src/forge.js](src/forge.js) `→ /forge`; desktop app [apps/forge-desktop/](apps/forge-desktop); Modly extensions [integrations/modly/](integrations/modly) | Live (web); desktop app and extensions in-repo | Builds on Modly (MIT, Lightning Pixel). Browser surfaces talk to the visitor's own Modly on localhost only after Connect, run its image-to-3D models with real progress and cancel, and copy results to storage so rig/optimize/AR work. Modly users get three.ws cloud nodes and publishing. Docs: [docs/modly.md](docs/modly.md). Tests: tests/modly-local.test.js, integrations/modly/tests/ || three.ws Forge for desktop (Electron app) | App [apps/forge-desktop/](apps/forge-desktop) (Electron main [electron/main/](apps/forge-desktop/electron/main), React renderer [src/](apps/forge-desktop/src), FastAPI engine [api/](apps/forge-desktop/api)); download page [pages/forge-desktop.html](pages/forge-desktop.html) `→ /forge-desktop` + [src/forge-desktop.js](src/forge-desktop.js), [src/forge-desktop-release.js](src/forge-desktop-release.js); release pipeline [apps/forge-desktop/cloudbuild.yaml](apps/forge-desktop/cloudbuild.yaml), [scripts/release-mac.sh](apps/forge-desktop/scripts/release-mac.sh) | In-repo; download page live after deploy, shows "run from source" until the first release is published (owner-gated) | Fork of Modly (MIT, Lightning Pixel) rebranded and wired to three.ws: device-flow sign-in with the key in OS secure storage, one-click Publish to `/avatars/:id`, the CC0 library in Import, three.ws cloud nodes, and an electron-updater feed at `/releases/forge/`. Docs: [docs/forge-desktop.md](docs/forge-desktop.md), runbook [docs/ops/forge-desktop-release.md](docs/ops/forge-desktop-release.md). Tests: tests/forge-desktop-release.test.js, apps/forge-desktop `npm run test:node` || Mesh tools + slicer handoff | [src/mesh-ops/](src/mesh-ops) (worker repair/smooth/decimate, panel in Forge Optimize and `/m/:id`), [src/slicer-handoff.js](src/slicer-handoff.js), route [api/slicer/model.js](api/slicer/model.js) `→ /api/slicer/:id/[Nmm/]model.stl\|3mf` over [api/_lib/print/slicer.js](api/_lib/print/slicer.js) | Live after deploy; adapted from Modly (MIT) | In-browser mesh repair, Taubin/Laplacian smoothing and decimation with undo, plus Open in OrcaSlicer / Bambu Studio and print-ready STL/3MF downloads. Docs: [docs/forge.md](docs/forge.md). Tests: tests/mesh-ops.test.js, tests/slicer-handoff.test.js |+| Forge Workflows (node builder) | Page [pages/forge-workflows.html](pages/forge-workflows.html) `→ /forge/workflows` + [src/forge-workflows/](src/forge-workflows) (graph model, runner, node registry, editor, templates) | Live after deploy | A visual editor that chains the real Forge endpoints into one run: Generate 3D (any live engine, or Your GPU via Modly), Remesh, Rig, Segment, Stylize, Game-ready, Preview, Export and Save, with typed ports, preflight, per-node progress, cancel, a step cache, re-run from a failed node and For Each batches adapted from Modly (MIT). Four templates, browser autosave, JSON import/export; phones get a step list that runs templates. Linked from the /forge header. Docs: [docs/forge-workflows.md](docs/forge-workflows.md). Tests: tests/forge-workflows-graph.test.js, tests/forge-workflows-runner.test.js || CAD Forge (text → parametric CAD) | Page [pages/cad.html](pages/cad.html) + [src/cad/](src/cad) `→ /cad` and `→ /cad/:id` (controller [main.js](src/cad/main.js), viewer [viewer.js](src/cad/viewer.js), shared parameter contract [params.js](src/cad/params.js)), API [api/cad.js](api/cad.js) `→ /api/cad` over [api/_lib/cad/](api/_lib/cad) (writer ladder, write/build/repair loop, store, service), MCP tools [api/_mcp3d/tools/cad.js](api/_mcp3d/tools/cad.js) (`cad_generate`, `cad_rebuild`), sandboxed kernel worker [workers/cad-forge/](workers/cad-forge) | Built and verified locally · worker deploy pending (deploy it before the API image that carries `/cad`) | A sentence becomes a build123d program the OpenCascade kernel has accepted: kernel errors go back to the writer (Kimi K3 on NIM first) until it builds, and the page streams each real stage. Key dimensions are annotated constants that become sliders; each value set rebuilds on the kernel and is cached under its own link. Downloads STEP, STL, GLB (true scale), a four-view SVG drawing and the Python program; handoffs to AR, Materialize and Scene Studio; refinements are linked designs. Parts join cross-entity search as type `part`. The worker runs model-written code with a static policy, seccomp, an unprivileged uid and rlimits, under a zero-role service account. Docs: [docs/cad-forge.md](docs/cad-forge.md). Tests: [tests/cad-forge.test.js](tests/cad-forge.test.js) plus the worker's in-image gate || Scene Composer (dress an avatar) | [pages/compose.html](pages/compose.html) `→ /compose` + [src/scene-compose.js](src/scene-compose.js) | Live | Forge props from text and parent them to a rigged avatar's skeleton bones, then Export GLB or save them back onto the avatar record as `appearance.attachments`. Bones are grouped into readable regions and stripped of rig prefixes; transform gizmos, 50-deep undo, grid snap, camera presets. Feeds off [api/forge.js](api/forge.js), [api/forge-gallery.js](api/forge-gallery.js) (own creations, falling back to the community showcase for a first-time visitor), [api/explore.js](api/explore.js) `?source=avatar&only3d=1` for the avatar picker, and `PATCH /api/avatars/:id` for Save outfit. Below 900px the scene panel becomes a drawer. Docs: [docs/compose.md](docs/compose.md) || Splat Viewer (photoreal Gaussian avatars) | [pages/splat.html](pages/splat.html) `→ /splat` + page module [src/splat-viewer.js](src/splat-viewer.js), renderer [src/splat-stage.js](src/splat-stage.js) | Live | Renders Gaussian-splat and radiance-field scenes in the browser, the photoreal output of capture engines like GaussianAvatars and HumanGaussian. Loads a `.ply`, `.spz`, `.splat`, `.ksplat` or `.sog` by URL, by upload, by drag-and-drop onto the stage, or from a `?src=` deep link, plus two procedurally generated samples; decoding is entirely client-side and nothing is uploaded. The format is sniffed from the bytes rather than the filename, and the URL loader rewrites GitHub `blob`/`raw`, Hugging Face `/blob/` and Dropbox links to their CORS-enabled raw form so a pasted human-facing link still fetches. [src/splat-stage.js](src/splat-stage.js) is shared with the Forge Studio Lab ([src/forge-studio/lab/mesh-to-splat.js](src/forge-studio/lab/mesh-to-splat.js)) and wraps [Spark](https://github.com/sparkjsdev/spark) (`@sparkjsdev/spark`, MIT), lazy-loaded on first render and torn down explicitly (the WebGL context is released by hand on every scene swap, which Spark's own dispose stops short of). Every state is designed: idle/drop, engine load, fetch, decode, sort, error, and a live HUD carrying the scene label, its real splat count, a recenter control and a download of the loaded buffer. Docs: [docs/splat.md](docs/splat.md) |diff --git a/data/changelog.json b/data/changelog.jsonindex 91ac3ae07..6c37f2c7f 100644--- a/data/changelog.json+++ b/data/changelog.json@@ -1,6 +1,13 @@{"$comment": "Curated changelog entries for three.ws, the editorial layer of the public changelog. New PAGE launches are tracked automatically via the `added` field in data/pages.json; this file is for everything else holders care about: improvements, fixes, SDK releases, trading/payments capabilities, security work. scripts/build-page-index.mjs merges both sources into CHANGELOG.md, public/changelog.json, and public/changelog.xml. Newest first. Allowed tags: feature, improvement, fix, sdk, infra, docs, security, desktop (desktop entries become the desktop app's release notes). `link` is optional and must be a live three.ws path.","entries": [+ {+ "date": "2026-10-09",+ "title": "Forge Workflows: chain 3D tools into one run",+ "summary": "A visual workflow builder for the Forge. Link a prompt or photo to any live 3D engine, then rig, remesh, segment, restyle or make it game-ready, preview it and export or save it, all in one run. Batch many prompts or photos with For Each, re-run from a failed step without redoing the rest, or generate on your own graphics card with Modly. Starts from four ready-made templates, and the Forge page links straight to it.",+ "tags": ["feature"],+ "link": "/forge/workflows"+ },{"date": "2026-10-09","title": "three.ws Forge for desktop",diff --git a/docs/modly.md b/docs/modly.mdindex a0f0a9144..43837bf6f 100644--- a/docs/modly.md+++ b/docs/modly.md@@ -88,18 +88,23 @@ a three.ws chain. Both take an API key with the `avatars:write` scope from## three.ws Forge desktop app-[`apps/forge-desktop/`](../apps/forge-desktop/README.md) is Modly's desktop app-in three.ws colors, with a three.ws account built in: sign in from Settings,-publish a result from the Generate screen, and browse your three.ws library-without leaving the app. The Publish node ships inside it, already signed in.-Downloads are on [/forge-desktop](https://three.ws/forge-desktop).+three.ws Forge for desktop is Modly's desktop app in three.ws colors, with a+three.ws account built in: sign in from Settings with your browser, publish a+result to your account from the Generate screen, and import free models from+the three.ws CC0 library without leaving the app. The Publish node ships inside+it, already signed in. Get it from+[three.ws/forge-desktop](https://three.ws/forge-desktop); the full guide is+[Forge for desktop](./forge-desktop.md), and the source is+[`apps/forge-desktop/`](../apps/forge-desktop/README.md).## Ideas from Modly, built into the platform- **Workflow builder** at [/forge/workflows](https://three.ws/forge/workflows):link a prompt or photo to any live engine, then remesh, rig, segment, restyleor make it game-ready, in one run, like Modly's workflow editor but on- three.ws GPUs.+ three.ws GPUs. For Each batches follow Modly's loop rules, and the "Your GPU+ (Modly)" engine runs a step on your own Modly. See+ [Forge Workflows](./forge-workflows.md).- **Mesh tools** on every finished model in the Forge and on `/m/:id`: repair,Taubin or Laplacian smoothing and decimation in a browser worker, with undo.See [Forge: mesh tools](./forge.md#mesh-tools-repair-smooth-decimate).@@ -119,7 +124,7 @@ Downloads are on [/forge-desktop](https://three.ws/forge-desktop).| Cloud extension | [integrations/modly/three-ws/](../integrations/modly/three-ws/) | `python3 -m unittest discover -s integrations/modly/tests -p 'test_*.py'` || Publish node | [integrations/modly/three-ws-publish/](../integrations/modly/three-ws-publish/) | see its README || Shared Python client | [integrations/_pyclient/](../integrations/_pyclient/) | `python3 -m unittest discover -s integrations/_pyclient -p 'test_*.py'` |-| Desktop app | [apps/forge-desktop/](../apps/forge-desktop/) | see its README |+| Desktop app | [apps/forge-desktop/](../apps/forge-desktop/), guide [forge-desktop.md](./forge-desktop.md) | see its README || Mesh tools | [src/mesh-ops/](../src/mesh-ops/) | `npx vitest run tests/mesh-ops.test.js` || Slicer handoff | [api/slicer/model.js](../api/slicer/model.js), [api/_lib/print/slicer.js](../api/_lib/print/slicer.js), [src/slicer-handoff.js](../src/slicer-handoff.js) | `npx vitest run tests/slicer-handoff.test.js` |@@ -133,5 +138,7 @@ lists every such file.- [Forge](./forge.md): the cloud generator these surfaces share- [Workbench](./workbench.md): a desktop-style workspace in the browser+- [Forge Workflows](./forge-workflows.md): the node builder at /forge/workflows+- [Forge for desktop](./forge-desktop.md): the desktop app built on Modly- [integrations/README.md](../integrations/README.md): Blender, ComfyUI and Modly plugins- [STRUCTURE.md](../STRUCTURE.md): where every surface livesdiff --git a/pages/forge.html b/pages/forge.htmlindex 44cceacee..e8265b6f2 100644--- a/pages/forge.html+++ b/pages/forge.html@@ -122,6 +122,30 @@margin: 0;line-height: var(--leading-normal);}+ /* Way out to the node builder for multi-step runs (generate, rig,+ remesh, export). Pushed to the right end of the hero row. */+ .forge-head-link {+ margin-left: auto;+ flex: none;+ font-size: var(--text-sm);+ color: var(--ink-dim);+ text-decoration: none;+ border: 1px solid var(--stroke);+ border-radius: 999px;+ padding: 4px 12px;+ transition: color 0.15s ease, border-color 0.15s ease, background-color 0.15s ease;+ }+ .forge-head-link:hover {+ color: var(--ink);+ border-color: var(--ink-dim);+ }+ .forge-head-link:active {+ transform: translateY(1px);+ }+ .forge-head-link:focus-visible {+ outline: 2px solid var(--accent, currentColor);+ outline-offset: 2px;+ }/* "Free" lede tag: the first word a first-timer reads, so the core hook(this costs nothing, no account) lands immediately. */.forge-free-tag {@@ -3388,6 +3412,9 @@.forge-head h1 {font-size: var(--text-lg);}+ .forge-head-link {+ margin-left: 0;+ }/* Engine / quality / tier / aspect button groups carry up to sevenchips — let them wrap instead of forcing horizontal scroll. */.aspect {@@ -3759,6 +3786,7 @@<header class="forge-head"><h1 data-i18n="forge.forge">Forge</h1><p data-i18n-html="forge.free_text_or_photos_textured_3d_model"><span class="forge-free-tag">Free</span> text or photos → textured 3D model. Orbit, AR, download.</p>+ <a class="forge-head-link" href="/forge/workflows" data-i18n="forge.chain_steps_in_workflows">Chain steps in Workflows</a><noscript><p>The Forge turns a text prompt or photos into a downloadable, textured 3D model in your browser, and that generation pipeline needs JavaScript. Enable JavaScript and reload to forge. The same lane is also callable as a keyless API: <a href="/3d">the free 3D API</a>.</p><p><a href="/">three.ws home</a> · <a href="/docs">Read the docs</a></p>diff --git a/src/forge.js b/src/forge.jsindex 6b35612e6..4d912fcd1 100644--- a/src/forge.js+++ b/src/forge.js@@ -2342,7 +2342,11 @@ function showResult(glbUrl, label, meta, { autoSaved = false, downloadUrl = nullplayMaterialize(glbUrl);// Hand the live model to the Stylize panel (src/forge-stylize.js) so its// one-click geometric filters operate on the current source mesh.- document.dispatchEvent(new CustomEvent('forge:model-ready', { detail: { glbUrl, label } }));+ // creationId lets the slicer handoff address the creation directly instead+ // of parsing it out of a storage URL a lane may not have produced.+ document.dispatchEvent(+ new CustomEvent('forge:model-ready', { detail: { glbUrl, label, creationId: currentCreationId } }),+ );document.dispatchEvent(new CustomEvent('tws:feature-done', {detail: { feature: 'forge', model: { glbUrl, label } },