render
Skill26k starsChanged 5 days agoMITView on GitHub
Renders photoreal images and videos of a text-to-cad model, a STEP or an xbf with Blender, for people to look at, such as a hero shot, a README picture, a product post, a turntable or a film of a model's motion or animation. Exports a GLB, loads it with cad.blender, lights and frames it in a bpy script that `cad run` runs, drafts in EEVEE and finishes in Cycles on the GPU, and can save a .blend. Not for checking geometry, which a snapshot does.
- Pipes a download into a shell
17 other projects use a version of this.
Adopted by
Steady: 0 new projects took it in the last 4 weeks, none the 4 weeks before.thin data
Most recently taken up by
- langchain-ai/lca-managed-agentstheir own version, first seen Nov 15, 2026
- pche-broken-artist/forge-of-thoughttheir own version, first seen Nov 10, 2026
- hiroqt/overdrivetheir own version, first seen Nov 1, 2026
- harshil-1411/claude_plugin_video_studiotheir own version, first seen Oct 17, 2026
- G1Joshi/Agent-Skillstheir own version, first seen Oct 13, 2026
- TheSethRose/render-skilltheir own version, first seen Oct 13, 2026
Who's talking about earthtojake/text-to-cad
- GitHub“Open source project of the week: text-to-cad”YouTube · May 31, 2026 · 7.4k views
- Tool Man“Text to CAD: This Free AI Designs Real Parts You Can 3D Print”YouTube · Oct 11, 2026 · 2.3k views
- Alex Hitt“Text-to-CAD GitHub Tutorial: Build123d, STEP Models and AI Agent Setup”YouTube · Sep 8, 2026 · 2.1k views
- The Next New Thing“Text-to-CAD — Describe a Part, Get a Real 3D Model”YouTube · Oct 26, 2026 · 1.8k views
- Blueprint Bytes“Blueprint Bytes | Text-to-CAD: Open-Source AI Harness for Parametric 3D Modeling & CAD Generation”YouTube · Aug 18, 2026 · 1.6k views
The biggest 5 of 88 mentions linking to the repository that our crawl found. Each line is their own headline.
See all 88
Talked about on GitHub, YouTube, Bluesky, the web and Hacker News (88 times).
On GitHub · 50
- Nov 13, 2026codex-plugins.github.earthtojake.text-to-cad: 0.11.9 → 0.11.10 — sudosubin/agents.nix0 reactions
- Nov 13, 2026agent-skills.github.earthtojake.text-to-cad: 0.11.9 → 0.11.10 — sudosubin/agents.nix0 reactions
- Nov 13, 2026claude-code-marketplaces.github.earthtojake.text-to-cad: 0.11.9 → 0.11.10 — sudosubin/agents.nix0 reactions
- Nov 13, 2026agent-plugins.github.earthtojake.text-to-cad: 0.11.9 → 0.11.10 — sudosubin/agents.nix0 reactions
- Nov 13, 2026claude-code-plugins.github.earthtojake.text-to-cad: 0.11.9 → 0.11.10 — sudosubin/agents.nix0 reactions
45 more on GitHub
- Nov 13, 2026Docs + example: check parts from CAD agents (text-to-cad, build123d, OpenSCAD) with meshsim — armaan-crypto/meshsim0 reactions
- Nov 13, 2026List meshsim mcp in the official MCP Registry: server.json, README mcp-name marker, release job — armaan-crypto/meshsim0 reactions
- Nov 12, 2026claude-code-marketplaces.github.earthtojake.text-to-cad: 0.11.8 → 0.11.9 — sudosubin/agents.nix0 reactions
- Nov 12, 2026agent-plugins.github.earthtojake.text-to-cad: 0.11.8 → 0.11.9 — sudosubin/agents.nix0 reactions
- Nov 12, 2026claude-code-plugins.github.earthtojake.text-to-cad: 0.11.8 → 0.11.9 — sudosubin/agents.nix0 reactions
- Nov 11, 2026agent-skills.github.earthtojake.text-to-cad: 0.11.8 → 0.11.9 — sudosubin/agents.nix0 reactions
- Nov 11, 2026codex-plugins.github.earthtojake.text-to-cad: 0.11.8 → 0.11.9 — sudosubin/agents.nix0 reactions
- Nov 11, 2026claude-code-plugins.github.earthtojake.text-to-cad: 0.11.7 → 0.11.8 — sudosubin/agents.nix0 reactions
- Nov 11, 2026agent-plugins.github.earthtojake.text-to-cad: 0.11.7 → 0.11.8 — sudosubin/agents.nix0 reactions
- Nov 11, 2026Update dependencies — maxstreese/maxcad0 reactions
- Nov 11, 2026codex-plugins.github.earthtojake.text-to-cad: 0.11.7 → 0.11.8 — sudosubin/agents.nix0 reactions
- Nov 11, 2026agent-skills.github.earthtojake.text-to-cad: 0.11.7 → 0.11.8 — sudosubin/agents.nix0 reactions
- Nov 11, 2026claude-code-marketplaces.github.earthtojake.text-to-cad: 0.11.7 → 0.11.8 — sudosubin/agents.nix0 reactions
- Nov 11, 2026codex-plugins.github.earthtojake.text-to-cad: 0.11.6 → 0.11.7 — sudosubin/agents.nix0 reactions
- Nov 10, 2026agent-skills.github.earthtojake.text-to-cad: 0.11.4 → 0.11.7 — sudosubin/agents.nix0 reactions
- Nov 10, 2026claude-code-marketplaces.github.earthtojake.text-to-cad: 0.11.6 → 0.11.7 — sudosubin/agents.nix0 reactions
- Nov 10, 2026claude-code-plugins.github.earthtojake.text-to-cad: 0.11.6 → 0.11.7 — sudosubin/agents.nix0 reactions
- Nov 10, 2026agent-plugins.github.earthtojake.text-to-cad: 0.11.6 → 0.11.7 — sudosubin/agents.nix0 reactions
- Nov 10, 2026claude-code-marketplaces.github.earthtojake.text-to-cad: 0.11.5 → 0.11.6 — sudosubin/agents.nix0 reactions
- Nov 10, 2026agent-plugins.github.earthtojake.text-to-cad: 0.11.5 → 0.11.6 — sudosubin/agents.nix0 reactions
- Nov 10, 2026claude-code-plugins.github.earthtojake.text-to-cad: 0.11.5 → 0.11.6 — sudosubin/agents.nix0 reactions
- Nov 10, 2026codex-plugins.github.earthtojake.text-to-cad: 0.11.4 → 0.11.6 — sudosubin/agents.nix0 reactions
- Nov 10, 2026claude-code-marketplaces.github.earthtojake.text-to-cad: 0.11.4 → 0.11.5 — sudosubin/agents.nix0 reactions
- Nov 10, 2026agent-plugins.github.earthtojake.text-to-cad: 0.11.4 → 0.11.5 — sudosubin/agents.nix0 reactions
- Nov 10, 2026claude-code-plugins.github.earthtojake.text-to-cad: 0.11.4 → 0.11.5 — sudosubin/agents.nix0 reactions
- Nov 9, 2026claude-code-marketplaces.github.earthtojake.text-to-cad: 0.11.3 → 0.11.4 — sudosubin/agents.nix0 reactions
- Nov 9, 2026codex-plugins.github.earthtojake.text-to-cad: 0.11.3 → 0.11.4 — sudosubin/agents.nix0 reactions
- Nov 9, 2026claude-code-plugins.github.earthtojake.text-to-cad: 0.11.3 → 0.11.4 — sudosubin/agents.nix0 reactions
- Nov 9, 2026agent-plugins.github.earthtojake.text-to-cad: 0.11.3 → 0.11.4 — sudosubin/agents.nix0 reactions
- Nov 9, 2026agent-skills.github.earthtojake.text-to-cad: 0.11.3 → 0.11.4 — sudosubin/agents.nix0 reactions
- Nov 9, 2026Reference health: open findings — Valpatel/cad-agent0 reactions
- Nov 9, 2026vendor: pull text-to-cad 1cfd73cb — gurul/gencad0 reactions
- Nov 8, 2026agent-plugins.github.earthtojake.text-to-cad: 0.11.1 → 0.11.3 — sudosubin/agents.nix0 reactions
- Nov 8, 2026claude-code-plugins.github.earthtojake.text-to-cad: 0.11.1 → 0.11.3 — sudosubin/agents.nix0 reactions
- Nov 8, 2026agent-skills.github.earthtojake.text-to-cad: 0.11.2 → 0.11.3 — sudosubin/agents.nix0 reactions
- Nov 8, 2026claude-code-marketplaces.github.earthtojake.text-to-cad: 0.11.2 → 0.11.3 — sudosubin/agents.nix0 reactions
- Nov 8, 2026codex-plugins.github.earthtojake.text-to-cad: 0.11.1 → 0.11.3 — sudosubin/agents.nix0 reactions
- Nov 8, 2026Update dependencies — maxstreese/maxcad0 reactions
- Nov 8, 2026agent-skills.github.earthtojake.text-to-cad: 0.11.1 → 0.11.2 — sudosubin/agents.nix0 reactions
- Nov 8, 2026claude-code-marketplaces.github.earthtojake.text-to-cad: 0.11.1 → 0.11.2 — sudosubin/agents.nix0 reactions
- Nov 8, 2026agent-skills.github.earthtojake.text-to-cad: 0.11.0 → 0.11.1 — sudosubin/agents.nix0 reactions
- Nov 8, 2026codex-plugins.github.earthtojake.text-to-cad: 0.11.0 → 0.11.1 — sudosubin/agents.nix0 reactions
- Nov 8, 2026agent-plugins.github.earthtojake.text-to-cad: 0.11.0 → 0.11.1 — sudosubin/agents.nix0 reactions
- Nov 8, 2026claude-code-plugins.github.earthtojake.text-to-cad: 0.11.0 → 0.11.1 — sudosubin/agents.nix0 reactions
- Nov 8, 2026claude-code-marketplaces.github.earthtojake.text-to-cad: 0.11.0 → 0.11.1 — sudosubin/agents.nix0 reactions
On YouTube · 22
- May 31, 2026Open source project of the week: text-to-cad — GitHub7.4k views · 3 comments
- Oct 11, 2026Text to CAD: This Free AI Designs Real Parts You Can 3D Print — Tool Man2.3k views · 1 comment
- Sep 8, 2026Text-to-CAD GitHub Tutorial: Build123d, STEP Models and AI Agent Setup — Alex Hitt2.1k views
- Oct 26, 2026Text-to-CAD — Describe a Part, Get a Real 3D Model — The Next New Thing1.8k views
- Aug 18, 2026Blueprint Bytes | Text-to-CAD: Open-Source AI Harness for Parametric 3D Modeling & CAD Generation — Blueprint Bytes1.6k views
17 more on YouTube
- Oct 5, 2026text-to-cad — Dann Paker AI1.2k views
- Oct 7, 2026Text-to-CAD: Give Your Agent CAD Superpowers — CLI Stack818 views · 1 comment
- Jul 24, 2026earthtojake/text-to-cad — Prompt in, real CAD out. 🟡 Watchlist #Shorts — ForkCast781 views
- Sep 10, 2026earthtojake/text-to-cad: AI Agent Skills for CAD, CAM, and CAE Design — SkipCI606 views
- Oct 6, 2026text-to-cad: Design Parts with Your AI Agent | GitHub Repos You Should Know #005 — GitHub Repos You Should Know492 views
- Oct 7, 2026text-to-cad: Give Your AI Agent Real CAD Superpowers — Open Source Trend310 views
- Oct 10, 2026Claude Code + text-to-cad: How to set up free in 4 minutes — OverClocked254 views · 1 comment
- Oct 30, 2026text-to-cad: give your AI agent CAD skills — RepoRadar249 views
- Oct 30, 202624.3K ⭐ Your AI Agent Can Design 3D Parts You Can Print — Github God Eng150 views
- Jul 23, 2026earthtojake/text-to-cad - Gource visualisation — Gourcer138 views
- Oct 19, 2026Text-to-cad: give your agent CAD superpowers — Next Horizon111 views · 1 comment
- Oct 7, 2026Text To Cad | GitHub Daily | 2026-10-06 — Insight AI102 views
- Oct 28, 2026🚀 [Fastest Growing GitHub Repos] text-to-cad: The Free Tool Taking Over GitHub! #shorts — githubrepo_cloud83 views
- Oct 8, 2026Text-to-CAD: Your Agent Designs Real Parts — Business Builder82 views
- Oct 13, 2026Codex Can Now Design Parts You Can 3D Print (Free text-to-cad) — Blake AI Search80 views
- Sep 16, 2026Text-to-CAD Tested by an AI Agent: 1 mm Walls Passed the Build, Validator and Slicer — README to Realitysays it tested it32 views
- Oct 24, 2026This FREE AI Tool Turns a Sentence Into a Real 3D-Printable Object (text-to-cad) — RepoExplained27 views
On Bluesky · 10
- May 18, 2026Text-to-CAD open source : décrivez une pièce ou un mécanisme en langage naturel, laissez un agent (Codex, Claude Code) générer les fichiers… — @camilleroux.com14 likes and reposts · 1 reply
- Nov 3, 2026Give your AI agent CAD superpowers: real STEP and STL files, manufacturing checks and engineering drawings. 🔗… — @prosperflowio.bsky.social2 likes and reposts
- Jul 28, 2026github.com/earthtojake/... — @davepentecost.bsky.social2 likes and reposts · 2 replies
- Jul 31, 2026text-to-cad is a library of eleven agent skills that turn a coding agent into a CAD engineer, carrying a plain-language request from STEP… — @agentpalisade.bsky.social1 likes and repost
- Jul 30, 2026🚀 Skyrocketing! 🚀 (200+ new stars) 📦 earthtojake / text-to-cad ⭐ 11,679 (+477) 🗒 JavaScript A collection of agent skills for CAD,… — @github-trending-js.bsky.social1 likes and repost · 1 reply
5 more on Bluesky
- Jul 25, 2026🎉 Celebrating! 🎉 (500+ new stars) 📦 earthtojake / text-to-cad ⭐ 10,288 (+555) 🗒 JavaScript A collection of agent skills for CAD,… — @github-trending-js.bsky.social1 likes and repost · 1 reply
- Jul 22, 2026🚀 Skyrocketing! 🚀 (200+ new stars) 📦 earthtojake / text-to-cad ⭐ 8,784 (+297) 🗒 JavaScript A collection of agent skills for CAD,… — @github-trending.bsky.social1 likes and repost · 1 reply
- Jul 21, 2026今日のGitHubトレンド earthtojake/text-to-cad CAD、ロボティクス、およびハードウェア設計を行うAIエージェント向けのスキルライブラリです。 CADデータの生成、検査、調達、スライス、受け渡しなどの機能をエージェントに提供することを目的としています。 — @dailygithubtrends.bsky.social1 likes and repost
- Aug 8, 2026公式GitHubを確認。これはかなり堅い。CADを会話だけで終わらせず、ソース管理されたファイルとして編集し、STEP/STL/URDF/SRDF/SDFやG-codeまで明示的に出力・閲覧する技能群。… — @nemu-echosphere.bsky.social0 likes and reposts · 1 reply
- May 25, 2026CAD SKILLS: Generate CAD in AI agents like Codex and Claude Code. 100% open source, runs locally, free forever. 开源生成 CAD 文件的代理模型 - 支持导出… — @maoguofang.bsky.socialsays it tested it0 likes and reposts · 2 replies
On the web · 4
- Nov 3, 2026earthtojake/text-to-cad · 25.0K Stars · GitHub 趋势| open-repo — open-repo.com
- Oct 15, 2026Struggling with CAD tools? Check out text-to-cad, an open ... — instagram.com
- Aug 15, 2026An incredible new open-source venture called text-to-cad has ... — instagram.com
- May 20, 2026new release for text-to-cad, an open source CAD harness ... — x.com
On Hacker News · 2
- May 1, 2026Text-to-CAD186 points · 48 comments
- Apr 29, 2026Text-to-CAD: Generate 3D models with coding agents (open source)2 points
Used with
Projects with it also use ingest, publish and 2 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
JaimeGBASkillingest
Digest an external source (article, paper, transcript, URL, book chapter) and integrate its content into the knowledge base
Also in 4 projects that use this
VercelSkillpublish
Publish a single demo to v0 and optionally create Typefully drafts. Use when the user says "publish", "publish to v0", or "create typefully draft" for a demo.
Also in 3 projects that use this
Microsoft AzureSkillverify
End-to-end app testing pipeline for browser-based web apps on cloud browsers via Azure Playwright Workspaces: verify the live app, author tests for working flows, heal failing tests, then re-run with video and produce one consolidated report. Three phases (app verification, test authoring, test healing) plus a scoped final sanity run; each phase emits a sub-report. Use when asked to "verify my app", "make sure my app works and has good test coverage", "do a full QA pass", "add tests where I'm missing coverage", "fix failing tests and add new ones", "smoke test before deploy", "QA my deployment", or any combined verify-and-test ask. Requires Azure CLI (`az login`) and a Playwright Workspace resource ID — bootstraps configs on first invocation. Browser-based web apps with Playwright only — not for unit/API tests, native mobile/desktop, load/perf, or full accessibility audits.
Also in 4 projects that use this
SentrySkillreview
Fixture review skill.
Also in 3 projects that use this
Other versions17 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 17
- G1Joshi/Agent-Skills★ 15same name
- imMamdouhaboammar/linkedin-animated-infographics★ 14same name
- pche-broken-artist/forge-of-thought★ 14same name
- mgiovani/cc-arsenal★ 8same name
- atharh/career-corpus-kit★ 4same name
- suxrobGM/rasterize★ 4same name
- flabanabba8/openscad-studio★ 2same name
- hiroqt/overdrive★ 2same name
- assafkip/claude-image★ 1same name
- fontezbrooks/loomDaddy★ 1same name
7 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository8 other files it gives its agents.
- AGENTS.mdAGENTS.md
- cadSkill
- engineering-drawingSkill
- feaSkill
- pcbSkill
- print3dSkill
- robot-simulationSkill
- sendcutsendSkill
The file
We split this skill into the rules it gives an agent
2 rules. 0 are common, 0 are distinctive, and 2 are very specific to this project.
0
Common
Most of the 13 edited versions we read keep these.
0
Distinctive
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 34
Run the cad command (~/.local/bin/cad where it is not on your PATH.
- Very specific: line 125
Always load a GLB with cad.blender.load, never bpy.ops.import_scene.gltf alone.
“Common” is measured: kept by at least 6 in 10 of the 13 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Renders for people
A render is a picture for a person: a hero image, a README picture, a post, a turntable, a film of
a mechanism. The model goes to Blender as a GLB, loaded by cad.blender.load; the scene (camera,
lights, world, engine, output) is an ordinary Python script that imports bpy, Blender as a
Python module, and cad run runs it. Judge geometry with cad model snapshot, never with a
render: a render's lens, light and depth of field make it a poor measure, so never read a
dimension off one.
Start with the task
| Task | Start with | Reference |
| A still of a model | Export a GLB, write a render.py that loads it, cad run render.py. | The script, scene script |
| Draft, then a final | An EEVEE draft at 1080p, looked at, before Cycles. | Draft then final |
| A pose of a motion or a frame of an animation | model.play(name) and the frame. | Clips |
| A turntable | The camera on an empty that turns once. | Turntables |
| A film of a motion or an animation | model.play(name), then an mp4. | Films |
| Motion blur, depth of field, a glow | The scene's and the camera's settings; a keyed emission. | Shots |
| Choose looks | cad.build123d.materials in the model. | Looks |
| Give the person a .blend | bpy.ops.wm.save_as_mainfile at the end of the script. | A .blend |
| Use the GPU | Cycles' device, chosen in the script. | Engines |
Setup
Run the cad command (~/.local/bin/cad where it is not on your PATH; cad.exe on Windows). If
it is missing, install text-to-cad, outside a sandbox or with its permission:
curl -fsSL https://texttocad.dev/install.sh | shOn Windows, in PowerShell: irm https://www.texttocad.dev/install.ps1 | iex. If the CAD app was
only just added, its server may still be starting: try again for up to a minute first. cad doctor
--check explains any other failure, changing nothing; cad doctor repairs what it reports. Tell the
person any next step cad setup prints.
cad run render.py sees import bpy and gives the script cad's blender integration: an
environment on Python 3.13, the one Blender is built for, holding bpy 5.2.3 (Blender 5.2 LTS)
beside cad, made the first time and kept. The script imports what it likes of cad and build123d
beside bpy, so one script can build a model, export it and render it. Blender's own preferences,
add-ons and extensions folders are cad's, never the person's, so their Blender settings never load
into a run; every cad run shares them, so an extension or a preference one script installs or saves
is there for the next, and a script that needs one sets it up itself. bpy has no build for Intel Macs
or Linux on ARM, where cad run refuses such a script by name. A --python or a header's
requires-python that leaves 3.13 out is refused the same way; one that admits it (--python 3.13)
runs on the same environment as none. Nothing here starts the Blender app.
Export the model
cad model export "$ID" scene.glb --tolerance 0.02 --angle 5ID is the model's id (running its script prints it); a STEP or an xbf exports the same way
(cad step export part.step scene.glb --tolerance 0.02 --angle 5). The GLB is in metres, Z up once
imported, with the assembly's tree as nested empties, a PBR material per look, and each motion
and animation() as a clip. The viewer's mesh shows its facets in a path tracer or a close camera:
--tolerance (mm, absolute) and --angle (degrees, 1 to 28.5) mesh this file finer, for it alone.
The cost is triangles and seconds: a tenth of the tolerance is about three times the segments round
a curve and ten times the triangles of a doubly curved face. Start at 0.02 mm and 5 degrees for a
close-up of a hand-sized part and coarser for a large assembly seen whole, and export finer when a
draft shows facets. Say the file's size when it is large. Export again after every model change:
the GLB is a copy.
The script
# render.py: cad run render.py
import math
from pathlib import Path
import bpy
from mathutils import Vector
from cad.blender import load
HERE = Path(__file__).resolve().parent
bpy.ops.wm.read_factory_settings(use_empty=True) # no person's startup file, no default cube
scene = bpy.context.scene
model = load(HERE / "scene.glb") # every part where cad placed it
scene.render.resolution_x, scene.render.resolution_y = 1920, 1080
aim = bpy.data.objects.new("aim", None)
aim.location = model.center
camera = bpy.data.objects.new("camera", bpy.data.cameras.new("camera"))
camera.data.lens = 85
view = math.tan(camera.data.angle / 2) * min(1, scene.render.resolution_y / scene.render.resolution_x)
distance = model.size.length / 2 / view * 1.1 # the whole box in the frame's shorter side
camera.location = model.center + distance * Vector((1, -1, 0.6)).normalized()
camera.constraints.new("TRACK_TO").target = aim
sun = bpy.data.objects.new("sun", bpy.data.lights.new("sun", "SUN"))
sun.data.energy, sun.rotation_euler = 3.0, (0.8, 0.2, 0.6)
for item in (aim, camera, sun):
scene.collection.objects.link(item)
scene.camera = camera
scene.world = bpy.data.worlds.new("world")
scene.world.node_tree.nodes["Background"].inputs["Strength"].default_value = 0.4
scene.render.engine = "BLENDER_EEVEE" # a draft; "CYCLES" for the final
scene.render.filepath = str(HERE / "hero.png")
bpy.ops.render.render(write_still=True)cad run render.pyThe script is the scene: a camera, lights and a world are added in Python, every run starts from
an empty scene, and the outputs are wherever the script writes them. Arguments after the script's
name reach it as sys.argv[1:] (cad run render.py --final). Lights, the world, colour
management and a GPU are in the scene script.
Load the GLB
Always load a GLB with cad.blender.load, never bpy.ops.import_scene.gltf alone. Blender's
importer poses every part a clip moves at that clip's first frame (a hinge written at 30 degrees
reads at the clip's start, with no error), leaves only the first clip live, and keys from frame 0.
load runs that importer, puts every node a clip moves back where the GLB places it, clears what
the import set playing, and plays the clip asked for. It opens any GLB, not only cad's: a node is
found by its place in the file, whatever Blender names its object.
| Call | What it gives |
load(path, clip=None, fps=24) | Imports into the current scene and returns the model; clip plays one, fps keys its seconds (the scene's render.fps, with render.fps_base 1, set before the import, so a clip is in frames at that rate). |
model.root | The document's root empty, at the origin, scale 0.001 (the parts are in mm below it). model.roots is every root's, for another tool's file with several. |
model.objects["arm/head"] | Each node's object by its path below the root, as the GLB names it. A node with no name is under the name Blender gave its object; of two nodes with one name (KiCad names every lens lens), the last. |
model.nodes[7] | Each node's object by its index in the file, which tells two of one name apart. A skin's joints are bones of the armature Blender makes for it (the skinned mesh's parent), not objects, and load never places a bone. |
model.clips | Each clip by name: kind (motion or animation) and duration in seconds. |
model.box, model.center, model.size | The world box of the pose cad wrote, in metres, for framing (the root sits at the document's origin, not the model's middle). |
model.play("sweep") | That clip from frame 0, the scene's range 0 to its duration; model.play(None) stands every part where cad placed it. |
model.bounds() | The world box at the current frame. |
A still of a pose is a clip's frame: model.play("sweep"), scene.frame_set(24), render.
Looks
The parts' looks are the model's: set them in the model, export again. bd_materials gives
physics and a look; cad.build123d.materials adds named looks Blender draws well (soldermask,
ENIG, anodized, powder coat, LED lenses, ...), each a scalar look with no texture maps
(the cad skill's colour and materials reference lists them). Blender's importer reads these of a look:
| Drawn | Not drawn |
| base colour, metalness, roughness, IOR, opacity, transmission, clear coat, sheen, specular, emission and its strength; iridescence in part | anisotropy (brushed metal draws plain), dispersion, a transmissive part's volume thickness (the light refracts through the real part), texture maps |
A material in Blender is named by the model's look (bpy.data.materials["frame_black"]), so a script
restyles a look by its name wherever it is worn; the physical material it is a look of is its custom
property (material["cad"]["material"]: Alu_G7075_T6). Two looks of one aluminium are two materials.
A transmissive look is written opaque, so a lens or a window refracts rather than fades. Its
base colour tints what passes through it, so smoked glass written as a dark colour with a partial
transmission (color near black, transmission=0.35), which a snapshot draws as a tint, renders
as a black surface: a third of nothing passes. Write the glass in the model as transmission=1
with the tint as its colour (a mid grey for smoke), and look at it in a Cycles draft. A
material is changed in the script only for the render's sake (a glow, a backdrop): the model
stays the source of every look.
Engines
EEVEE (BLENDER_EEVEE) draws a 1080p frame in about 2 s: drafts, framing, light. Cycles with
OIDN denoising is the final, on the GPU where there is one (Metal, CUDA, OptiX, HIP, oneAPI) and
on the CPU where there is not, at minutes a frame. They disagree on translucent and glass parts
(an LED's glow ghosts through its diffuser in EEVEE), so a draft does not prove a final where glass
matters: draft those in Cycles at a few samples. Device setup is in
the scene script.
EEVEE needs a graphics driver. On a machine without one (a headless Linux server or container
with no libEGL), an EEVEE render prints Couldn't open libEGL.so.1 and ends the process (exit
134) with no Python exception to catch, and so does the compositor on its default device. There,
draft in Cycles at 8 to 16 samples and set scene.render.compositor_device = "CPU"
(no graphics driver).
Check each change
| Change | Check |
| Camera, framing, lights, world | An EEVEE draft at 1080p, opened and looked at. |
| A pose, a clip's frame | model.play(...), the frame, then a draft; for a moved part, its world position (model.objects[path].matrix_world.translation) against the model's. |
| Looks, glass, emission | A small Cycles draft (32 to 64 samples): EEVEE is not the final's evidence for them. |
| A turntable or a film | Three frames (first, middle, last) as EEVEE stills before the whole film. |
| The final | The final's frame against its draft: same framing, nothing missing. |
- An empty or black image is the camera inside, behind or too near the model, or no light: print
model.boxand the camera's location. - A part in the wrong pose is a GLB imported without
load, or a clip's frame taken beforemodel.play. - A render proves a picture, not a dimension: geometry is checked with
cad model snapshot.
What to expect
- The first
cad runof a script that imports bpy downloads Blender's module once: about 262 MB on a Mac, 356 MB on Windows, 430 MB on Linux, and a Python 3.13 (65 MB). Later runs and other projects reuse it, and after an update of text-to-cad it is made again from what was downloaded. - The first
import bpyafter that takes 11 to 18 s; then about 1.3 s. - The first EEVEE render compiles its shaders (about 13 s); the first Cycles render on a Mac's GPU compiles its kernels once, about 3.5 minutes. Run it in the background with a long timeout.
- 1080p of a 537-part assembly on an M1 Max: EEVEE 64 samples 1.3 to 2.1 s; Cycles on the GPU at 256 samples with OIDN 23 to 26 s, 4.4 GB of memory at peak; Cycles on the CPU 2.5 to 3.5 minutes.
- Blender keeps a Cycles render's memory until its process ends: render each final in a run of its own rather than many in one long loop.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

