Skip to content

design:os · 3D Blender · agent operating system

An AI agent that builds parts natively in Blender, and shows its evidence.

Agent skills, a verified bpy knowledge base, an AGENT_OK / AGENT_FAIL execution contract and a production gate for Blender 5.2 LTS. Every worked build below ships with what was checked and what was not.

License: PolyForm Shield 1.0.0 Last commit Blender 5.2 LTS Python 3.10+ bpy: data API first MCP: blender-mcp Claude Code · Codex · Antigravity

See the buildsInstall and run a pass

DESIGN:OS 3D Blender in 30 seconds: five worked builds going from blueprint lines to clay to the final render

rendered with the DESIGN:OS SVG Animation engine, 1080p 60 fps · Download the 9:16 version

Native renders from the worked builds

  • DC-01 desktop companion assembled, native Cycles render
  • DC-01 parts separated to explain the construction
  • CK-001 reference keyboard, revision B, Full HD render
  • CK-001 keyboard exploded into its part families
  • Six-axis robot arm, complete native assembly
  • Watch-winder capsule with its transparent dome
  • ORC turbine and generator set in its hall
  • Geothermal wellhead with valves and instruments
  • Nodestack 2×2 modular desk storage in studio render, native Cycles render
  • Nodestack orange drawer partially open showing bay clearance, native Cycles render
  • Nodestack 2×2 canonical arrangement in studio three-quarter view, native Cycles render
  • Nodestack 2×3 three-tier tower configuration in studio view, native Cycles render
  • Nodestack 4×2 wide desk arrangement in studio view, native Cycles render
  • Nodestack geometric wireframe blueprint visualization, native Cycles render
  • Nodestack exploded isometric view of modules and connecting pins, native Cycles render
  • Nodestack modular parts catalog showing component inventory, native Cycles render

DC-01 desktop companion — rendered in Blender, no added captions.

01 / 16

Worked builds

Names, status and evidence limits live next to each build. ORC images are derivatives of native renders whose source models are not in the public checkout; the keyboard, robot arm and watch winder are.

  • Nodestack 2×2 modular desk storage in studio render, native Blender Cycles

    Blender 5.2.0 LTS Cycles Metal 5.2

    Nodestack: modular desk storage, built and reviewed with evidence

    Nodestack is a Blender native modular desk-storage study with orange drawers, open shelves, a 102-second procedural assembly guide, and three procedural configurations. OpenAI Dots orchestrated Antigravity planning and bpy scripting under human direction and review, incorporating separate evidence-based reviews.

    Nodestack procedural assembly guide (102 seconds, seven chapters)

    diagrammatic workholding, tag retention unknown, physical testing pending · Open seven chapters
    Direct technical section comparison: E304 baseline versus v16b candidate base seating

    Base seating cross-section: E304 baseline (left) versus v16b candidate (right)

    nodestack-v16b-base-before-after.png
    Configurations
    2×2 / 2×3 / 4×232, 45, 68 digital parts
    Base revision
    E304 → v16b2.8 mm vertical engagement
    Physical status
    0 samples recordedManufacture BLOCKED

    Engineering analysis & evidence boundaries: In the earlier frozen E304 baseline, male top Z 28.8 and receiver mouth Z 26.0 leave a 2.8 mm shoulder gap with zero receiver engagement. The v16b print-test candidate seats correctly: male bottom Z 23.2, corner receiver floor Z 23.0, and shoulder aligned at Z 26.0, establishing 2.8 mm vertical engagement, a 0.2 mm floor gap, and 0.4 mm nominal lateral clearance per side. Base functions as gravity bearing and lateral registration only; no positive vertical lock or physical load rating. Physical print, fit, load and strength remain unverified; tool attribution does not imply OpenAI endorsement. Reference design: NODESTACK // SERVICE PACK by SMACKMAX_ (@SMACKMAX) on Printables (redistribution license unverified; raw geometry downloads and unreviewed video withheld).

    Watch assembly guide (r03)Explore galleryEngineering analysisWorkflowEvidence JSONMedia manifestRevision r02 (stills)Archive (r01)

  • DC-01 desktop companion, assembled, native Cycles render

    Blender 5.2.0 LTS Cycles 24 samples KiCad 10.0.6 export STL · 3MF FFmpeg H.264

    DC-01 desktop companion: printable parts, a real carrier board, a 39-second assembly film and an A-to-Z tutorial

    18 printable parts through the geometry gate, a KiCad carrier with zero ERC and DRC violations, and a 39-second native animatic. Manufacture not approved.

    Tutorial: how DC-01 was built, A to Z (5 minutes 34 seconds)

    Vietnamese voiceover with English captions; every log line and gate report on screen is copied from the build record · Download the 9:16 version

    Open the reviewPackage README

  • CK-001 reference keyboard, revision B, native Full HD hero render

    Blender 5.2.0 LTS Cycles Full HD export GLB · STL viewer three.js

    CK-001 reference keyboard, built native from one photo

    58 keys and 5 knobs rebuilt from one photo; 781 meshes in a GLB that reopens within 0.05 mm. Reviewable in the browser.

    Tutorial: how CK-001 was built, A to Z (2 minutes 57 seconds)

    Vietnamese voiceover with English captions; every command and excerpt on screen is copied from the build record · Download the 9:16 version

    Open the reviewPackage README

  • Robot arm, overview render

    Robot arm

    Native assembly film, sampled motion checks, exported fit prototypes and a 38-part digital gate report. Loaded operation and physical assembly stay separate.

    Gallery on GitHub
  • Watch-winder capsule, overview render

    Watch-winder capsule

    Native stills, sampled motion checks, digital print-kit checks and fit visualization. Printing and physical fit stay separate.

    Gallery on GitHub
  • Wellhead, overview render

    Wellhead

    Overall and valve details; render review imagery, physical qualification is separate.

    Gallery on GitHub
  • Separator, overview render

    Separator

    Vessel, nozzles and instrumentation; render-only detail set including the repaired vapor interface.

    Gallery on GitHub
  • Exchanger train, overview render

    Exchanger train

    Overview, bellows, instruments and hardware; current R7 HQ imagery with stated technical limits.

    Gallery on GitHub
  • Three-stage exchanger, overview render

    Three-stage exchanger

    Circuit layout and installed instruments; verification previews, HQ delivery in progress.

    Gallery on GitHub
  • Turbine–generator, overview render

    Turbine–generator

    Eight HQ overall and close-up views; refreshed cabinet revision, visual review completed.

    Gallery on GitHub
  • Instrument families, overview render

    Instrument families

    Pressure and temperature mounts shared across assemblies; reuse needs a local origin, a mounting interface and verification in the receiving assembly.

    Gallery on GitHub

Install and use

Requirements: Blender 5.2.x, Python 3.10+, macOS or Linux. The host-side tests use the Python standard library only.

0 · Model Context Protocol (MCP) — For Humans & AI

Instant zero-install setup via uvx. Equips Claude Desktop, Cursor, Antigravity, and Cline with verified Blender 5.2 knowledge, mechanical spec validation, and headless pass execution.

# Zero-install execution (runs anywhere without local setup):
uvx design-os-3d-blender

# Client configuration (Claude Desktop, Cursor, Antigravity, Cline):
{
  "mcpServers": {
    "design-os-3d-blender": {
      "command": "uvx",
      "args": ["design-os-3d-blender"],
      "env": {
        "BLENDER_BIN": "/Applications/Blender.app/Contents/MacOS/Blender"
      }
    }
  }
}

1 · check the install

Point the scripts at your Blender binary, verify the knowledge catalogue, run the host tests.

git clone https://github.com/jangtrinh/design-os-3d-blender.git && cd design-os-3d-blender
export BLENDER_BIN=/Applications/Blender.app/Contents/MacOS/Blender
python3 scripts/blender-knowledge.py check
python3 -m unittest discover -s tests/execution

2 · run a pass headless

Every pass runs in an isolated Blender process and ends with a sentinel; success is AGENT_OK on the last line, never the exit code.

bash scripts/headless-run.sh my-pass.py

3 · or interactively over MCP

Open the blender-mcp addon in Blender’s sidebar (N → BlenderMCP → Connect), then run the same pass through the runtime from your agent CLI.

import sys; sys.path.insert(0, "<ROOT>/scripts")
import agent_runtime as rt
rt.run_file("<ROOT>/builds/<slug>/pass-01.py")

4 · gate a printable part

Write the spec before detailing; the gate checks the scene against it and writes a report. A digital gate does not establish physical fit, load, pressure, thermal duty or a successful print.

mkdir -p builds/my-part && cp specs/examples/bracket-m3.spec.json builds/my-part/spec.json
python3 scripts/production-gate.py --scene builds/my-part/part.blend --spec builds/my-part/spec.json --report builds/my-part/gate-report.json

Tools and skills

Model Context Protocol Server

FastMCP server exposing runtime inspection, verified bpy 5.2 knowledge base search, and spec validation tools with zero Blender dependency.

Core Blender skill

Native scene execution, numerical checks and delivery recipes. blender-agent-core

Image reconstruction skill

Reference contracts, staged modeling and construction-aware visual review. blender-image-to-3d

Knowledge workbench

Bounded reading packs and reviewed source routing over the verified bpy knowledge base.

Native pass pipeline

Declared step dependencies, durable attempt journals and hash-checked resumption; execution status stays separate from acceptance.

Verification and production gate

Scene checks, isolated previews, spec-bound digital geometry and export evidence; HQ coverage receipts before a guarded render.

MakerWorld publishing leg

Bambu project validation and the documented publishing constraints.

DESIGN:OS Ecosystem

Modular toolchain for AI coding agents: from interface CLI to deterministic animation, 3D CAD and robotics.

DESIGN:OS CLI — Multi-runtime design CLI for Claude Code, Codex & Antigravitycli Knowledge Builder — Multimodal knowledge compiler with UKMC.v1 contract & epistemic gatecompiler Figma Plugin & CLI — Live canvas bridge for AI coding agents on Figma Freeplugin SVG Animation Engine — Deterministic vector animation & 1080p 60fps video pipelineengine 3D Blender Agent — Mechanical parts generation with embedded Three.js CAD viewer3d / cad OPAH ONE — 249g indoor drone showcase with scroll-scrub kinematicshardware GitHub Pages Engine — 9-tier zero-dependency scaffolder with SEO, AEO & GEOpages Apple Design OS — Native SwiftUI 6.2 component system for iOS, iPadOS & macOSswiftui Agent Teacher — Evidence-graded pedagogy library and curriculum tree runtimepedagogy Origami CAD — Parametric packaging dielines, spot-color PDFs & 3D fold previewspackaging Voice UX & AI Agent Architecture — Full-duplex barge-in FSMs & sub-500ms voice specsvoice-ai Code2Flow — Local-first codebase-to-user-flow audit CLI across 7 UI frameworksast / audit Generative UI — Streaming interactive visual runtime with morphdom & WebGLruntime

Read next

README: galleries, quick start, tools, evidence boundariesgithub How a delivered package becomes a public review pageprocedure CK-001 revision B review with the 3D viewerreview Reconstruction workflow for a component from referencesdocs Knowledge base indexknowledge AGENTS.md: the execution loop and the verify ladderrules

Watch

Three videos from the design:os by Jang channel. Thumbnails are self-hosted; the player loads only when you press play.

  • How to use design os 3d blender repo - ep 1 (YouTube, 2:57)2:57

    Ep 1: CK-001 keyboard

  • How to use design os 3d blender repo - ep 2 (YouTube, 5:34)5:34

    Ep 2: DC-01 desk robot

  • Fanmade 3D model for Nowa planet - by design os 3d blender (YouTube, 0:27)0:27

    Fan-made Nowa model (Short)

More on the channel

Listed on

  • Listed on mcpservers.org
  • Featured AI Agents on AI Agents Directory