PluginBench
Skill
Pass
Audit score 90

Houdini

sfkislev/flue

Control SideFX Houdini from the shell via Flue, a Python bridge to hou without an MCP server.

What is Houdini?

This skill lets a coding agent operate SideFX Houdini on the desktop through Flue, a local shell-to-application bridge. The agent pipes Python into houdini_bridge.py and gets structured JSON back. Use it when the human requests work performed inside Houdini—inspecting scenes, nodes, parameters, geometry, or making bounded edits.

  • Inspect the open Houdini scene, nodes, parameters, and geometry
  • Query and modify node properties and selection
  • Run small hou scripts and get structured JSON results back
  • Execute bounded edits inside Houdini from the shell
  • Bridge agent commands to Houdini without an MCP server

How to install Houdini

npx skills add null --skill houdini
Prerequisites
  • SideFX Houdini installed and running on the desktop
  • Flue installed: pip install flue && flue setup
  • Read FLUE.md in the skill directory to understand the bridge contract
  • Read adapters/houdini_adapter/APP.md for operational details
Claude Code
Cursor
Windsurf
Cline

How to use Houdini

  1. 1.Confirm Flue is installed (pip install flue && flue setup) with human approval if needed
  2. 2.Read FLUE.md to understand the stdin/stdout bridge contract
  3. 3.Compose a Python script using the hou module for your task
  4. 4.Pipe the script to houdini_bridge.py and parse the returned JSON
  5. 5.Inspect results and iterate with small, reviewable steps

Use cases

Good for
  • Automate parameter adjustments on multiple nodes in an open scene
  • Query geometry data and node hierarchy for analysis
  • Generate or modify node networks based on agent logic
  • Inspect scene state before making targeted edits
  • Run custom hou scripts triggered from shell commands
Who it's for
  • VFX and procedural artists automating Houdini workflows
  • Technical directors building agent-assisted pipelines
  • Developers integrating Houdini into CLI-driven automation
  • Anyone needing headless or semi-headless Houdini control

Houdini FAQ

Do I need an MCP server to use this?

No. Flue is a direct shell-to-application bridge using stdin/stdout. It does not require a Model Context Protocol server.

What happens if Houdini is not running?

The bridge will fail. Houdini must be open on the desktop for Flue to communicate with it. Tell the human if Houdini is not running.

Can I use this to automate destructive operations?

Yes, but treat the human as the driver. Prefer small, inspectable steps and avoid destructive actions unless explicitly requested.

Does Flue work with other applications?

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

Where do I find the operational contract details?

Read C:\Users\fredd\.claude\skills\flue\SKILL.md and adapters/houdini_adapter/APP.md for the full contract and safety expectations.

Full instructions (SKILL.md)

Source of truth, from sfkislev/flue.


name: Houdini description: Control SideFX Houdini from the shell via Flue - a Python bridge to hou without an MCP server.

This skill lets a coding agent operate SideFX Houdini on the desktop through Flue, a local shell-to-application bridge. The agent pipes Python into houdini_bridge.py and gets structured JSON back.

agent shell -> houdini_bridge.py -> hou -> JSON result

When to use

The human requests work performed inside Houdini — inspect the open scene, nodes, parameters, geometry, selection; make bounded edits; run small hou scripts. A CLI agent cannot act inside Houdini 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 hou example, and safety expectations.
  2. If Flue is installed: also read C:\Users\fredd\.claude\skills\flue\SKILL.md and adapters/houdini_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, Blender, 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.