Skip to content

3D engine that AI agents drive

22.7 KB
Raw Blame
<!doctype html>
<html lang="en" data-theme="crucible">
  <head>
    <meta charset="UTF-8" /><script>try{var c=localStorage.getItem("crucible-color");if(c==="light"||c==="dark")document.documentElement.dataset.color=c}catch(e){}</script>
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <meta name="theme-color" content="#f8f7f1" />
    <meta name="description" content="Crucible is a 3D engine that AI agents drive: the Glaze rasterizer on WebGL2, the Cook path tracer on CPU and WebGL2 (Vulkan with the optional Cook package), GLB, PNG and MP4 export, and an MCP server. Install with npm i @codepawlhq/crucible." />
    <meta property="og:type" content="website" />
    <meta property="og:site_name" content="crucible" />
    <meta property="og:title" content="Crucible · 3D engine that AI agents drive" />
    <meta property="og:description" content="A WebGL2 rasterizer, a path tracer on CPU and WebGL2 (Vulkan with an optional package), and an MCP server in one npm package." />
    <meta property="og:url" content="https://crucible.codepawl.com/" />
    <meta property="og:image" content="https://crucible.codepawl.com/og.jpg" />
    <meta property="og:image:width" content="1200" />
    <meta property="og:image:height" content="630" />
    <meta property="og:image:alt" content="The Crucible mark over a container port rendered by Crucible" />
    <meta name="twitter:card" content="summary_large_image" />
    <link rel="canonical" href="https://crucible.codepawl.com/" />
    <script id="hero-mode">
      // Decides how the home hero loads before the page body parses, so a visitor's first world starts downloading with the page, in
      // parallel with the poster and before the scripts are ready, and a visitor on a light connection downloads no 3D at all. hero-loop.js reads window.__heroMode: 'live', 'deferred' (a phone,
      // starts after the poster and an idle moment) or 'poster' (no 3D until the visitor presses Play live 3D).
      (function () {
        var connection = navigator.connection || {};
        var slowTypes = ['slow-2g', '2g', '3g'];
        var lightPath = connection.saveData === true || slowTypes.indexOf(connection.effectiveType) !== -1 || (navigator.deviceMemory !== undefined && navigator.deviceMemory <= 4);
        var phone = matchMedia('(max-width: 700px)').matches;
        var query = new URLSearchParams(location.search);
        var forcedLive = query.has('capture') || query.has('measure') || query.has('scout');
        var mode = forcedLive ? 'live' : lightPath ? 'poster' : phone ? 'deferred' : 'live';
        window.__heroMode = mode;
        document.documentElement.dataset.heroMode = mode;
        // ?scout=1 builds one world on request and never runs the loop, so nothing is prefetched for it.
        if (mode !== 'live' || query.has('scout')) return;
        // Plain fetches, not <link rel=preload>: a preload that fetch() should have reused failed now and then, with no error to read.
        // They start with the page, beside the poster (49 KB, 15 KB on a phone): only the 2 MB first view starts now and the 9.7 MB full
        // world waits for it, so the poster is not starved the way 12 MB of world files started at once once starved it.
        // hero-lab/loop/world.js waits for window.__heroPrefetchReady, takes these promises by URL and falls back to its own request when
        // one is missing or failed.
        var prefetched = window.__heroPrefetch = {};
        var releaseReady;
        window.__heroPrefetchReady = new Promise(function (resolve) { releaseReady = resolve; });
        function startPrefetch() {
          // The first view (a small copy of the whole world) goes first and the full world's files start when those have settled, so
          // the first 3D frame does not wait for the full 9 MB. The promises exist at once; world.js takes them by URL.
          var firstViewFiles = ['/showcase/port/scene.json', '/showcase/port/scene.first.glb', '/showcase/port/sky.preview.hdr'];
          var fullWorldFiles = ['/showcase/port/scene.glb', '/showcase/port/scene.rest.glb', '/showcase/port/sky.hdr'];
          function download(href, startAfter) {
            var request = startAfter ? startAfter.then(function () { return fetch(href); }) : fetch(href);
            return request.then(function (response) {
              if (!response.ok) throw new Error(href + ' is not available (' + response.status + ')');
              return response.blob();
            });
          }
          firstViewFiles.forEach(function (href) { prefetched[href] = download(href, null); });
          var firstViewSettled = Promise.all(firstViewFiles.map(function (href) { return prefetched[href].catch(function () {}); }));
          fullWorldFiles.forEach(function (href) { prefetched[href] = download(href, firstViewSettled); });
          firstViewFiles.concat(fullWorldFiles).forEach(function (href) { prefetched[href].catch(function () {}); });
          releaseReady();
        }
        startPrefetch();
      })();
    </script>
    <title>Crucible · 3D engine that AI agents drive</title>
    <link rel="icon" href="/favicon.svg?v=2" type="image/svg+xml" /><link rel="icon" href="/favicon.ico?v=2" sizes="48x48" /><link rel="apple-touch-icon" href="/apple-touch-icon.png" />
  </head>
  <body class="site">
    <a class="skip-link" href="#content">Skip to content</a>
    <header class="navigation">
      <a class="brand" href="/" aria-label="Crucible home">Crucible</a>
      <span class="version" data-release-version>Loading release</span>
      <nav aria-label="Library">
        <a href="/docs.html">Docs</a><a href="/recipes.html">Recipes</a><a href="/marketplace.html">Marketplace</a><a href="/changelog.html">Changelog</a>
      </nav>
      <a class="site-nav-cta" href="https://github.com/codepawl/crucible" aria-label="GitHub"><span class="package-logo package-logo-github" aria-hidden="true"></span><span class="site-nav-cta-label">GitHub</span></a>
    </header>
    <section id="hero" class="hero-loop" data-scene="port" aria-label="Crucible introduction and live preview">
      <div class="stage" id="stage" tabindex="-1" role="img" aria-label="A live 3D scene: Container port">
        <picture><source media="(max-width: 700px)" srcset="/hero-lab/poster-b-port-mobile.webp" /><img class="poster" id="poster" src="/hero-lab/poster-b-port.webp" alt="" width="1440" height="900" fetchpriority="high" /></picture>
      </div>
      <div class="copy">
        <h1>3D engine that<br />AI agents drive</h1>
        <p class="lede">Glaze draws real-time frames. Cook path traces stills. 25 MCP tools drive them.</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/crucible"><span class="package-logo package-logo-npm brand-npm" aria-hidden="true"></span>npm</a>
        </div>
        <p class="rename-note"><a href="/changelog.html">67js is now Crucible: install <code>@codepawlhq/crucible</code></a></p>
      </div>
      <div class="scene-bar">
        <div class="attribution" id="attribution" hidden></div>
        <button class="play-live" id="play-live" type="button" hidden><svg viewBox="0 0 24 24" aria-hidden="true"><path class="play-icon" d="M8 5.5v13l10-6.5-10-6.5Z"/><circle class="play-wait" cx="12" cy="12" r="8"/></svg><span class="play-label">Play live 3D</span></button>
        <nav class="scene-tabs" id="scene-tabs" aria-label="Scenes"></nav>
      </div>
    </section>
    <main id="content">
      <section id="downloads" class="home-install" aria-label="Install Crucible">
        <div class="package-install">
          <div class="package-managers" role="group" aria-label="Package manager">
            <button data-package-manager="npm" aria-pressed="true"><span class="package-logo package-logo-npm" aria-hidden="true"></span><span>npm</span></button>
            <button data-package-manager="pnpm" aria-pressed="false"><span class="package-logo package-logo-pnpm" aria-hidden="true"></span><span>pnpm</span></button>
            <button data-package-manager="yarn" aria-pressed="false"><span class="package-logo package-logo-yarn" aria-hidden="true"></span><span>Yarn</span></button>
            <button data-package-manager="bun" aria-pressed="false"><span class="package-logo package-logo-bun" aria-hidden="true"></span><span>Bun</span></button>
          </div>
          <div class="command-row"><code data-install-command>Loading the release command…</code><button data-copy-install disabled>Copy command</button></div>
          <div class="release-feedback" hidden><p data-release-status role="status">Loading release information</p><button data-release-retry hidden>Retry</button></div>
        </div>
      </section>

      <section id="code" class="code-section" aria-labelledby="code-title">
        <div class="code-copy">
          <h2 id="code-title">A scene in a few lines</h2>
          <div class="code-block">
            <pre><code id="home-code" data-language="javascript">import { Glaze } from 'crucible';
