¿Qué hace houdini?
Controla SideFX Houdini desde la terminal mediante Flue, un puente Python para hou sin necesidad de un servidor MCP.
Descripción
sfkislev/houdini es una habilidad que permite a agentes de IA (como Claude Code, Cursor, Codex, etc.) interactuar con Houdini a través del shell. Utiliza Flue para establecer una conexión directa con la API de Houdini (hou) desde scripts Python ejecutados en la terminal.
Requisitos
- SideFX Houdini instalado (versión 18.5 o superior recomendada).
- Python 3.7 o superior.
- Flue instalado:
pip install flue. - Acceso a la shell (bash, zsh, PowerShell).
Instalación
- Instala Flue:
pip install flue. - Clona este repositorio o copia el archivo de habilidad en tu directorio de habilidades del agente.
- Asegúrate de que Houdini esté en tu PATH o configura la variable de entorno
HOUDINI_ROOT.
Uso
Una vez instalada, la habilidad expone comandos como:
houdini create-scene --name my_scene
houdini run-script --file script.py
houdini eval --expr "hou.node('/obj').children()"
También puedes pasar código Python directamente:
houdini exec "print(hou.session)"
Ejemplos
-
Crear una escena vacía:
houdini create-scene --name test -
Obtener la lista de nodos en
/obj:houdini eval --expr "[n.name() for n in hou.node('/obj').children()]" -
Ejecutar un script local:
houdini run-script --path /ruta/al/script.py
Configuración
Puedes configurar las siguientes variables de entorno:
HOUDINI_ROOT: ruta al directorio de instalación de Houdini (opcional si ya está en PATH).FLUE_PORT: puerto para la comunicación con Flue (por defecto: 9876).
Notas técnicas
- Flue utiliza sockets locales para comunicarse con el proceso de Houdini, lo que evita la sobrecarga de un servidor HTTP.
- No se requiere un servidor MCP externo; todo el control se realiza mediante la shell.
- Compatible con Houdini FX, Core e Indie.
Licencia
MIT