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.

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.md
index 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.json
index 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.md
index 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, restyle
or 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 lives
diff --git a/pages/forge.html b/pages/forge.html
index 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 seven
chips — 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.js
index 6b35612e6..4d912fcd1 100644
--- a/src/forge.js
+++ b/src/forge.js
@@ -2342,7 +2342,11 @@ function showResult(glbUrl, label, meta, { autoSaved = false, downloadUrl = null
playMaterialize(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 } },