blender-agent-core

design-os-3d-blender

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.

Live site · Installation · MCP config · Worked builds · Host tests · design:os ecosystem

Native renders from the worked builds

Rendered in Blender, no added captions or banners. Names, development status and evidence limits live next to each build. Media provenance · the full set on the live site.

Worked builds

Nodestack · project story

Read the Nodestack review r03 & watch the assembly guide (stills r02, archive r01) — a Blender native modular-storage study with 2×2, 2×3 and 4×2 digital configurations. OpenAI Dots coordinated Antigravity planning/building and separate evidence-based reviews, featuring a 102s procedural assembly-guide video, verified 7-view still gallery, and base-seating engineering analysis.

The reference design is NODESTACK // SERVICE PACK by SMACKMAX_. Geometry/export checks cover 32/45/68 parts; physical print, fit, load and strength remain unverified. This publication shares an authorized 102s procedural assembly guide and native still views; raw geometry downloads and other unreviewed videos are held while reference-design redistribution rights remain unverified. Tool attribution does not imply OpenAI endorsement.

Two builds ship a public review page with the delivered package beside it.

Mechanical products

Geothermal ORC components

ORC images are derivatives of native renders; their source models are not in this public checkout.

The plant layout uses an illustrative 1:15 scale. Catalogue dimensions and installation manuals support specific modeling decisions; they do not establish a selected vendor package, plant capacity or as-built engineering design. A component gallery is not evidence that the complete site has been integrated or qualified.

Reusable parts

Instrument families and mounting details show the parts shared across assemblies. Reuse requires a defined local origin, a mounting interface, supported parameters and verification in the receiving assembly.

Installation

Run directly via uvx (zero local package install required):

uvx design-os-3d-blender

Or run from GitHub source:

uvx --from git+https://github.com/jangtrinh/design-os-3d-blender design-os-3d-blender

Or install via pip:

pip install design-os-3d-blender

MCP client configuration

Add the paste-ready block to your client configuration:

Quickstart (Knowledge & Specs — runs anywhere with zero Blender installation)

{
  "mcpServers": {
    "design-os-3d-blender": {
      "command": "uvx",
      "args": ["design-os-3d-blender"]
    }
  }
}

Full Execution Mode (With local Blender 5.2 LTS)

{
  "mcpServers": {
    "design-os-3d-blender": {
      "command": "uvx",
      "args": ["design-os-3d-blender"],
      "env": {
        "BLENDER_BIN": "/Applications/Blender.app/Contents/MacOS/Blender"
      }
    }
  }
}

Client Setup Locations

• Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows).
• Cursor: Open Settings → Features → MCP → Click `Add New M