Image & Design
Blender CLI
3D scene management, rendering and object creation via bpy
✓ 208 tests passed
Install
$ pip install cli-anything-blender
About
Control Blender headlessly via Python bpy API. Create scenes, add objects, apply materials, configure lighting and render with CYCLES or EEVEE. Perfect for automated 3D pipeline integration.
Requirements
Blender with Python (bpy)
Command Reference
| Command | Arguments | Description |
|---|---|---|
detect |
Verify Blender/bpy installation | |
version |
Show Blender version | |
render |
SCENE_FILE --output OUT --engine cycles|eevee --samples N |
Render scene to image |
info |
SCENE_FILE |
List objects, materials, cameras in scene |
add-object |
SCENE_FILE --type mesh|light|camera --name NAME |
Add object to scene |
export |
SCENE_FILE --format obj|fbx|glb|stl --output OUT |
Export 3D model |
Usage Examples
# Install
$ pip install cli-anything-blender
# Health check
$ blender-cli detect
# Get capabilities schema (Agent-ready, no token needed)
$ blender-cli schema
# Run with JSON output (for AI Agent integration)
$ blender-cli --json detect
# Example JSON response:
{"objects":["Cube","Light","Camera"],"materials":["Material.001"],"render_engine":"CYCLES"}
Agent Integration
# Python — call from AI Agent
import subprocess, json
result = subprocess.run(
["blender-cli", "--json", "detect"],
capture_output=True, text=True
)
data = json.loads(result.stdout)
print(data)
# Discover all commands without credentials:
schema = subprocess.run(
["blender-cli", "schema"],
capture_output=True, text=True
)
capabilities = json.loads(schema.stdout)