Skip to content

bsmi021/blender-inspect

v0.1.1MIT

Depth, surface and topology inspection of Blender scenes: mesh defect audits, depth-revealing renders and depth-ordering reports read from the scene itself.

blender-inspect

An agent plugin that lets coding agents see what a Blender scene actually contains: depth, surface imperfections and topology defects, read from the scene itself rather than guessed from flat renders.

Agents modeling in Blender usually get orthographic, flat-lit renders with no depth data. Those hide flipped faces, dents, holes and interpenetrating parts. The scene already holds exact depth and topology; this plugin exposes it.

It ships alongside pil-agent-plugin in the same repository and marketplace. pil-agent-plugin stays the image-measurement plugin; blender-inspect is the home of the Blender tools.

Privacy and data sent

Everything runs locally in a headless Blender process. The plugin has no telemetry, hosted service, account or API key. See Privacy policy.

Requirements

  • Python 3.11+ for the host-side wrapper scripts (standard library only)
  • Blender (tested with Blender 5.2). The scripts find it in this order: --blender-executable, the BLENDER_INSPECT_BLENDER environment variable, C:/Program Files/Blender Foundation/Blender 5.2/blender.exe, then blender on PATH.

Blender always runs with --factory-startup --background, so user add-ons and preferences never load into an inspection run.

Layout

PathRole
plugin.jsonPortable Agent Plugins 1.0.0 manifest
.claude-plugin/plugin.jsonClaude Code manifest
.codex-plugin/plugin.jsonCodex manifest and interface metadata
scripts/blender_common.pyBlender discovery, headless launch, sentinel parsing and the refusal contract shared by every blender_*.py tool
skills/, agents/Skills and the inspector agent
tests/test_bi_*.py; Blender-dependent tests skip when Blender is missing
evals/claude plugin eval suite

Every tool follows one refusal contract: when it cannot answer (no Blender, unreadable .blend, a probe that did not finish cleanly) it exits 2 with byte-empty stdout and a one-line reason on stderr.

Development

From the repository root:

uv run pytest -q plugins/blender-inspect/tests

Status

0.1.1 — skills trigger on plain requests. The model-inspection and bootstrap skill descriptions were rewritten so the model picks them up from ordinary asks ("check this .blend for holes", "which Blender will this use?") without naming the plugin. model-inspection now hands inspections to the blender-model-inspector agent instead of running them in the main thread. Tools are unchanged apart from the version number.

0.1.0 — First release of blender-inspect. A second plugin in the pil-agent-plugin marketplace that reads depth and defects from the Blender scene itself: blender_mesh_audit (ten mesh-defect classes with locations), blender_inspect_render (depth, normal, matcap, cavity and related modes from one camera), blender_depth_order (which object is in front, per view), plus the canonical blender_mesh, blender_fit, blender_render and blender_multiview_render, the model-inspection and bootstrap skills and the blender-model-inspector agent. The matching pil_blender_* copies in pil-agent-plugin are deprecated. Evals are not shipped: claude plugin eval refuses any case that grants Bash on Windows.

0.1.0 — Plugin scaffold and shared Blender launcher. First release of blender-inspect as a second plugin in the pil-agent-plugin marketplace, with the four-manifest set and scripts/blender_common.py.

License

MIT. See LICENSE.