Blender Control

Blender (/Applications/Blender.app) is scriptable in Python against bpy, bmesh and mathutils. Drive it through the Blender Bridge — a script running inside a running Blender GUI that executes whatever build script is POSTed to 127.0.0.1:8736. Because it runs in the live session on the main thread, bpy.data writes are legal, the viewport updates as you build, and viewport screenshots work. Everything documented here was executed and verified on Blender 5.2.2 LTS (bundled Python 3.13) — the current stable release; 5.2 is the LTS line, so this holds for every 5.2.x. Check version in the ping reply: on a newer release, trust the live session over these notes and probe before assuming.

• scripts/blender-bridge.py — the bridge to run inside Blender.
• scripts/blender-send.sh — send a .py file (or -c 'inline') and print its captured output; --ping checks it's up, --state dumps the scene as JSON.
• scripts/example-product-shot.py — model → material → three-point light → camera → measure → render.
• scripts/example-animated-logo.py — text → keyframes → geometry-nodes scatter → frame sequence → video.