alivirgo/Major-AI-Skills / plugins/mas-3d-games/skills/houdini
houdini
VerifiedAutomate Houdini with VEX and hou/hython, cook PDG/TOPs graphs, tune Vellum/FLIP/Pyro solvers, and debug Solaris/Karma XPU renders agents routinely miss.
SideFX Houdini AI Skill Guide (Claude)
Overview & Engine Architecture
SideFX Houdini is a procedural VFX / USD pipeline DCC. Agents should treat .hip files as graphs of cooks, caches as versioned artifacts ($HIP/cache/...), PDG/TOPs as dependency contracts (not “hope files appear”), and Karma as a Hydra delegate with MaterialX GPU constraints. Automation runs through hython / hbatch, VEX in wranglers, and Solaris LOPs for USD lighting/render.
┌─────────────────────────────────────────────────────────────┐
│ Houdini cook → cache → render │
│ │
│ Contexts │
│ ├── SOPs geometry / modeling │
│ ├── DOPs: FLIP, Pyro, Vellum, RBD │
│ ├── LOPs / Solaris USD stage │
│ └── TOPs / PDG wedges & farm distribute │
│ │
│ Code │
│ ├── VEX (SIMD attrs: @P @v @orient @pscale) │
│ ├── hou Python 3.x via hython │
│ └── hbatch HScript for legacy ROPs │
│ │
│ Render │
│ └── Karma CPU / XPU + MaterialX + AOVs / Cryptomatte │
└─────────────────────────────────────────────────────────────┘
Version pins: document Houdini major.minor.build (e.g. 20.5.x) and packages JSON in every pipeline README. $HOUDINI_PATH / package order breaks farms silently.
When to use / when not to
Use when
- Procedural modeling, destruction, fluids, cloth, pyro, or USD lighting in Solaris.
- Headless cache/render via hython, hbatch, or PDG schedulers.
- Wedging parameters and distributing work items with TOPs.
Do not use when
- Motion-graphics MoGraph / Redshift hero look is C4D-native →
@cinema-4d. - Primary task is game-runtime packaging → Unreal/Unity after export.
- Pure 2D pixel compositing → Nuke/After Effects skills (not this repo’s focus).
Operational Capabilities & Agent Directives
- VEX for heavy per-point/prim work; Python SOPs only for orchestration / I/O.
- hython jobs:
hou.hipFile.load(..., suppress_save_prompt=True); catchhou.Error;sys.exit(1)on failure. - Pin
$HIP-relative cache paths; avoid absolute artist home dirs on the farm. - Solver first aid: substeps, collision thickness/separation, particle separation—before “add more resolution.”
- Karma XPU: MaterialX-only networks; classic VEX VOPs force CPU fallback.
- PDG: verify output file tokens (
$PDG_DIR,$HIP) match downstream expected paths; Dirty & Cook after path fixes. - Log
hou.applicationVersionString()at job start for reproducibility. - Never invent license server strings or farm credentials—use existing
hserver/ scheduler docs from the user.
Production Example: hython ROP baker + VEX orient
bake_rop.py:
"""Headless ROP cook.
Usage: hython bake_rop.py <scene.hip> <rop_path> [start] [end]
"""
from __future__ import annotations
import os
import sys
import hou
def bake(hip_path: str, rop_path: str, start: int | None, end: int | None) -> None:
if not os.path.isfile(hip_path):
print(f"HOU_PIPELINE_FAIL missing hip: {hip_path}", file=sys.stderr)
sys.exit(1)
print("houdini", hou.applicationVersionString())
hou.hipFile.load(hip_path, suppress_save_prompt=True, ignore_load_warnings=True)
node = hou.node(rop_path)
if node is None:
print(f"HOU_PIPELINE_FAIL missing node: {rop_path}", file=sys.stderr)
sys.exit(1)
if start is not None and end is not None:
node.parm("trange").set(1)
node.parm("f1").set(start)
node.parm("f2").set(end)
node.parm("f3").set(1)
try:
node.render(verbose=True, output_progress=True)
except hou.Error as exc:
print(f"HOU_PIPELINE_FAIL cook: {exc}", file=sys.stderr)
sys.exit(1)
print("bake OK", node.path())
if __name__ == "__main__":
if len(sys.argv) < 3:
print("Usage: hython bake_rop.py <hip> <rop> [start] [end]", file=sys.stderr)
sys.exit(2)
s = int(sys.argv[3]) if len(sys.argv) > 3 else None
e = int(sys.argv[4]) if len(sys.argv) > 4 else None
bake(sys.argv[1], sys.argv[2], s, e)
Point Wrangle (orient instances along curl noise):
vector freq = chv("frequency");
vector offset = chv("offset") + @P * freq;
vector noise_v = curlnoise(offset);
@v = lerp(@v, noise_v * chf("speed"), chf("noise_blend"));
vector up = {0, 1, 0};
if (length(@v) > 1e-3) {
matrix3 m = maketransform(normalize(@v), up);
@orient = quaternion(m);
}
float life_ratio = @age / max(@life, 1e-6);
@pscale = chf("base_scale") * (1.0 - smooth(0.7, 1.0, life_ratio));
Validation loop:
hython -c "import hou; print(hou.applicationVersionString())"
hython bake_rop.py shot.hip /out/geometry_cache 1001 1100
hbatch -c "render -Va /out/geometry_cache" shot.hip
Technical Troubleshooting Matrix
| Signature | Likely cause | Fix path |
|---|---|---|
| FLIP explodes F1 | Separation too coarse / divergence | Lower particle separation; Min Substeps 2–4; collision separation |
| Vellum penetrate / stick | Substeps or thickness | Solver substeps 25–40; reduce thickness; Layer Shock Absorber |
| Karma XPU → CPU | Non-MaterialX VOPs | Replace with mtlxstandard_surface; check console XPU_WARNING_* |
| PDG items hang | Output path tokens wrong | Service Monitor logs; fix $HIP/$PDG_DIR; Dirty & Cook |
| Missing HDA on farm | $HOUDINI_PATH / packages | Sync packages/*.json; set HOUDINI_DSO_ERROR=1 |
| Non-deterministic wedge | Unseeded noise / wall-clock | Seed noise; pin frame; avoid time-based random |
Best Practices
- Cache sims to bgeo.sc / VDB with explicit frame ranges; never rely on in-RAM DOP history on the farm.
- Keep TOPs graph readable: one wedge dimension per node where possible.
- Prefer MaterialX in Solaris for XPU; document CPU-only looks separately.
- Ship
packages/*.jsonwith tools—not hand-edited monolithichoudini.envwhen avoidable. - Use
@name/ path conventions for USDs so LOP composition stays stable.
Limitations
- Hython still needs valid SideFX licensing on workers.
- Dopnet/solver behavior changes across major versions—pin builds for golden caches.
- XPU hardware/driver constraints are environment-specific; always allow CPU Karma fallback for CI smoke.
- Stop and ask if scheduler credentials, license server hostnames, or proprietary HDAs are missing.
Related Skills
@cinema-4d— MoGraph / Redshift motion design@blender— bpy / Cycles open pipeline@substance-painter— texture authoring for exported meshes@unreal-engine— real-time destination for USD/FBX
Agent Operational Directive
MANDATORY: Prefer vectorized VEX for geometry; use hython with non-zero exits for batch. Pin Houdini build + packages. Fix solver substeps/collisions before resolution blow-ups. Keep Karma XPU on MaterialX. Never invent license or farm credentials.
Source anchors (research)
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |