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(x-content): queue the photo-to-3D reel, filmed by uploading a repository photo, and document the upload step

nirholas08986d8a8874
diff --git a/data/x-content/inputs/README.md b/data/x-content/inputs/README.md
new file mode 100644
index 000000000..ae343ccb3
--- /dev/null
+++ b/data/x-content/inputs/README.md
@@ -0,0 +1,11 @@
+# Scenario inputs
+
+Files a story scenario hands to the page with an `upload` step. They live in the repository so every
+machine that reviews a post runs the scenario with the same bytes, and the proof records each file's
+SHA-256: swap a file and the proof is void until the story is filmed again.
+
+Every file here must be free to publish, because it appears in a public reel.
+
+| File | Used by | Source | License |
+|---|---|---|---|
+| `garden-gnome.jpg` | `photo-to-3d` | [German garden gnome](https://commons.wikimedia.org/wiki/File:German_garden_gnome.jpg) by Colibri1968, via Wikimedia Commons, resized to 1600x1200 | Public domain |
diff --git a/data/x-content/inputs/garden-gnome.jpg b/data/x-content/inputs/garden-gnome.jpg
new file mode 100644
index 000000000..77bd15cd9
Binary files /dev/null and b/data/x-content/inputs/garden-gnome.jpg differ
diff --git a/data/x-content/proofs/photo-to-3d.json b/data/x-content/proofs/photo-to-3d.json
new file mode 100644
index 000000000..01f9b2d06
--- /dev/null
+++ b/data/x-content/proofs/photo-to-3d.json
@@ -0,0 +1,145 @@
+{
+ "id": "photo-to-3d",
+ "scenarioHash": "c99577fc53913d20ee39a086c87ad029695615bc0759cc1507937a398c4a5135",
+ "ranAt": "2026-10-09T18:25:03.001Z",
+ "target": {
+ "commit": "ec8d1d270",
+ "revision": "three-ws-api-00482-fzq"
+ },
+ "passed": true,
+ "steps": [
+ {
+ "index": 1,
+ "kind": "goto",
+ "target": "https://three.ws/image-to-3d",
+ "detail": "loaded https://three.ws/image-to-3d",
+ "ok": true,
+ "ms": 8474,
+ "frames": 0
+ },
+ {
+ "index": 2,
+ "kind": "hold",
+ "target": "1200",
+ "detail": "1200 ms",
+ "ok": true,
+ "ms": 4625,
+ "frames": 36
+ },
+ {
+ "index": 3,
+ "kind": "upload",
+ "target": "data/x-content/inputs/garden-gnome.jpg",
+ "detail": "uploaded data/x-content/inputs/garden-gnome.jpg; POST /api/forge-upload answered 200 in 0.3 s",
+ "ok": true,
+ "ms": 3142,
+ "frames": 21
+ },
+ {
+ "index": 4,
+ "kind": "expect",
+ "target": "1 of 6 views",
+ "detail": "appeared after 0.0 s",
+ "ok": true,
+ "ms": 18,
+ "frames": 0
+ },
+ {
+ "index": 5,
+ "kind": "hold",
+ "target": "1600",
+ "detail": "1600 ms",
+ "ok": true,
+ "ms": 6932,
+ "frames": 48
+ },
+ {
+ "index": 6,
+ "kind": "click",
+ "target": "Generate",
+ "detail": "clicked; POST /api/forge answered 200 in 2.7 s",
+ "ok": true,
+ "ms": 5351,
+ "frames": 21
+ },
+ {
+ "index": 7,
+ "kind": "expect",
+ "target": "Download GLB",
+ "detail": "appeared after 178.3 s",
+ "ok": true,
+ "ms": 178323,
+ "frames": 0
+ },
+ {
+ "index": 8,
+ "kind": "hold",
+ "target": "2400",
+ "detail": "2400 ms",
+ "ok": true,
+ "ms": 35864,
+ "frames": 72
+ },
+ {
+ "index": 9,
+ "kind": "drag",
+ "target": "0.3,0.45,0.75,0.45",
+ "detail": "dragged over 54 frames",
+ "ok": true,
+ "ms": 24046,
+ "frames": 72
+ },
+ {
+ "index": 10,
+ "kind": "hold",
+ "target": "4000",
+ "detail": "4000 ms",
+ "ok": true,
+ "ms": 24370,
+ "frames": 120
+ }
+ ],
+ "facts": {},
+ "saw": [
+ "1 of 6 views",
+ "Download GLB"
+ ],
+ "responses": [
+ {
+ "method": "POST",
+ "path": "/api/forge-upload",
+ "status": 200,
+ "seconds": 0.3
+ },
+ {
+ "method": "POST",
+ "path": "/api/forge",
+ "status": 200,
+ "seconds": 2.7
+ }
+ ],
+ "uploads": [
+ {
+ "path": "data/x-content/inputs/garden-gnome.jpg",
+ "sha256": "a835c0534a0f28949d9bfc5376ea86e704bd8929c35f180c32be361b2066babd"
+ }
+ ],
+ "cuts": [
+ {
+ "afterStep": 7,
+ "seconds": 178.2
+ }
+ ],
+ "video": {
+ "path": "public/x-media/photo-to-3d/reel.mp4",
+ "sha256": "a7f2c77f9c18365bc7b7447a235faf9c83273acd873fbe2cb8c590b2eb096329",
+ "frames": 390,
+ "motion": 0.504,
+ "durationSec": 13,
+ "width": 1080,
+ "height": 1080,
+ "fps": 30,
+ "videoCodec": "h264",
+ "pixFmt": "yuv420p"
+ }
+}
diff --git a/data/x-content/queue.json b/data/x-content/queue.json
index 74de67ee8..a97952fb3 100644
--- a/data/x-content/queue.json
+++ b/data/x-content/queue.json
@@ -14652,6 +14652,224 @@
}
],
"mentions": {}
+ },
+ {
+ "id": "photo-to-3d",
+ "status": "review",
+ "kind": "post",
+ "tier": 2,
+ "lane": "community",
+ "pattern": "clip",
+ "notBefore": "2026-10-10T00:00:00Z",
+ "covers": [
+ "/image-to-3d"
+ ],
+ "scenario": {
+ "format": "square",
+ "steps": [
+ {
+ "goto": "https://three.ws/image-to-3d",
+ "settle": 6000,
+ "caption": "One photo of a garden gnome"
+ },
+ {
+ "hold": 1200
+ },
+ {
+ "upload": "data/x-content/inputs/garden-gnome.jpg",
+ "into": "FRONT",
+ "awaits": "/api/forge-upload"
+ },
+ {
+ "expect": "1 of 6 views"
+ },
+ {
+ "hold": 1600
+ },
+ {
+ "click": "Generate",
+ "awaits": "/api/forge",
+ "caption": "Free: no account, no key, no GPU"
+ },
+ {
+ "expect": "Download GLB",
+ "within": 300000
+ },
+ {
+ "hold": 2400,
+ "caption": "A textured 3D model, in the browser"
+ },
+ {
+ "drag": [
+ [
+ 0.3,
+ 0.45
+ ],
+ [
+ 0.75,
+ 0.45
+ ]
+ ],
+ "ms": 1800,
+ "caption": "Orbit it, then download the GLB"
+ },
+ {
+ "hold": 4000
+ }
+ ]
+ },
+ "probes": [
+ {
+ "type": "scenario"
+ }
+ ],
+ "posts": [
+ {
+ "text": "One photo of a garden gnome went in, and a textured 3D model came out, built in the browser with the garden cut away: three.ws/image-to-3d\n\nIt is free, with no sign-up and no API key. The free engines run on NVIDIA-hosted generation and our own self-hosted GPU workers, so the machine you upload from needs no GPU of its own. When the model lands, orbit it and download the GLB.",
+ "media": [
+ {
+ "path": "public/x-media/photo-to-3d/reel.mp4",
+ "probe": {
+ "durationSec": 13,
+ "width": 1080,
+ "height": 1080,
+ "fps": 30,
+ "videoCodec": "h264",
+ "pixFmt": "yuv420p"
+ },
+ "reel": true
+ }
+ ]
+ },
+ {
+ "text": "One photo leaves the back of the object to the model to guess. Photo mode takes up to 6 views of the same object and reconstructs them together, so a second or third angle replaces the guess with what is actually there.\n\nThe reel uses a single public domain photo, and the wait for the model is cut and labelled on screen."
+ },
+ {
+ "text": "The result is a GLB you keep. From the same screen you can view it in AR in your own room, split it into selectable parts, or retopologize it to a poly budget and export an engine-ready GLB and FBX.\n\nAgents get it too: the same pipeline is available to agents over MCP, so a bot can turn a photo into a model without opening the page."
+ }
+ ],
+ "claims": [
+ {
+ "says": "One photo of a garden gnome went in, and a textured 3D model came out",
+ "evidence": [
+ {
+ "type": "proof",
+ "responded": "/api/forge-upload"
+ },
+ {
+ "type": "proof",
+ "responded": "/api/forge"
+ },
+ {
+ "type": "proof",
+ "saw": "Download GLB"
+ }
+ ]
+ },
+ {
+ "says": "It is free, with no sign-up and no API key",
+ "evidence": [
+ {
+ "type": "page",
+ "url": "https://three.ws/image-to-3d",
+ "contains": "Free · no sign-up · yours to download"
+ },
+ {
+ "type": "page",
+ "url": "https://three.ws/image-to-3d",
+ "contains": "Engines marked FREE run with no key"
+ },
+ {
+ "type": "proof",
+ "responded": "/api/forge"
+ }
+ ]
+ },
+ {
+ "says": "The free engines run on NVIDIA-hosted generation and our own self-hosted GPU workers",
+ "evidence": [
+ {
+ "type": "page",
+ "url": "https://three.ws/image-to-3d",
+ "contains": "Engines marked FREE run with no key: NVIDIA-hosted generation plus our own self-hosted GPU workers"
+ }
+ ]
+ },
+ {
+ "says": "orbit it and download the GLB",
+ "evidence": [
+ {
+ "type": "proof",
+ "saw": "Download GLB"
+ }
+ ]
+ },
+ {
+ "says": "Photo mode takes up to 6 views of the same object",
+ "evidence": [
+ {
+ "type": "page",
+ "url": "https://three.ws/image-to-3d",
+ "contains": "Photo mode accepts up to 6 views for multi-view reconstruction"
+ },
+ {
+ "type": "proof",
+ "saw": "1 of 6 views"
+ }
+ ]
+ },
+ {
+ "says": "a second or third angle",
+ "evidence": [
+ {
+ "type": "page",
+ "url": "https://three.ws/image-to-3d",
+ "contains": "Photo mode accepts up to 6 views for multi-view reconstruction"
+ }
+ ]
+ },
+ {
+ "says": "view it in AR in your own room",
+ "evidence": [
+ {
+ "type": "page",
+ "url": "https://three.ws/image-to-3d",
+ "contains": "View this model in AR, placed in your room"
+ }
+ ]
+ },
+ {
+ "says": "split it into selectable parts",
+ "evidence": [
+ {
+ "type": "page",
+ "url": "https://three.ws/image-to-3d",
+ "contains": "Split this model into selectable parts"
+ }
+ ]
+ },
+ {
+ "says": "retopologize it to a poly budget and export an engine-ready GLB and FBX",
+ "evidence": [
+ {
+ "type": "page",
+ "url": "https://three.ws/image-to-3d",
+ "contains": "Retopologize to a poly budget and export an engine-ready GLB + FBX"
+ }
+ ]
+ },
+ {
+ "says": "the same pipeline is available to agents over MCP",
+ "evidence": [
+ {
+ "type": "page",
+ "url": "https://three.ws/image-to-3d",
+ "contains": "The same pipeline is available to agents over MCP"
+ }
+ ]
+ }
+ ],
+ "mentions": {}
}
]
}
diff --git a/public/x-media/photo-to-3d/reel.mp4 b/public/x-media/photo-to-3d/reel.mp4
new file mode 100644
index 000000000..389a1b2aa
Binary files /dev/null and b/public/x-media/photo-to-3d/reel.mp4 differ