🌍 HunyuanWorld: Simple Image to 3D

Straight answer up front: this node does not generate a 3D model yet. The README sells it as "one-click 3D generation for beginners," but read the actual source and you'll find a placeholder. It imports ComfyUI's native Hunyuan3D nodes, never calls them, and returns an info string plus a solid-black preview. The docstring even says so out loud: "In a real implementation, you would…" - which is the most honest thing in the whole pack.

So why am I telling you about it at all? Two reasons. One, it's what you'll find if you search ComfyUI Manager for "HunyuanWorld," and you deserve to know what you're wiring into a graph before you do. Two, its interface is a decent summary of what a beginner-friendly image-to-3D node should look like - and the inputs are real, even if the output isn't.

What it takes and what it gives

The inputs: an image, a model_variant (standard / mini / multiview, default mini), a resolution from 512–2048 (default 1024), an enable_texture toggle, and a filename_prefix. Those are all sensible - the same knobs the real pipeline needs. The outputs are result_info (a string describing what would happen) and preview (the black 512×512 placeholder). It's marked as an output node, so you'll see it on the right side of the graph waiting for a save node that never gets anything useful.

Don't wire this into a production workflow expecting a GLB to appear in your output folder. It won't. Run it if you're curious and want to confirm the pack installed - the info string proves the node executed - but that's the extent of it today.

The install, for the record

Same as the rest of the pack, and it matters for this node only in the sense that the pack must load without erroring:

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

Restart ComfyUI. If the pack loads in "compatibility mode" (terminal warning), nothing here breaks further - this node doesn't need the Hunyuan3D library to return its placeholder. Which is, if anything, the punchline: even a fully installed pack gives you a stub.

What to use instead

If you want the one-click experience this node promises, you actually already have it - ComfyUI ships native Hunyuan3D nodes (EmptyLatentHunyuan3Dv2, Hunyuan3Dv2Conditioning, VAEDecodeHunyuan3D, VoxelToMesh), and the HunyuanWorld pack's own "Real" pair (ModelLoader + ImageTo3D) is the working shortcut. For anything real, use those. Keep an eye on this node - a "simple" wrapper around that pipeline is genuinely a good idea, and the skeleton is here for someone to finish. It just isn't finished.