jangtrinh/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.
design-os-3d-blender is a free MCP server (Model Context Protocol, stdio) for Blender. Connect it to Claude Code, Codex, Cursor or any MCP client to model, render and verify parts in Blender 5.2 LTS. Free, nothing sold, source-available under PolyForm Shield 1.0.0.
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:
text
/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):
bash
git clone https://github.com/jangtrinh/design-os-3d-blender.git
cd design-os-3d-blender
python3 scripts/selfcheck.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
bash
python3 scripts/selfcheck.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."
| Deliverable / Mode | Best for | Output Format | Verification Gate |
| Parametric bpy Part Scripts | Reproducible headless Blender generation for brackets, gears, and housings | Python (.py) + JSON spec | Zero non-manifold edges |