BlendAgent

Problem

Autonomous Arena Studio's Blender pipeline needed repeatable plumbing — finding and driving Blender from Python, executing generated scripts against scene data, assembling frames into video — without hard-wiring any of it to that one project. BlendAgent is that extraction: a small, deliberately reusable helper library instead of a copy-pasted utils folder.

Approach

The package wraps Blender discovery and script execution, JSON scene-manifest validation for beats, shots, and render settings, PNG-to-MP4 frame assembly, and labeled contact-sheet generation for visual QA, exposed through small dataclass-style types such as SceneManifest, RenderSettings, Beat, and FrameRange. Its own design rules keep it that way: it must not import project-specific application packages, and generated Blender scripts receive neutral JSON manifests rather than application objects, so any project adapts its specs into BlendAgent's inputs instead of the reverse. It installs either from a local path or directly from the private GitHub repo through pip's git+https syntax.

Outcome

The repo is private. Nearly every commit — the cutout pose library, ink-stroke helpers, style-frame rendering, a Blender smoke test — landed in one concentrated stretch on 2026-06-06 and 2026-06-07 alongside Autonomous Arena Studio, and neither repo has been touched since.