Skip to content
Back to search

design-os-3d-blender

AI agent operating system for Blender 5.2: bpy knowledge base, AGENT_OK execution contract, 3D-print production gate, worked keyboard and desktop-robot builds.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026. Its scripts were only partly scanned.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/jangtrinh/design-os-3d-blender with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/jangtrinh/design-os-3d-blender'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/jangtrinh--design-os-3d-blender/badge.svg)](/listings/jangtrinh--design-os-3d-blender)

HTML

<a href="/listings/jangtrinh--design-os-3d-blender"><img src="/api/listings/jangtrinh--design-os-3d-blender/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

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 was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 15 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. {
  2. "name": "design-os-3d-blender",
  3. "metadata": {
  4. "description": "Parametric 3D mechanical parts generator, headless Blender Python (`bpy`) pipeline, and embedded Three.js CAD showcase engine."
  5. },
  6. "owner": {
  7. "name": "Jang Trinh"
  8. },
  9. "plugins": [
  10. {
  11. "name": "design-os-3d-blender",
  12. "source": "./"
  13. }
  14. ]
  15. }
README.md · README · 245 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # DESIGN:OS 3D Blender
  2. <p>
  3. <picture>
  4. <source media="(prefers-color-scheme: dark)" srcset="docs/images/readme/cover-dark.png">
  5. <source media="(prefers-color-scheme: light)" srcset="docs/images/readme/cover-light.png">
  6. <img src="docs/images/readme/cover-dark.png" alt="design:os by Jang" width="100%">
  7. </picture>
  8. </p>
  9. **An MCP server and agent skill for Blender 5.2.** Your coding agent models, renders and checks mechanical parts on your machine: four tools, an `AGENT_OK` contract, and a 3D-print production gate. Specs are locked to millimeters. Exports are STL and glTF.
  10. FREE + source-available ([PolyForm Shield 1.0.0](LICENSE)).
  11. <p>
  12. <a href="#quickstart">Quickstart</a> · <a href="#what-it-makes">What it makes</a> · <a href="#how-it-works">How it works</a> · <a href="#install">Install</a> · <a href="#limits">Limits</a>
  13. </p>
  14. <p align="left">
  15. <a href="LICENSE"><img src="https://img.shields.io/badge/license-PolyForm_Shield_1.0.0-202020?style=flat-square&labelColor=202020&color=444444" alt="PolyForm Shield 1.0.0 License"></a>
  16. <a href="https://jangtrinh.github.io/design-os-3d-blender/"><img src="https://img.shields.io/badge/live_docs-GitHub_Pages-202020?style=flat-square&labelColor=202020&color=444444" alt="Live GitHub Pages"></a>
  17. </p>
  18. ## Quickstart
  19. **In Claude Code:**
  20. ```text
  21. /plugin marketplace add jangtrinh/design-os-3d-blender
  22. /plugin install design-os-3d-blender@design-os-3d-blender
  23. ```
  24. **From a clone** (Codex, Gemini CLI, Antigravity, Cursor, or a standalone MCP client):
  25. ```bash
  26. git clone https://github.com/jangtrinh/design-os-3d-blender.git
  27. cd design-os-3d-blender
  28. python3 scripts/self_check.py
  29. pip install .
  30. ```
  31. Point your MCP client at the installed command, and set `BLENDER_BIN` to your Blender 5.2 binary:
  32. ```json
  33. {
  34. "mcpServers": {
  35. "design-os-3d-blender": {
  36. "command": "design-os-3d-blender",
  37. "env": {
  38. "BLENDER_BIN": "/Applications/Blender.app/Contents/MacOS/Blender"
  39. }
  40. }
  41. }
  42. }
  43. ```
  44. On Linux the binary is often `/usr/bin/blender`. The first tool will tell you if it cannot find it. If you use `uv`, `uv run design-os-3d-blender` from this repository starts the same server, with no need to publish a package.
  45. Ask for a part in plain English. A typical pass validates a `spec.json`, runs a headless bpy script, and stops on one line: `AGENT_OK` or `AGENT_FAIL`.
  46. ## What it makes
  47. These are real builds from this repository, made in Blender 5.2 through the agent pipeline.
  48. <p>
  49. <img src="docs/images/readme/builds/ck-001.jpg" alt="design:os by Jang" width="49%">
  50. <img src="docs/images/readme/builds/dc-01-exploded.jpg" alt="design:os by Jang" width="49%">
  51. </p>
  52. <p>
  53. <img src="docs/images/readme/builds/robot-arm.jpg" alt="design:os by Jang" width="49%">
  54. <img src="docs/images/readme/builds/nodestack.jpg" alt="design:os by Jang" width="49%">
  55. </p>
  56. | Build | What it is | In this repo |
  57. | :--- | :--- | :--- |
  58. | CK-001 | A compact keyboard, from photo and spec to a printable kit | [`docs/reviews/ck-001/r02`](docs/reviews/ck-001/r02) |
  59. | DC-01 | A desk robot: printed parts, a carrier board, an assembly film | [`docs/reviews/dc-01/r03`](docs/reviews/dc-01/r03) |
  60. | Robot arm | A printable arm, with gated plates | [`builds/robot-arm-print-assembly`](builds/robot-arm-print-assembly) |
  61. | Nodestack | Modular industrial storage | [`docs/reviews/nodestack/r03`](docs/reviews/nodestack/r03) |
  62. <p>
  63. <img src="docs/images/readme/builds/dc-01-assembled.jpg" alt="design:os by Jang" width="49%">
  64. <img src="docs/images/readme/builds/blender-window.jpg" alt="design:os by Jang" width="49%">
  65. </p>
  66. DC-01 assembled, and the printable robot arm open in a real Blender 5.2 window. Print plates for the arm are in [`docs/images/readme/builds/print-plates.jpg`](docs/images/readme/builds/print-plates.jpg) and [`docs/media/robot-arm-print-plates.png`](docs/media/robot-arm-print-plates.png).
  67. ## How it works
  68. <p>
  69. <picture>
  70. <source media="(prefers-color-scheme: dark)" srcset="docs/images/readme/flow-dark.png">
  71. <source media="(prefers-color-scheme: light)" srcset="docs/images/readme/flow-light.png">
  72. <img src="docs/images/readme/flow-dark.png" alt="design:os by Jang" width="100%">
  73. </picture>
  74. </p>
  75. The MCP server exposes **four tools**. That is the count in `src/design_os_3d_blender_mcp/server.py` on this branch:
  76. | Tool | What it does |
  77. | :--- | :--- |
  78. | `blender_runtime_status` | Host, Python, and whether a Blender 5.2 binary is on the path. Call this first. |
  79. | `query_blender_knowledge` | Search the verified bpy 5.2 knowledge base in `knowledge/` before writing a script. |
  80. | `validate_part_spec` | Check a `spec.json`: units in mm, target dimensions, tolerance, minimum wall. |
  81. | `execute_blender_pass` | Run a headless pass and read the `AGENT_OK` or `AGENT_FAIL` line. |
  82. Two prompts (`design_parametric_part`, `review_geometry_gate`) and two resources (`blender://knowledge/index`, `blender://specs/bracket-example`) sit next to the tools. They are not extra tools.
  83. Every executed pass ends with one machine-readable line. Exit codes alone are not a verdict. The 3D-print production gate checks manifold geometry, wall thickness and millimeter-locked bounds. Worked specs live in `specs/` and `builds/`.
  84. The Claude Code, Codex and other agent plugins install the same skill, [`skills/design-os-3d-blender/SKILL.md`](skills/design-os-3d-blender/SKILL.md). `/doctor` is a read-only diagnostic. `python3 scripts/self_check.py` is the offline repository check: it prints `ok: design-os-3d-blender self-check passed (design-os-3d-blender)` and exits 0 when the manifests and contracts match.
  85. Nothing in the server sends data off your machine. See [`PRIVACY.md`](PRIVACY.md).
  86. ## Install
  87. Choose the setup that matches your agent. Every option uses the same skill at `skills/design-os-3d-blender/SKILL.md`.
  88. ### Claude Code
  89. ```text
  90. /plugin marketplace add jangtrinh/design-os-3d-blender
  91. /plugin install design-os-3d-blender@design-os-3d-blender
  92. ```
  93. ### OpenAI Codex
  94. ```bash
  95. git clone https://github.com/jangtrinh/design-os-3d-blender.git /tmp/design-os-3d-blender
  96. mkdir -p ~/.codex/skills/design-os-3d-blender ~/.codex/prompts
  97. cp -R /tmp/design-os-3d-blender/skills/design-os-3d-blender/* ~/.codex/skills/design-os-3d-blender/
  98. cp /tmp/design-os-3d-blender/prompts/doctor.md ~/.codex/prompts/design-os-3d-blender-doctor.md
  99. rm -rf /tmp/design-os-3d-blender
  100. ```
  101. ### Gemini CLI and Google Antigravity
  102. ```bash
  103. git clone https://github.com/jangtrinh/design-os-3d-blender.git /tmp/design-os-3d-blender
  104. mkdir -p ~/.gemini/skills/design-os-3d-blender
  105. cp -R /tmp/design-os-3d-blender/skills/design-os-3d-blender/* ~/.gemini/skills/design-os-3d-blender/
  106. rm -rf /tmp/design-os-3d-blender
  107. ```
  108. ### OpenCode, Cursor, Windsurf and other agent harnesses
  109. ```bash
  110. git clone https://github.com/jangtrinh/design-os-3d-blender.git /tmp/design-os-3d-blender
  111. mkdir -p ~/.agents/skills/design-os-3d-blender
  112. cp -R /tmp/design-os-3d-blender/skills/design-os-3d-blender/* ~/.agents/skills/design-os-3d-blender/
  113. rm -rf /tmp/design-os-3d-blender
  114. ```
  115. <details>
  116. <summary>Verify or uninstall</summary>
  117. **Verify:**
  118. ```bash
  119. python3 scripts/self_check.py
  120. ```
  121. Or run `/doctor` inside Claude Code or Codex to inspect installed skill paths, plugin manifests, and whether Blender is reachable.
  122. **Uninstall the skill copies:**
  123. ```bash
  124. rm -rf ~/.claude/skills/design-os-3d-blender ~/.codex/skills/design-os-3d-blender ~/.gemini/skills/design-os-3d-blender ~/.agents/skills/design-os-3d-blender
  125. ```
  126. </details>
  127. Prompt recipes live in [`docs/cookbook.md`](docs/cookbook.md). More setup notes are in [`docs/antigravity-setup.md`](docs/antigravity-setup.md) and [`docs/upstream-agent-integration.md`](docs/upstream-agent-integration.md).
  128. ## Limits
  129. - Sheet-metal or paperboard folding, where 2D crease patterns govern the topology: use [`design-os-origami`](https://github.com/jangtrinh/design-os-origami).
  130. - Organic character sculpting or a full game-character rig that needs a sculptor's pass.
  131. - 2D vector UI motion: use [`design-os-svg-animation`](https://github.com/jangtrinh/design-os-svg-animation).
  132. ## Watch
  133. A FREE, source-available (PolyForm Shield) agent pipeline for Blender 5.2. Videos from the [design:os by Jang](https://www.youtube.com/@designosbyjang) channel (Vietnamese, with English terms):
  134. <p align="left">
  135. <a href="https://www.youtube.com/watch?v=J2Malrlb_PM"><img src="docs/images/video/J2Malrlb_PM.jpg" alt="design:os by Jang" width="320"></a>
  136. <a href="https://www.youtube.com/watch?v=LKL7ZHMz5KI"><img src="docs/images/video/LKL7ZHMz5KI.jpg" alt="design:os by Jang" width="320"></a>
  137. <a href="https://www.youtube.com/watch?v=XSKZYudfMt8"><img src="docs/images/video/XSKZYudfMt8.jpg" alt="design:os by Jang" width="320"></a>
  138. </p>
  139. - [How to use design os 3d blender repo - ep 1](https://www.youtube.com/watch?v=J2Malrlb_PM) (2:57). Episode 1: building a keyboard (CK-001) end to end: photo, spec, gates, STL and GLB export. Vietnamese.
  140. - [How to use design os 3d blender repo - ep 2](https://www.youtube.com/watch?v=LKL7ZHMz5KI) (5:34). Episode 2: the DC-01 desk robot with 29 mechanical revisions, four gated runs and a printable kit. Vietnamese.
  141. - [Fanmade 3D model for Nowa planet - by design os 3d blender](https://www.youtube.com/watch?v=XSKZYudfMt8) (0:27). A 27-second fan-made 3D model of the Nowa desktop product, built with design-os-3d-blender.
  142. More: [design:os by Jang on YouTube](https://www.youtube.com/@designosbyjang).
  143. ## DESIGN:OS
  144. This is one of the DESIGN:OS tools. The others: [Studio](https://github.com/jangtrinh/design-os-studio), [CLI](https://github.com/jangtrinh/design-os), [Bridge](https://github.com/jangtrinh/design-os-figma-plugin), [SVG Animation](https://github.com/jangtrinh/design-os-svg-animation), [Code2Flow](https://github.com/jangtrinh/design-os-code2flow), [Knowledge Builder](https://github.com/jangtrinh/design-os-knowledge-builder) and more on [jangtrinh.github.io](https://jangtrinh.github.io/).
  145. | Engine | Live docs | Repository |
  146. | :--- | :--- | :--- |
  147. | DESIGN:OS CLI | [jangtrinh.github.io/design-os](https://jangtrinh.github.io/design-os/) | [`jangtrinh/design-os`](https://github.com/jangtrinh/design-os) |
  148. | Knowledge Builder | [jangtrinh.github.io/design-os-knowledge-builder](https://jangtrinh.github.io/design-os-knowledge-builder/) | [`jangtrinh/design-os-knowledge-builder`](https://github.com/jangtrinh/design-os-knowledge-builder) |
  149. | DESIGN:OS Bridge | [jangtrinh.github.io/design-os-figma-plugin](https://jangtrinh.github.io/design-os-figma-plugin/) | [`jangtrinh/design-os-figma-plugin`](https://github.com/jangtrinh/design-os-figma-plugin) |
  150. | SVG Animation Engine | [jangtrinh.github.io/design-os-svg-animation](https://jangtrinh.github.io/design-os-svg-animation/) | [`jangtrinh/design-os-svg-animation`](https://github.com/jangtrinh/design-os-svg-animation) |
  151. | 3D Blender | [jangtrinh.github.io/design-os-3d-blender](https://jangtrinh.github.io/design-os-3d-blender/) | [`jangtrinh/design-os-3d-blender`](https://github.com/jangtrinh/design-os-3d-blender) |
  152. | OPAH ONE Drone | [jangtrinh.github.io/design-os-drone-showcase](https://jangtrinh.github.io/design-os-drone-showcase/) | [`jangtrinh/design-os-drone-showcase`](https://github.com/jangtrinh/design-os-drone-showcase) |
  153. | GitHub Pages Engine | [jangtrinh.github.io/design-os-github-page](https://jangtrinh.github.io/design-os-github-page/) | [`jangtrinh/design-os-github-page`](https://github.com/jangtrinh/design-os-github-page) |
  154. | Apple Design OS | [jangtrinh.github.io/design-os-apple](https://jangtrinh.github.io/design-os-apple/) | [`jangtrinh/design-os-apple`](https://github.com/jangtrinh/design-os-apple) |
  155. | Agent Teacher | [jangtrinh.github.io/design-os-pedagogy](https://jangtrinh.github.io/design-os-pedagogy/) | [`jangtrinh/design-os-pedagogy`](https://github.com/jangtrinh/design-os-pedagogy) |
  156. | Origami CAD | [jangtrinh.github.io/design-os-origami](https://jangtrinh.github.io/design-os-origami/) | [`jangtrinh/design-os-origami`](https://github.com/jangtrinh/design-os-origami) |
  157. | Voice UX Architecture | [jangtrinh.github.io/design-os-voice-ux](https://jangtrinh.github.io/design-os-voice-ux/) | [`jangtrinh/design-os-voice-ux`](https://github.com/jangtrinh/design-os-voice-ux) |
  158. | Code2Flow | [jangtrinh.github.io/design-os-code2flow](https://jangtrinh.github.io/design-os-code2flow/) | [`jangtrinh/design-os-code2flow`](https://github.com/jangtrinh/design-os-code2flow) |
  159. | Generative UI | [jangtrinh.github.io/design-os-generative-ui](https://jangtrinh.github.io/design-os-generative-ui/) | [`jangtrinh/design-os-generative-ui`](https://github.com/jangtrinh/design-os-generative-ui) |
  160. Docs: [jangtrinh.github.io/design-os-3d-blender](https://jangtrinh.github.io/design-os-3d-blender/) · Changelog: [`CHANGELOG.md`](CHANGELOG.md) · Index for AI agents: [`llms.txt`](llms.txt)
  161. ## Contributing and license
  162. - [`CONTRIBUTING.md`](CONTRIBUTING.md) · [`CODE_OF_CONDUCT.md`](CODE_OF_CONDUCT.md) · [`SECURITY.md`](SECURITY.md) · [`PRIVACY.md`](PRIVACY.md)
  163. - [PolyForm Shield 1.0.0](LICENSE). FREE to use and modify, including for paid client work; you may not resell it or build a competing product from it.
  164. ## Built by
  165. Built by [Jang Trịnh](https://github.com/jangtrinh), creative technologist and autonomous system architect. More projects, case studies and writing at [jang.work](https://www.jang.work/?utm_source=github&utm_medium=readme&utm_campaign=design-os-3d-blender).
  166. [GitHub](https://github.com/jangtrinh) · [LinkedIn](https://www.linkedin.com/in/jangtrinh/) · [Hub](https://jangtrinh.github.io/) · [YouTube](https://www.youtube.com/@designosbyjang) · [X](https://x.com/Jangtrinhvn)
  167. ## Listed on
  168. <p align="left">
  169. <a href="https://mcpservers.org/servers/jangtrinh/design-os-3d-blender"><img src="https://mcpservers.org/badge.svg" alt="Listed on mcpservers.org" width="163" height="20"></a>
  170. <a href="https://aiagentsdirectory.com?utm_source=badge&utm_medium=referral&utm_campaign=free_listing&utm_content=homepage"><img src="https://aiagentsdirectory.com/featured-badge.svg?v=2024" alt="Featured AI Agents on AI Agents Directory" width="160" height="40"></a>
  171. </p>
  172. Also listed in the [Official MCP Registry](https://registry.modelcontextprotocol.io/v0/servers?search=design-os-3d-blender) (`io.github.jangtrinh/design-os-3d-blender`), the [awesome-mcp-servers list by TensorBlock](https://github.com/TensorBlock/awesome-mcp-servers/blob/main/docs/art-culture--media.md) and [SkillsMP](https://skillsmp.com/creators/jangtrinh).
  173. If `design-os-3d-blender` saves you time, a star on GitHub helps other engineers and AI agents find it.
  174. <p align="left">
  175. <a href="https://buymeacoffee.com/jangtrinh">
  176. <img src="https://img.shields.io/badge/Buy_Me_a_Coffee-FFDD00?style=for-the-badge&logo=buy-me-a-coffee&logoColor=black" alt="Buy Me a Coffee">
  177. </a>
  178. </p>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.