Skip to content

armgit / 67.js

Public Imported from GitHub
0

3D engine that AI agents drive

Name every renderer backend and add measured numbers to the public copy (Part of #890)

Nguyen Xuan An51bfd8f061cf
diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json
index b23d6069..c7452dd7 100644
--- a/.claude-plugin/marketplace.json
+++ b/.claude-plugin/marketplace.json
@@ -5,14 +5,14 @@
"url": "https://67js.codepawl.com"
},
"metadata": {
- "description": "67js, a 3D engine an AI agent drives through MCP."
+ "description": "67js, a 3D engine an AI agent drives through MCP, with a WebGL2 rasterizer and a path tracer on CPU, WebGL2, WebGPU and Vulkan."
},
"plugins": [
{
"name": "67js",
"source": "./skills",
"strict": false,
- "description": "The 67js MCP server and the build-67js-scene and render-67js-media skills.",
+ "description": "The 67js MCP server for WebGL2 and path-traced scenes, and the build-67js-scene and render-67js-media skills.",
"version": "0.19.0",
"category": "development",
"homepage": "https://67js.codepawl.com",
diff --git a/README.md b/README.md
index bd3013bd..875db22a 100644
--- a/README.md
+++ b/README.md
@@ -9,12 +9,29 @@
<img alt="MCP server for agents" src="https://img.shields.io/badge/agents-MCP%20server-F7C948?style=flat-square&labelColor=0A1D1A">
</p>
-67js is a WebGL2 renderer with addons for terrain, vegetation, characters, liquid, vehicles and media export.
+67js is a 3D engine for AI agents and for pages. It has a real-time rasterizer, a path tracer, addons for terrain, vegetation, characters, liquid, vehicles and media export, and an MCP server.
A scene is plain data: each part has a geometry, a matrix and a material.
-An agent builds and changes a scene through an MCP server, looks at PNG previews and renders stills or MP4 video.
+An agent builds and changes a scene through the MCP server, looks at PNG previews and renders stills or MP4 video.
+The rasterizer runs on WebGL2. The path tracer runs on the CPU, on WebGL2, on WebGPU and, with an optional package, on Vulkan.
The goal is to be as capable as Blender and as light as three.js. [docs/goal.md](https://github.com/codepawl/67.js/blob/main/docs/goal.md) defines each part.
See the [showcase](https://67js.codepawl.com/showcase.html), the [documentation](https://67js.codepawl.com/docs.html), the [guide for agents](https://67js.codepawl.com/llms.txt) and the [changelog](https://github.com/codepawl/67.js/blob/main/CHANGELOG.md). The [FAQ](https://67js.codepawl.com/docs.html#faq) answers common questions.
+## Renderers
+
+| Name | What it is | Runs on |
+| --- | --- | --- |
+| Glaze (`Renderer67`) | The real-time rasterizer | WebGL2 |
+| Cook | The path tracer, one still per job | CPU (default), WebGL2, WebGPU (a BVH in WGSL compute, because browsers have no hardware ray tracing), and Vulkan ray queries through the optional `packages/render-native` |
+| Real-time path tracer | A hybrid tracer with a radiance cache and a temporal denoiser. It is experimental, and the MCP server does not expose it | WebGPU, with a WebGL2 fallback |
+| Light bake | Baked lightmaps | CPU, WebGL2 and WebGPU |
+
+The roadmap in [issue 890](https://github.com/codepawl/67.js/issues/890) groups these into four quality tiers: draft, realtime, realtime-high and final.
+The names are working names. Draft is a low-resolution Glaze frame with cheap lighting. Realtime is Glaze. Final is Cook.
+Realtime-high is planned: Glaze on WebGPU with GPU-driven geometry, cached global illumination and temporal upscaling ([issue 901](https://github.com/codepawl/67.js/issues/901) and [issue 902](https://github.com/codepawl/67.js/issues/902)).
+It does not exist yet. The `quality` setting that picks a tier is planned too ([issue 904](https://github.com/codepawl/67.js/issues/904)), and so is refine-at-rest ([issue 903](https://github.com/codepawl/67.js/issues/903)).
+
+<!-- tiers-table -->
+
## Showcase
Each picture below is a 67js render. The linked ones open live in the browser.
@@ -68,7 +85,7 @@ npm install 67js@npm:@codepawlhq/67js
```
The registry name is `@codepawlhq/67js`. The command installs it under the alias `67js`, so imports stay short.
-The package is ESM. The tools need Node.js 20.19 or later, and rendering needs a WebGL2 browser.
+The package is ESM. The tools need Node.js 20.19 or later. Glaze and the WebGL2 path tracer need a WebGL2 browser. The WebGPU backends need a browser with WebGPU.
### Releases
@@ -123,7 +140,7 @@ The server needs a local Chrome installation.
npx 67js-mcp --backend gpu --memory 192
```
-Use `--backend cpu` on a machine without a GPU.
+`--backend gpu` renders with hardware WebGL2 through Chrome. Use `--backend cpu` on a machine without a GPU.
With bun, `bunx 67js-mcp` takes the same flags; CI runs the packaged server under bun on every pull request.
An agent authors a [JSON recipe](docs/agent-scene.md), sets [lights and fog](docs/agent-look.md), imports [GLB assets](docs/agent-asset.md) and adds [motion](docs/agent-motion.md).
It gets PNG previews back, compares up to four views in a [review grid](docs/agent-review.md) and runs [render jobs](docs/agent-render-jobs.md) for stills and MP4 video.
@@ -183,9 +200,16 @@ The [render skill](skills/render-67js-media/SKILL.md) lists every preset and fla
2. Run `npm ci`.
3. Run `npm run dev`. Vite prints the local URL.
-## Performance claims
+## Performance
+
+Numbers below come from this repository's benchmarks. Each states its conditions, and the RTX 3060 was shared with other jobs.
+
+- **Bundle size.** The `lit-box` scene is 58,788 bytes gzip in 67js and 133,797 bytes in three.js, which is 2.3 times smaller. Measured on 2026-11-11 with `npm run size`. [bench/size/README.md](bench/size/README.md) has every scene and the goals.
+- **Path tracing on the GPU.** The 1920 by 1080 still of the demo room (181,708 triangles, 64 samples, 8 bounces) took 585.9 s on the 8-thread CPU tracer and 58.15 s on the WebGL2 GPU tracer. Both times are end to end. This is one run from 2026-11-03. [docs/webgpu-decision.md](docs/webgpu-decision.md) has the method.
+
+<!-- TODO: Cook against Cycles is measured in pull request 921 (`docs/cycles-parity.md`). Link it here, with its conditions, after it merges. -->
-[verification.md](docs/verification.md) has the measured results and their limits.
+[docs/verification.md](docs/verification.md) has older results and their limits.
They compare matching scenes on the same hardware. They do not show a general speed advantage over three.js or visual parity with Blender.
## Contributing
diff --git a/changes/890-renderer-copy.md b/changes/890-renderer-copy.md
new file mode 100644
index 00000000..cc4c71f4
--- /dev/null
+++ b/changes/890-renderer-copy.md
@@ -0,0 +1 @@
+- The README, home page, `llms.txt`, package keywords and plugin text name every renderer backend (Glaze on WebGL2, Cook on CPU, WebGL2, WebGPU and Vulkan) and give measured numbers (#890)
diff --git a/index.html b/index.html
index db5370fa..87c9fef5 100644
--- a/index.html
+++ b/index.html
@@ -4,11 +4,11 @@
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<meta name="theme-color" content="#09070f" />
- <meta name="description" content="67js is a 3D engine that AI agents drive: Glaze real-time rendering, Cook path tracing, GLB, PNG and MP4 export, and an MCP server. Install with npm i @codepawlhq/67js." />
+ <meta name="description" content="67js is a 3D engine that AI agents drive: the Glaze rasterizer on WebGL2, the Cook path tracer on CPU, WebGL2, WebGPU and Vulkan, GLB, PNG and MP4 export, and an MCP server. Install with npm i @codepawlhq/67js." />
<meta property="og:type" content="website" />
<meta property="og:site_name" content="67js" />
<meta property="og:title" content="67js · 3D engine that AI agents drive" />
- <meta property="og:description" content="Real-time WebGL2, offline path tracing and an MCP server in one npm package." />
+ <meta property="og:description" content="A WebGL2 rasterizer, a path tracer on CPU, WebGL2, WebGPU and Vulkan, and an MCP server in one npm package." />
<meta property="og:url" content="https://67js.codepawl.com/" />
<meta property="og:image" content="https://67js.codepawl.com/hero-lab/poster-b-port.webp" />
<meta property="og:image:width" content="1440" />
@@ -85,7 +85,7 @@
</div>
<div class="copy">
<h1>3D engine that<br />AI agents drive</h1>
- <p class="lede">Real-time WebGL2 with Glaze, offline path tracing with Cook, and 24 MCP tools in one package.</p>
+ <p class="lede">Glaze draws real-time frames on WebGL2. Cook path traces on the CPU, WebGL2, WebGPU or Vulkan. 24 MCP tools drive both.</p>
<div class="hero-actions">
<a href="/docs.html#getting-started" data-icon="book">Get started</a>
<a href="https://www.npmjs.com/package/@codepawlhq/67js"><span class="package-logo package-logo-npm brand-npm" aria-hidden="true"></span>npm</a>
@@ -151,25 +151,25 @@ renderer.render({ eye: [58, 31, 84], target: [-8, 3, -18] });</code></pre>
<section id="agents" class="agents" aria-labelledby="agents-title">
<div class="agents-intro">
<h2 id="agents-title">Built for agents</h2>
- <p>An agent gets a live scene to edit, glaze in real time or cook with path tracing, and review.</p>
+ <p>An agent gets a live scene to edit, draws it with Glaze or Cook, and reviews the result.</p>
<div class="code-block">
<pre><code id="home-mcp" data-language="shell">npx 67js-mcp --backend gpu --memory 192</code></pre>
<button data-copy-code="home-mcp" aria-label="Copy the MCP server command">Copy</button>
</div>
<div class="agent-size-bars" aria-label="Measured gzip bundle size on lit-box">
<div class="size-bar-row">
- <div class="size-bar-label"><span><strong>67js</strong> (lit-box)</span><span>50.9 KB gzip · 2.6× smaller</span></div>
- <div class="size-bar-track"><span class="size-bar-fill is-67js" style="width: 38%"></span></div>
+ <div class="size-bar-label"><span><strong>67js</strong> (lit-box)</span><span>58.8 kB gzip · 2.3× smaller</span></div>
+ <div class="size-bar-track"><span class="size-bar-fill is-67js" style="width: 44%"></span></div>
</div>
<div class="size-bar-row">
- <div class="size-bar-label"><span>three.js (lit-box)</span><span>133.8 KB gzip</span></div>
+ <div class="size-bar-label"><span>three.js (lit-box)</span><span>133.8 kB gzip</span></div>
<div class="size-bar-track"><span class="size-bar-fill is-other" style="width: 100%"></span></div>
</div>
</div>
</div>
<div class="agent-cards">
<a href="/mcp.md" data-icon="cube"><h3>24 MCP tools</h3><p>Create, edit, explode, blend and render over stdio.</p></a>
- <a href="/path-tracer.md" data-icon="code"><h3>Glaze + Cook</h3><p>Real-time WebGL2 frames or path-traced stills.</p></a>
+ <a href="/path-tracer.md" data-icon="code"><h3>Glaze + Cook</h3><p>Real-time frames on WebGL2, or path-traced stills on CPU, WebGL2, WebGPU or Vulkan.</p></a>
<a href="/agent-review.md" data-icon="image"><h3>Visual review</h3><p>Compare labeled views and normals from one snapshot.</p></a>
</div>
</section>
diff --git a/package.json b/package.json
index a8f11d2f..c02302bd 100644
--- a/package.json
+++ b/package.json
@@ -3,7 +3,8 @@
"version": "0.19.0",
"private": false,
"type": "module",
- "description": "3D engine that AI agents drive: an MCP server, PNG previews and CPU or GPU export to images and video",
+ "description": "3D engine that AI agents drive: a WebGL2 rasterizer, a path tracer on CPU, WebGL2, WebGPU and Vulkan, an MCP server, and PNG, MP4 and GLB export",
+ "keywords": ["webgl2", "webgpu", "path-tracing", "mcp", "ai-agents", "3d", "performance"],
"license": "MIT",
"homepage": "https://67js.codepawl.com",
"repository": {
diff --git a/public/llms.txt b/public/llms.txt
index 105216a2..c2485ada 100644
--- a/public/llms.txt
+++ b/public/llms.txt
@@ -1,11 +1,19 @@
# 67js
-> A 3D engine that AI agents drive. Real-time WebGL2 scenes in the browser, and deterministic PNG, MP4 and GLB output from the same scene.
+> A 3D engine that AI agents drive. Glaze draws real-time scenes on WebGL2, and Cook path traces stills on the CPU, WebGL2, WebGPU or Vulkan. PNG, MP4 and GLB output comes from the same scene.
67js has an MCP server (`67js-mcp`, 24 tools) that builds, edits, looks at and renders scenes from JSON recipes.
The same engine is a JavaScript library for pages and Node. The library API is in the guide below.
Scenes are plain data with stable IDs, so an agent can edit by ID and check each change with a rendered image.
+## Renderers
+
+- Glaze (`Renderer67`) is the real-time rasterizer. It runs on WebGL2 only.
+- Cook is the path tracer. Its backends are cpu (the default), gpu (WebGL2), webgpu (a software BVH in WGSL compute) and native (Vulkan ray queries, from the optional `packages/render-native`).
+- An experimental real-time path tracer runs on WebGPU with a WebGL2 fallback. The MCP server does not expose it. MCP render jobs take the cpu, gpu and native backends of Cook.
+- In the MCP server, `--backend gpu` means hardware WebGL2 in Chrome, and `--backend cpu` means software rendering.
+- Planned, not shipped: a `quality` setting that picks a tier (draft, realtime, realtime-high, final), and Glaze on WebGPU. Do not call either one. The roadmap is [issue 890](https://github.com/codepawl/67.js/issues/890).
+
## Connect
- npm package: `@codepawlhq/67js`. The MCP server is its `67js-mcp` binary. Node.js 20.19 or newer and an installed Chrome are required.
diff --git a/scripts/generate-llms.mjs b/scripts/generate-llms.mjs
index 509aeb69..c31e8243 100644
--- a/scripts/generate-llms.mjs
+++ b/scripts/generate-llms.mjs
@@ -61,12 +61,20 @@ export function buildLlmsText(tools) {
const toolLines = tools.map(tool => `- \`${tool.name}\`: ${summarize(tool.description ?? '')}`).join('\n');
return `# 67js
-> A 3D engine that AI agents drive. Real-time WebGL2 scenes in the browser, and deterministic PNG, MP4 and GLB output from the same scene.
+> A 3D engine that AI agents drive. Glaze draws real-time scenes on WebGL2, and Cook path traces stills on the CPU, WebGL2, WebGPU or Vulkan. PNG, MP4 and GLB output comes from the same scene.
67js has an MCP server (\`67js-mcp\`, ${tools.length} tools) that builds, edits, looks at and renders scenes from JSON recipes.
The same engine is a JavaScript library for pages and Node. The library API is in the guide below.
Scenes are plain data with stable IDs, so an agent can edit by ID and check each change with a rendered image.
+## Renderers
+
+- Glaze (\`Renderer67\`) is the real-time rasterizer. It runs on WebGL2 only.
+- Cook is the path tracer. Its backends are cpu (the default), gpu (WebGL2), webgpu (a software BVH in WGSL compute) and native (Vulkan ray queries, from the optional \`packages/render-native\`).
+- An experimental real-time path tracer runs on WebGPU with a WebGL2 fallback. The MCP server does not expose it. MCP render jobs take the cpu, gpu and native backends of Cook.
+- In the MCP server, \`--backend gpu\` means hardware WebGL2 in Chrome, and \`--backend cpu\` means software rendering.
+- Planned, not shipped: a \`quality\` setting that picks a tier (draft, realtime, realtime-high, final), and Glaze on WebGPU. Do not call either one. The roadmap is [issue 890](https://github.com/codepawl/67.js/issues/890).
+
## Connect
- npm package: \`@codepawlhq/67js\`. The MCP server is its \`67js-mcp\` binary. Node.js 20.19 or newer and an installed Chrome are required.
diff --git a/skills/build-67js-scene/SKILL.md b/skills/build-67js-scene/SKILL.md
index 522979af..f3508410 100644
--- a/skills/build-67js-scene/SKILL.md
+++ b/skills/build-67js-scene/SKILL.md
@@ -1,6 +1,6 @@
---
name: build-67js-scene
-description: Build, light, film and refine 3D scenes through the 67js MCP server (npm package @codepawlhq/67js). Use when an agent has the scene_* tools and must model parts, set materials, lights, HDRI, color looks, fog, lens and depth of field, animate a camera, lights, sun, sky and effects, bake light, fix z-fighting or recover from a tool error. Also for "làm cảnh 67js", "dựng cảnh 3D bằng 67js", "model bị răng cưa", "ánh sáng cảnh 67js", "đổ bóng", "sương mù 67js", "camera 67js". Image and video export is the render-67js-media skill.
+description: Build, light, film and refine 3D scenes, drawn by the WebGL2 rasterizer or the Cook path tracer, through the 67js MCP server (npm package @codepawlhq/67js). Use when an agent has the scene_* tools and must model parts, set materials, lights, HDRI, color looks, fog, lens and depth of field, animate a camera, lights, sun, sky and effects, bake light, fix z-fighting or recover from a tool error. Also for "làm cảnh 67js", "dựng cảnh 3D bằng 67js", "model bị răng cưa", "ánh sáng cảnh 67js", "đổ bóng", "sương mù 67js", "camera 67js". Image and video export is the render-67js-media skill.
license: MIT
---
diff --git a/skills/render-67js-media/SKILL.md b/skills/render-67js-media/SKILL.md
index 6a3f058f..ee6add93 100644
--- a/skills/render-67js-media/SKILL.md
+++ b/skills/render-67js-media/SKILL.md
@@ -1,6 +1,6 @@
---
name: render-67js-media
-description: Export a 67js scene to PNG stills, render passes or an MP4 through the MCP render job tools (scene_render_submit, scene_render_status, scene_render_result) of the npm package @codepawlhq/67js. Use when an agent must render an image or video of a scene, play a camera or light animation to video, cut shots with a timeline, add a score, write depth or object-ID passes, path trace a still, choose GPU or CPU and an encoder, or stay inside memory limits. Also for "render ảnh 3D", "render video 3D", "xuất mp4", "export 67js", "render bị lỗi bộ nhớ", "chất lượng MSAA". Scene building is the build-67js-scene skill.
+description: Export a 67js scene to PNG stills (Glaze, the WebGL2 rasterizer, or Cook, the path tracer on CPU, WebGL2 or Vulkan), render passes or an MP4 through the MCP render job tools (scene_render_submit, scene_render_status, scene_render_result) of the npm package @codepawlhq/67js. Use when an agent must render an image or video of a scene, play a camera or light animation to video, cut shots with a timeline, add a score, write depth or object-ID passes, path trace a still, choose GPU or CPU and an encoder, or stay inside memory limits. Also for "render ảnh 3D", "render video 3D", "xuất mp4", "export 67js", "render bị lỗi bộ nhớ", "chất lượng MSAA". Scene building is the build-67js-scene skill.
license: MIT
---
diff --git a/skills/render-67js-media/references/limits-and-checks.md b/skills/render-67js-media/references/limits-and-checks.md
index eddc982e..c83d3569 100644
--- a/skills/render-67js-media/references/limits-and-checks.md
+++ b/skills/render-67js-media/references/limits-and-checks.md
@@ -4,7 +4,7 @@
| Option | Meaning |
|---|---|
-| `--backend gpu` or `cpu` | gpu is the default and fast; cpu is SwiftShader, for machines without hardware WebGL, much slower. |
+| `--backend gpu` or `cpu` | gpu is the default and fast; cpu is SwiftShader, for machines without hardware WebGL2, much slower. WebGPU is not a server backend: Glaze is WebGL2 only. |
| `--memory <32..384>` | Render-target budget in MiB, default 192. A 1920x1080 frame needs about 175 MiB at 4 samples (measured), so use 256 for it and more for textured scenes. |
| `--jobs <abs dir>` | Private store for job files. Required for any job. |
| `--ffmpeg <abs path>` | Needed for MP4 when ffmpeg is not on PATH. |
diff --git a/skills/render-67js-media/references/rendering.md b/skills/render-67js-media/references/rendering.md
index 1ede64a6..fb0b8170 100644
--- a/skills/render-67js-media/references/rendering.md
+++ b/skills/render-67js-media/references/rendering.md
@@ -11,7 +11,7 @@ node scripts/render-media.mjs --kind video --scene film --backend gpu --preset b
```
The available scenes are `object`, `nature`, `film`, `motion`, `view2d` and `assets`.
-GPU rendering selects hardware WebGL through Chrome. CPU rendering requests ANGLE SwiftShader.
+GPU rendering selects hardware WebGL2 through Chrome and draws with Glaze, the rasterizer. A path traced still uses Cook, which has its own backend setting (see jobs.md). CPU rendering requests ANGLE SwiftShader.
The CPU exporter verifies that the selected backend reports SwiftShader.
| Preset | Dimensions | Samples | FPS | Target budget |