Headless Batch Scripting

Trigger

Use this skill when the user:

• Wants to render, export, or process .blend files from a CLI or CI pipeline
• Mentions blender --background, --python, "headless", "batch render", "no UI"
• Has an operator script that fails with RuntimeError: Operator bpy.ops.X.Y.poll() failed, context is incorrect
• Needs to pass arguments to a Blender Python script

The basic shape

blender --background --python my_script.py

Or with a specific .blend file: