blender-helper

Blender Helper Skill

Drive Blender headless as a rendering and mesh-processing node in the Hermes pipeline.

Blender CLI

blender --background --python $SCRIPT -- $ARGS

Blender executable: blender (add to PATH or set BLENDER_BIN env var).

Core Tools

1. Apply Texture from ComfyUI Output

# apply_texture.py — run headless: blender --background --python apply_texture.py -- mesh.blend texture.png
import bpy, sys

blend_file = sys.argv[sys.argv.index("--") + 1] if "--" in sys.argv else ""
texture_file = sys.argv[sys.argv.index("--") + 2] if "--" in sys.argv else ""

if blend_file:
    bpy.ops.wm.open_mainfile(filepath=blend_file)

# Create material with ComfyUI texture
mat = bpy.data.materials.new(name="ComfyUITexture")
mat.use_nodes = True
bsdf = mat.node_tree.nodes["Principled BSDF"]
tex_image = mat.node_tree.nodes.new("ShaderNodeTexImage")
tex_image.image = bpy.data.images.load(texture_file)
mat.node_tree.links.new(bsdf.inputs["Base Color"], tex_image.outputs["Color"])

# Assign to selected mesh
if bpy.context.selected_objects:
    obj = bpy.context.selected_objects[0]
    if obj.data.materials:
        obj.data.materials[0] = mat
    else:
        obj.data.materials.append(mat)

2. Render Scene Headless

# render_scene.py
import bpy, sys, pathlib

scene_file = sys.argv[sys.argv.index("--") + 1] if "--" in sys.argv else ""
output_path = sys.argv[sys.argv.index("--") + 3] if len(sys.argv) > sys.argv.index("--") + 3 else "/tmp/render"

bpy.ops.wm.open_mainfile(filepath=scene_file)
bpy.ops.render.render()

output = pathlib.Path(output_path)
bpy.data.images["Render Result"].save_render(str(output))
print(f"Rendered: {output}")

3. GLTF Export for Godot

# export_gltf.py
import bpy, sys

blend_file = sys.argv[sys.argv.index("--") + 1]
output_file = sys.argv[sys.argv.index("--") + 2]

bpy.ops.wm.open_mainfile(filepath=blend_file)

bpy.ops.export_scene.gltf(
    filepath=output_file,
    export_format="GLB",
    use_selection=True,
    export_materials="EXPORT",
    export_draco_meshopt_compression=True,
)
print(f"Exported: {output_file}")