DESIGN:OS 3D Blender Agent (design-os-3d-blender)

Parametric 3D mechanical parts generator, headless Blender Python (bpy) pipeline, and embedded Three.js CAD showcase engine.

Generate dimensionally accurate gears, enclosures, drone frames, and exploded mechanical assemblies from plain-English specs or JSON parameters, complete with glTF/STL exports and interactive browser inspection.

Quickstart · What it makes · Install · How it works · Commands · Limits

---

Why this exists

Text-to-3D diffusion models produce melted, non-manifold blobs that cannot be 3D-printed, machined, or cleanly animated in web viewers. design-os-3d-blender drives Blender's Python API (bpy) and Three.js deterministically to produce crisp mechanical geometry and interactive CAD showcases.

Dimension	Generic AI / Manual Workflow	DESIGN:OS 3D Blender Agent (DESIGN:OS)
Geometry Quality	Melted AI diffusion meshes with non-manifold holes	Clean parametric bpy booleans, bevels, and precision vertex topology
Dimensional Accuracy	Arbitrary unscaled units that fail in slicers	Millimeter-locked parametric dimensions and bounding-box verification
Web Inspection	Static screenshots with no way to inspect hidden faces	Embedded Three.js CAD viewer with orbit controls, wireframe, and exploded scrub
Reproducibility	Unrepeatable random seeds	Git-tracked Python generator scripts and declarative JSON part specs
Privacy & Telemetry	Opaque cloud telemetry or unverified third-party APIs	Zero telemetry — 100% local execution (PRIVACY.md audited)

---

Quickstart

1. Install the plugin or CLI

In Claude Code:

/plugin marketplace add jangtrinh/design-os-3d-blender
/plugin install design-os-3d-blender@design-os-3d-blender

Or from your terminal (Codex, Gemini CLI, Antigravity, OpenCode, or standalone CLI):

git clone https://github.com/jangtrinh/design-os-3d-blender.git
cd design-os-3d-blender
python3 scripts/self_check.py

2. Ask in plain English

Open your project in your AI coding agent and describe what you need:

"Generate a parametric 24-tooth helical gear and mounting bracket in headless Blender and export glTF + STL artifacts."

"Build an interactive Three.js CAD viewer page with exploded-view scrubbing, wireframe toggle, and orthographic camera presets."

"Audit the exported mesh topology for non-manifold edges, zero-area faces, and bounding-box dimensional tolerances."

3. Verify your setup

python3 scripts/self_check.py

---

What it makes

Every deliverable produced by design-os-3d-blender is backed by a deterministic verification gate rather than freehand AI guesswork.

Prompt: "Generate a parametric 24-tooth helical gear and mounting bracket in headless Blender and export glTF + STL artifacts."