By remiehneppo
Load, create, resize, pixel-edit, and save images via Blender's image datablock API without rendering a 3D scene. Use when batch-processing image files, manipulating pixel buffers, resizing textures, saving with format settings, or chaining render-complete handlers for multi-shot sequences.
Blender headless 3D mesh export for STL, OBJ, 3MF, and AMF formats with version-compatible fallbacks. Covers the current wm.obj_export / wm.stl_export operators (Blender 4.0+), legacy export_scene.obj / export_mesh.stl fallbacks, 3MF via the threemf add-on, and AMF via operator probing. Use when exporting geometry to print-ready or CAD-exchange formats from background scripts, CI pipelines, or render farms. See ../_shared/compat-matrix.md for the full version-compat table.
Blender headless compositor node tree setup for post-processing rendered images. Covers enabling compositing (scene.use_nodes, scene.render.use_compositing), creating and connecting compositor nodes (Nodes.new, NodeLinks.new), and configuring blur, rotate, translate, scale, alpha-over, and file-output nodes. Includes version-compatible patterns for CompositorNodeOutputFile directory field. Use when applying post-process effects to renders, compositing overlays, chaining image operations in a node graph, or writing compositor output directly to disk. For rendering the scene, see blender-rendering. For direct pixel edits, see blender-image-editing. See ../_shared/compat-matrix.md for compositor version-compat details.
Blender headless execution fundamentals for background automation scripts. Covers CLI invocation (--background, --factory-startup, --python, --addons), sys.argv argument parsing, scene bootstrapping, namespace overview (bpy.data, bpy.ops, bpy.types, bpy.context, bpy.props, bpy.app.handlers), and operator safety rules (poll() failures, Context.temp_override, why to prefer BMesh and datablock APIs over edit-mode operator chains). Use when writing any Blender script intended for background/headless execution, CI pipelines, render farms, or batch automation.
Blender headless image datablock manipulation: load, create, read/write pixels, resize, and save images without rendering a 3D scene. Covers bpy.data.images.load, bpy.data.images.new, Image.pixels (flat RGBA buffer), Image.scale, Image.save, Image.save_render, render image_settings for format config, and bpy.app.handlers.render_complete for batch callback-driven multi-render sequences. Use when processing image files in batch (resize, color transform, format convert), generating procedural images programmatically, or orchestrating multi-shot renders with per-render callbacks. For compositor-based post-processing, see blender-compositing.
Blender headless geometry creation and BMesh topology editing. Covers creating mesh datablocks from Python data (bpy.data.meshes.new, Mesh.from_pydata), wrapping meshes in objects and linking to scenes, and editing topology with BMesh (extrude_face_region, translate, triangulate). Use when creating procedural geometry, building meshes from vertex/face lists, or editing mesh topology in a background script without a GUI. For modifiers and depsgraph bake, see blender-modifiers. For repair (remove_doubles, holes_fill), see blender-mesh-repair.
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimBased on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
Agent skills for Blender headless automation — image design and 3D file creation.
Each skill is a separate directory so the agent loads only what it needs, not everything at once.
| Requirement | Details |
|---|---|
| Blender version | 3.6+ recommended; 4.0+ for current exporter operators (wm.obj_export, wm.stl_export) |
| Installation | blender.org/download or via system package manager |
blender on PATH | Run blender --version to verify; add to PATH if needed |
# Verify Blender is accessible
blender --version
Blender ships its own Python interpreter — no separate Python install needed. Scripts run inside Blender's Python environment automatically.
All standard-library modules (os, sys, math, glob) are available. Third-party pip packages are not available by default unless installed into Blender's Python.
| Add-on | Required by | Install |
|---|---|---|
3MF exporter (io_mesh_3mf) | blender-3d-export (3MF format) | Bundled in Blender 3.x; enable via Preferences → Add-ons, or --addons io_mesh_3mf |
| AMF exporter | blender-3d-export (AMF format) | Third-party add-on — install manually, then --addons <module_name> |
| Cycles | blender-rendering (photo-realistic renders) | Bundled in Blender; enable via Preferences → Add-ons |
Skills that require add-ons include try/except fallbacks — missing add-ons print a warning but don't crash the script.
npx skills add <your-github-username>/blender-skills
This installs all skills into ~/.agents/skills/ where agent runtimes (Claude Code, etc.) can discover them.
npx skills add <your-github-username>/blender-skills/skills/blender-rendering
Copy any skill directory into ~/.agents/skills/:
cp -r skills/blender-rendering ~/.agents/skills/
ls ~/.agents/skills/ | grep blender
Scripts generated by these skills run with:
blender --background --factory-startup --python your_script.py
With add-ons:
blender --background --factory-startup --addons io_mesh_3mf --python your_script.py
With custom arguments (available via sys.argv after --):
blender --background --factory-startup --python your_script.py -- /output/dir 0.5
| Skill | Description |
|---|---|
| blender-headless | CLI invocation, bootstrapping, operator safety, namespace overview |
| Skill | Description |
|---|---|
| blender-mesh-modeling | Geometry creation from Python data + BMesh topology editing |
| blender-modifiers | Boolean / Remesh / Decimate / Solidify + depsgraph bake |
| blender-mesh-repair | Watertight repair: weld duplicates, fill holes, triangulate |
| blender-3d-export | STL / OBJ / 3MF / AMF export with version-compat fallbacks |
| Skill | Description |
|---|---|
| blender-rendering | Camera + light setup, render settings, render to PNG/JPEG/EXR |
| blender-compositing | Compositor node tree: blur, rotate, translate, alpha-over, file output |
| blender-image-editing | Image pixels, resize, save, batch processing, render handlers |
skills/_shared/compat-matrix.md — Blender version compatibility table for exporter operator names, compositor API differences, and version-sensitive modifier properties. Referenced by blender-3d-export and blender-compositing.
blender --background headless executionhasattr() guards or try/except3D print pipeline: blender-headless → blender-mesh-modeling → blender-modifiers → blender-mesh-repair → blender-3d-export
Render pipeline: blender-headless → blender-rendering → blender-compositing
Batch image processing: blender-headless → blender-image-editing
npx claudepluginhub remiehneppo/blender-skills --plugin blender-headlessComprehensive skill pack with 66 specialized skills for full-stack developers: 12 language experts (Python, TypeScript, Go, Rust, C++, Swift, Kotlin, C#, PHP, Java, SQL, JavaScript), 10 backend frameworks, 6 frontend/mobile, plus infrastructure, DevOps, security, and testing. Features progressive disclosure architecture for 50% faster loading.
A growing collection of Claude-compatible academic workflow bundles. Covers scientific figures, manuscript writing and polishing, reviewer assessment, citation retrieval, data availability, paper reading, literature search, response letters, paper-to-PPTX conversion, and evidence-grounded Chinese invention patent drafting. Rules are organized as reusable skill folders with explicit workflows and quality checks.
Intelligent draw.io diagramming plugin with AI-powered diagram generation, multi-platform embedding (GitHub, Confluence, Azure DevOps, Notion, Teams, Harness), conditional formatting, live data binding, and MCP server integration for programmatic diagram creation and management.
Persistent file-based planning for AI coding agents. Crash-proof markdown plans (task_plan.md, findings.md, progress.md) that survive context loss and /clear, with an opt-in completion gate and multi-agent shared state. Manus-style. Works with Claude Code, Codex CLI, Cursor, Kiro, OpenCode and 60+ agents via the SKILL.md standard. Includes Arabic, German, Spanish, and Chinese (Simplified and Traditional).
Complete creative writing suite with 10 specialized agents covering the full writing process: research gathering, character development, story architecture, world-building, dialogue coaching, editing/review, outlining, content strategy, believability auditing, and prose style/voice analysis. Includes genre-specific guides, templates, and quality checklists.
Payload Development plugin - covers collections, fields, hooks, access control, plugins, and database adapters.