import { loadGltf } from 'crucible/addons/gltf';
import { loadHdri } from 'crucible/addons/hdri';

const { parts } = await loadGltf('/airport.glb');
const map = await loadHdri('/sky.hdr');
const renderer = new Glaze(canvas, parts, {
  hdr: true,
  ground: false,
  environment: { map },
});

renderer.render({ eye: [58, 31, 84], target: [-8, 3, -18] });</code></pre>
            <button data-copy-code="home-code" aria-label="Copy the code example">Copy</button>
          </div>
        </div>
        <img class="code-result" src="./previews/showcase-datacenter.webp" alt="A cutaway AI data center hall rendered by Crucible from a GLB and an HDRI" width="1280" height="720" loading="lazy" />
      </section>

      <section id="examples" class="examples" aria-labelledby="examples-title">
        <div class="section-heading"><h2 id="examples-title">Showcase</h2><span class="section-heading-links"><a href="./showcase.html#community">Submit your work</a><a href="./showcase.html">Open the live scenes</a></span></div>
        <ul class="capability-list" aria-label="Engine capabilities">
          <li>PBR materials</li><li>Shadows</li><li>HDR and bloom</li><li>MSAA</li><li>Mesh blend</li><li>Live cloth</li><li>Volumetric fog</li><li>Skinning and morphs</li><li>Physics</li><li>Spume liquid</li><li>Glass and leaf cutouts</li><li>HDRI lighting</li><li>Textured terrain</li><li>Trees and grass</li><li>Vehicles</li><li>GLB import and export</li><li>Cook path tracer</li>
        </ul>
        <div class="gallery">
          <a class="example is-lead" href="./showcase.html?scene=airport"><span class="work-media"><img src="./previews/showcase-airport.webp" alt="Airport ramp, rendered by Crucible" width="1280" height="720" loading="lazy" /></span><span class="work-title"><span class="work-name">Airport ramp</span><span class="work-date">A widebody at the stand with its service trucks</span></span></a>
          <a class="example" href="./showcase.html?scene=datacenter"><span class="work-media"><img src="./previews/showcase-datacenter.webp" alt="AI data center, rendered by Crucible" width="1280" height="720" loading="lazy" /></span><span class="work-title"><span class="work-name">AI data center</span><span class="work-date">Rows of racks, power and cooling, cut open</span></span></a>
          <a class="example" href="./showcase.html?scene=port"><span class="work-media"><img src="./previews/showcase-port.webp" alt="Container port, rendered by Crucible" width="1280" height="720" loading="lazy" /></span><span class="work-title"><span class="work-name">Container port</span><span class="work-date">A ship at berth under the quay cranes</span></span></a>
        </div>
      </section>

      <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, draws it with Glaze or Cook, and reviews the result.</p>
          <div class="code-block">
            <pre><code id="home-mcp" data-language="shell">npx crucible-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>Crucible</strong> (lit-box)</span><span>58.8 kB gzip · 2.28× smaller</span></div>
              <div class="size-bar-track"><span class="size-bar-fill is-crucible" 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-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>25 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 frames, or path-traced stills.</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>

      <section id="tiers" class="tiers" aria-labelledby="tiers-title">
        <h2 id="tiers-title">Quality tiers, measured</h2>
        <p class="tiers-caption">Six scenes, 960×540, RTX 3060. Time bars show the slowest scene.</p>
        <div id="tiers-table">
          <div class="tier-rail" aria-hidden="true"><span class="tier-line"></span><span class="tier-end is-start">Cheapest</span><span class="tier-end is-finish">Best looking</span></div>
          <ol class="tier-cards">
          <!-- tier-cards:start (written by bench/tiers/make-home-tiers.mjs) -->
          <li class="tier-card" data-tier="draft" data-glaze-ms="0.54-1.04" data-eevee-ms="56-59" data-flip-glaze="0.045-0.188" data-flip-eevee="0.041-0.562">
            <div class="tier-top"><svg class="tier-icon" viewBox="0 0 24 24" aria-hidden="true"><path d="M13 3 5 13.5h6L10 21l8-10.5h-6z"/></svg><h3>draft</h3></div>
            <p class="tier-for">A quick look while editing</p>
            <p class="tier-big"><strong>0.54–1.04</strong> <span>ms a frame</span></p>
            <div class="tier-bars" role="img" aria-label="Glaze 0.54 to 1.04 ms a frame; EEVEE 1 sample 56 to 59 ms a render call">
              <div class="tier-row-bar is-crucible"><span class="tier-bar-label"><span>Crucible Glaze</span><span>0.54–1.04 ms</span></span><span class="tier-track"><span class="tier-fill" style="--w:1.8%"></span></span></div>
              <div class="tier-row-bar is-other"><span class="tier-bar-label"><span>EEVEE 1 sample</span><span>56–59 ms</span></span><span class="tier-track"><span class="tier-fill" style="--w:100%"></span></span></div>
            </div>
            <div class="tier-bars is-quality" role="img" aria-label="Error vs Cycles, lower is better: Glaze 0.045 to 0.188, EEVEE 0.041 to 0.562">
              <p class="tier-bars-title">Error vs Cycles, lower is better</p>
              <div class="tier-row-bar is-crucible"><span class="tier-bar-label"><span>Error, Glaze</span><span>0.045–0.188</span></span><span class="tier-track"><span class="tier-fill is-range" style="--l:7.5%;--w:23.8%"></span></span></div>
              <div class="tier-row-bar is-other"><span class="tier-bar-label"><span>Error, EEVEE</span><span>0.041–0.562</span></span><span class="tier-track"><span class="tier-fill is-range" style="--l:6.8%;--w:86.8%"></span></span></div>
            </div>
          </li>
          <li class="tier-card" data-tier="realtime" data-glaze-ms="0.77-0.98" data-eevee-ms="288-363" data-flip-glaze="0.03-0.197" data-flip-eevee="0.042-0.562">
            <div class="tier-top"><svg class="tier-icon" viewBox="0 0 24 24" aria-hidden="true"><path d="M8 5.5v13l11-6.5z"/></svg><h3>realtime</h3></div>
            <p class="tier-for">Interactive use</p>
            <p class="tier-big"><strong>0.77–0.98</strong> <span>ms a frame</span></p>
            <div class="tier-bars" role="img" aria-label="Glaze 0.77 to 0.98 ms a frame; EEVEE 64 samples 288 to 363 ms a render call">
              <div class="tier-row-bar is-crucible"><span class="tier-bar-label"><span>Crucible Glaze</span><span>0.77–0.98 ms</span></span><span class="tier-track"><span class="tier-fill" style="--w:0.3%"></span></span></div>
              <div class="tier-row-bar is-other"><span class="tier-bar-label"><span>EEVEE 64 samples</span><span>288–363 ms</span></span><span class="tier-track"><span class="tier-fill" style="--w:100%"></span></span></div>
            </div>
            <div class="tier-bars is-quality" role="img" aria-label="Error vs Cycles, lower is better: Glaze 0.03 to 0.197, EEVEE 0.042 to 0.562">
              <p class="tier-bars-title">Error vs Cycles, lower is better</p>
              <div class="tier-row-bar is-crucible"><span class="tier-bar-label"><span>Error, Glaze</span><span>0.03–0.197</span></span><span class="tier-track"><span class="tier-fill is-range" style="--l:5%;--w:27.8%"></span></span></div>
              <div class="tier-row-bar is-other"><span class="tier-bar-label"><span>Error, EEVEE</span><span>0.042–0.562</span></span><span class="tier-track"><span class="tier-fill is-range" style="--l:7%;--w:86.7%"></span></span></div>
            </div>
          </li>
          <li class="tier-card is-planned" data-tier="realtime-high" data-status="planned">
            <div class="tier-top"><svg class="tier-icon" viewBox="0 0 24 24" aria-hidden="true"><path d="M12 3c.6 4.6 2.4 6.4 7 7-4.6.6-6.4 2.4-7 7-.6-4.6-2.4-6.4-7-7 4.6-.6 6.4-2.4 7-7z"/></svg><h3>realtime-high</h3></div>
            <p class="tier-for">Better live frames</p>
            <p class="tier-big"><strong>Planned</strong> <span>not measured</span></p>
            <div class="tier-bars" aria-hidden="true">
              <div class="tier-row-bar is-crucible"><span class="tier-bar-label"><span>Crucible Glaze</span><span>?</span></span><span class="tier-track"><span class="tier-fill" style="--w:0%"></span></span></div>
              <div class="tier-row-bar is-other"><span class="tier-bar-label"><span>Blender</span><span>?</span></span><span class="tier-track"><span class="tier-fill" style="--w:0%"></span></span></div>
            </div>
            <p class="tier-plan">WebGPU, GI cache, upscaling. Issues <a href="https://github.com/codepawl/crucible/issues/901">901</a> and <a href="https://github.com/codepawl/crucible/issues/902">902</a>.</p>
          </li>
          <li class="tier-card" data-tier="final" data-cook-ms="1.73-4.24" data-cycles-ms="6.81-26.41" data-noise-time-x="1.05-4.02">
            <div class="tier-top"><svg class="tier-icon" viewBox="0 0 24 24" aria-hidden="true"><path d="M6.5 4h11l3.5 5-9 11L3 9z"/><path d="M3 9h18M9.5 9 12 20l2.5-11"/></svg><h3>final</h3></div>
            <p class="tier-for">Finished stills</p>
            <p class="tier-big"><strong>1.73–4.24</strong> <span>ms per sample</span></p>
            <div class="tier-bars" role="img" aria-label="Per sample: Cook native 1.73 to 4.24 ms, Cycles OptiX 6.81 to 26.41 ms">
              <div class="tier-row-bar is-crucible"><span class="tier-bar-label"><span>Cook native</span><span>1.73–4.24 ms</span></span><span class="tier-track"><span class="tier-fill" style="--w:16.1%"></span></span></div>
              <div class="tier-row-bar is-other"><span class="tier-bar-label"><span>Cycles OptiX</span><span>6.81–26.41 ms</span></span><span class="tier-track"><span class="tier-fill" style="--w:100%"></span></span></div>
            </div>
            <div class="tier-bars is-quality" role="img" aria-label="Time to the same noise, Cycles is 1 times: Cook needs 1.05 to 4.02 times, on three of six scenes">
              <p class="tier-bars-title">Time to same noise, lower is better</p>
              <div class="tier-row-bar is-other"><span class="tier-bar-label"><span>Same noise, Cycles</span><span>1×</span></span><span class="tier-track"><span class="tier-fill" style="--w:22.2%"></span></span></div>
              <div class="tier-row-bar is-crucible"><span class="tier-bar-label"><span>Same noise, Cook</span><span>1.05–4.02×</span></span><span class="tier-track"><span class="tier-fill is-range" style="--l:23.3%;--w:66%"></span></span></div>
            </div>
            <p class="tier-plan">Slower to the same noise. Not reached on metal, glass, outdoor-hdri. Vulkan needs the optional Cook package.</p>
          </li>
          <!-- tier-cards:end -->
          </ol>
        </div>
        <p class="tiers-note">Blender times are one whole EEVEE render call (scene sync, ray tracing off, no GI), not a frame rate. Details: <a href="https://github.com/codepawl/crucible/blob/main/bench/tiers/results/matrix-960.table.md">bench/tiers</a>.</p>
      </section>

      <section id="documentation" class="documentation-links" aria-labelledby="documentation-title">
        <h2 id="documentation-title">Documentation</h2>
        <div class="doc-links">
          <a href="/docs.html#getting-started" data-icon="book">Getting started</a>
          <a href="/docs.html#models-and-ai-agents" data-icon="cube">Models and agents</a>
          <a href="/docs.html#performance-and-memory" data-icon="code">Performance and memory</a>
          <a href="/changelog.md" data-icon="package">Changelog</a>
        </div>
      </section>

      <section id="sponsors" class="documentation-links sponsors" aria-labelledby="sponsors-title">
        <h2 id="sponsors-title">Sponsors</h2>
        <p>Crucible is free and MIT licensed. Sponsors pay for GPU time, test hardware and the hours that go into it. Company sponsors get their logo here from $100 a month.</p>
        <div class="doc-links">
          <a href="https://github.com/sponsors/codepawl" data-icon="heart">Sponsor on GitHub</a>
        </div>
      </section>
    </main>
    <footer class="site-footer" aria-label="Site footer">
      <p><a class="brand" href="/" aria-label="Crucible home">Crucible</a> by <a href="https://codepawl.com">CodePawl</a>, formerly 67js</p>
      <nav class="footer-links" aria-label="Project links"><a href="https://github.com/codepawl/crucible"><span class="package-logo package-logo-github" aria-hidden="true"></span>GitHub</a><a href="https://www.npmjs.com/package/@codepawlhq/crucible"><span class="package-logo package-logo-npm" aria-hidden="true"></span>npm</a><a data-release-commit href="https://github.com/codepawl/crucible">Release commit</a><a href="/changelog.html">Changelog</a><a href="/license.txt">MIT license</a><a href="/logo.svg" download>Logo SVG</a><a href="https://github.com/sponsors/codepawl">Sponsor</a></nav>
    </footer>
    <script type="module" src="/src/home.js"></script>
    <script type="module" src="/src/hero-lab/hero-loop.js"></script>
  </body>
</html>