Back to Skills

Blender

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

34stars1forksUpdated 6/24/2026

Security Assessment

Safe(100/100)
Security Score100/100

About Blender

This skill lets a coding agent operate Blender on the desktop through Flue, a local shell-to-application bridge. Rather than running an MCP server, the agent pipes Python into `blender_bridge.py` and receives structured JSON back, driving Blender's own `bpy` runtime directly. Flue is described as a thinner, simpler shell contract than MCP, following the path: agent shell to blender_bridge.py to bpy to JSON result.

It is intended for situations where the human requests work performed inside Blender — inspecting the open scene, collections, objects, meshes, materials, or selection; making bounded edits; or running small `bpy` scripts. A CLI agent cannot act inside Blender without a bridge like Flue. To proceed, the agent should first read FLUE.md in the skill directory, which explains how Flue works, the bridge contract, a worked `bpy` example, and safety expectations. If Flue is installed, the agent should also read the Flue SKILL.md and the Blender adapter's APP.md for the operational contract before working. If Flue is not installed, the agent should tell the human; the install command is `pip install flue && flue setup`, and installation must not happen without explicit approval in the current session.

The same stdin/stdout contract supports many other professional desktop applications, including Photoshop, Illustrator, Premiere, After Effects, InDesign, Audition, Houdini, 3ds Max, Unity, and Microsoft Office — a single install covers all adapters. Because Flue acts inside professional desktop software, safety guidance emphasizes treating the human as the driver, preferring small inspectable steps, and avoiding destructive actions unless explicitly requested. Flue is MIT-licensed and reviewable on GitHub and PyPI before use.

FAQ

Is Flue an MCP server?

No. Flue is a local shell-to-application bridge with a thinner, simpler shell contract than MCP. The agent pipes Python into blender_bridge.py and gets structured JSON back, driving Blender's bpy runtime directly.

What kinds of tasks can this skill perform in Blender?

It can inspect the open scene, collections, objects, meshes, materials, and selection, make bounded edits, and run small bpy scripts. It is for work performed inside Blender that a CLI agent could not otherwise reach.

What should I read before starting?

Read FLUE.md in the skill directory first; it explains how Flue works, the bridge contract, a worked bpy example, and safety expectations. If Flue is installed, also read the Flue SKILL.md and the Blender adapter's APP.md.

How is Flue installed, and can the agent install it automatically?

The install command is `pip install flue && flue setup`. The agent must not install it without explicit approval in the current session; if Flue is not installed it should tell the human instead.

Does Flue support applications other than Blender?

Yes. The same stdin/stdout contract supports Photoshop, Illustrator, Premiere, After Effects, InDesign, Audition, Houdini, 3ds Max, Unity, and Microsoft Office, and one install covers all adapters.

All Files

2 files
FLUE.md5.8 KB
View
SKILL.md1.7 KB
View

Install Blender

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill

Repository

sfkislev/flue