PluginBench
Skill
Pass
Audit score 90

Blender

sfkislev/flue

Control Blender from the shell via Flue, a Python bridge to bpy without an MCP server.

What is Blender?

This skill lets a coding agent operate Blender on the desktop through Flue, a local shell-to-application bridge that pipes Python into blender_bridge.py and returns structured JSON. Use it when the human requests work performed inside Blender—inspecting scenes, collections, objects, meshes, materials, or making bounded edits.

  • Inspect open Blender scenes, collections, objects, and meshes
  • Query and modify materials and object properties
  • Execute small bpy scripts and return structured JSON results
  • Control Blender selection and scene state from the shell
  • Bridge agent commands to Blender's native bpy runtime without an MCP server

How to install Blender

npx skills add null --skill blender
Prerequisites
  • Blender installed on the desktop
  • Flue installed via pip install flue && flue setup
  • Read FLUE.md to understand the bridge contract and safety expectations
Claude Code
Cursor
Windsurf
Cline

How to use Blender

  1. 1.Ensure Flue is installed and set up on your system
  2. 2.Read FLUE.md in the skill directory to understand the stdin/stdout contract
  3. 3.Consult adapters/blender_adapter/APP.md for the operational contract
  4. 4.Pipe Python code into blender_bridge.py via shell
  5. 5.Parse the returned JSON result for scene data or operation status

Use cases

Good for
  • Automate 3D scene inspection and reporting from a CLI agent
  • Make bounded edits to Blender scenes based on agent instructions
  • Query object hierarchies, materials, and mesh data programmatically
  • Run small bpy scripts triggered by agent shell commands
  • Integrate Blender workflows into agent-driven pipelines
Who it's for
  • 3D artists and designers working with agents
  • Developers automating Blender workflows
  • Teams integrating Blender into agent-driven pipelines
  • Anyone needing CLI-based Blender control without MCP overhead

Blender FAQ

What is Flue and how does it differ from an MCP server?

Flue is a thinner, simpler shell-to-application bridge that drives Blender's bpy runtime directly via stdin/stdout, returning structured JSON. It is not an MCP server and requires no server infrastructure.

Do I need to install Flue separately?

Yes. If Flue is not already installed, run pip install flue && flue setup with explicit human approval. The skill will not proceed without it.

What other applications does Flue support?

Flue also supports Photoshop, Illustrator, Premiere, After Effects, InDesign, Audition, Houdini, 3ds Max, Unity, and Microsoft Office through the same stdin/stdout contract.

Is Flue safe to use?

Flue is MIT-licensed and reviewable on GitHub and PyPI. It acts inside professional desktop software, so treat the human as the driver and prefer small, inspectable steps over destructive actions unless explicitly requested.

Can I run arbitrary bpy code?

You can run small, bounded bpy scripts. Avoid destructive actions unless explicitly requested by the human, and keep scripts inspectable for safety.

Full instructions (SKILL.md)

Source of truth, from sfkislev/flue.


name: Blender description: Control Blender from the shell via Flue - a Python bridge to bpy without an MCP server.

This skill lets a coding agent operate Blender on the desktop through Flue, a local shell-to-application bridge. The agent pipes Python into blender_bridge.py and gets structured JSON back. Flue is not an MCP server — it is a thinner, simpler shell contract that drives Blender's own bpy runtime directly.

agent shell -> blender_bridge.py -> bpy -> JSON result

When to use

The human requests work performed inside Blender — inspect the open scene, collections, objects, meshes, materials, selection; make bounded edits; run small bpy scripts. A CLI agent cannot act inside Blender without a bridge like Flue.

How to proceed

  1. Read FLUE.md in this directory first. It explains how Flue works, the bridge contract, a worked bpy example, and safety expectations.
  2. If Flue is installed: also read C:\Users\fredd\.claude\skills\flue\SKILL.md and adapters/blender_adapter/APP.md for the operational contract, then work from there.
  3. If Flue is not installed: tell the human. The install command is pip install flue && flue setup. Do not install without explicit approval in the current session.

Other apps

Flue also supports Photoshop, Illustrator, Premiere, After Effects, InDesign, Audition, Houdini, 3ds Max, Unity, and Microsoft Office through the same stdin/stdout contract. One install covers all adapters.

Safety

Flue acts inside professional desktop software. Treat the human as the driver; prefer small, inspectable steps; avoid destructive actions unless explicitly requested. Flue is MIT-licensed and reviewable on GitHub / PyPI before use.