🌍 HunyuanWorld: Hybrid Generator

Here's the thing you need to know before you drag this one onto a canvas: it hands you a file path to a mesh that does not exist. Pick "direct_pipeline" mode and it returns something like output/hybrid_direct.glb as a string, plus a random-noise preview and a method note. Nothing is written to that path. There is no mesh. This node is a stub - a well-meaning outline of a "hybrid" generator that switches between two backends, with none of the actual generation implemented yet.

That's not a gotcha hiding in the docs; the source code is completely upfront about it, with comments like "This would call the actual pipeline implementation" and "For now, return placeholder." So treat this article as a field guide to what the node intends to be, and a warning not to trust its outputs today.

What it takes

The inputs tell you the design: a mode switch (direct_pipeline or comfyui_workflow, default direct), an image, a model_name choice between tencent/Hunyuan3D-2 and tencent/Hunyuan3D-2mini, a use_texture toggle, and a filename_prefix. There are also two optional inputs - existing_latent and existing_conditioning - which are accepted and then completely ignored. That's the tell: this node was planned to bridge into ComfyUI's native Hunyuan3D graph (the LATENT and CONDITIONING types are the native nodes' currency), and the plumbing for that bridge is there, but the bridge itself isn't built.

Outputs: mesh_path (STRING), preview (IMAGE), and method_info (STRING) describing which path it claims to have taken. In comfyui_workflow mode it doesn't even check whether the Hunyuan3D library is installed - it just reports "Using ComfyUI workflow with existing nodes" and returns a placeholder path.

The honest verdict

There's a real idea here. A single node that can either run the official pipeline directly or defer to ComfyUI's native Hunyuan3D nodes, with optional latents and conditioning threaded through, would be genuinely useful - the "maximum flexibility" option in a suite that's otherwise loader-plus-generator. But as shipped, it's a skeleton: it will never crash your workflow, and it will never produce a mesh either.

If you found this pack and want working 3D generation, skip the Hybrid entirely and use the pair that actually works: HunyuanWorldModelLoader wired into HunyuanWorldImageTo3D. That gives you real GLB files out of ComfyUI. Install notes for completeness:

cd ComfyUI/custom_nodes
git clone https://github.com/A043-studios/ComfyUI_HunyuanWorldnode.git
cd ComfyUI_HunyuanWorldnode
python install.py

The project is young - a single 1.0.0 release - and the README's feature list runs ahead of the code across the board. The Hybrid node is the clearest example. Watch the repo; if the author ever wires the placeholder to a real pipeline, this becomes a nice convenience node. Until then, it's a stub with a confident name.