ComfyUI-Hunyuan3D

Lightweight custom nodes that complement ComfyUI's native Hunyuan3D-2 support, including image loading from URL, mesh conversion, UV unwrapping, and mesh export.

By UnlimitedEditing·Created 2 months ago·Updated 2 months ago· 0

UnlimitedEditing/ComfyUI-Hunyuan3D

Nodes—

On cloudLocal install

Stars0

Updated2 months ago

Readme

ComfyUI-Hunyuan3D

Lightweight custom nodes that complement ComfyUI's native Hunyuan3D-2 support (comfy_extras.nodes_hunyuan3d), filling in the gaps needed for a Graydient image-to-mesh pipeline:

Load Image From URL (Hunyuan3D) — downloads an input image from a URL, bypassing ComfyUI's local-file validation (needed for Graydient's init_image_url field mapping).
Mesh to Trimesh — converts the native MESH output of VoxelToMesh into a trimesh object.
UV Unwrap Mesh — single-chart UV unwrap via xatlas, so the shape-only mesh produced by Hunyuan3D-2 is ready for texture painting/baking in a follow-up workflow.
Save Trimesh — exports the unwrapped mesh to GLB/OBJ/PLY/STL/3MF/DAE.

Pipeline

LoadImage / Hy3DLoadImageFromURL
  -> ImageOnlyCheckpointLoader (hunyuan3d-dit-v2-mv-turbo)
  -> CLIPVisionEncode -> Hunyuan3Dv2ConditioningMultiView
  -> KSampler -> VAEDecodeHunyuan3D -> VoxelToMesh
  -> Hy3DMeshToTrimesh -> Hy3DUVUnwrapMesh -> Hy3DSaveTrimesh

For Graydient deployment, pair with Meshsmuggler to return the GLB through an image-only output channel.