Save 4 hours! We auto-setup your workflow! Free!

Drop your workflow.json — we handle every dependency, custom node, and model. Just open the link and run.

Auto-Setup Workflow Json (Free) Now!
ComfyUI > Nodes > ComfyUI-Hunyuan3D

ComfyUI Extension: ComfyUI-Hunyuan3D

Repo Name

ComfyUI-Hunyuan3D

Author
unlimitedediting (Account age: 253 days)
Nodes
View all nodes(1)
Latest Updated
2026-09-01
Github Stars
0.0K

How to Install ComfyUI-Hunyuan3D

Install this extension via the ComfyUI Manager by searching for ComfyUI-Hunyuan3D
  • 1. Click the Manager button in the main menu
  • 2. Select Custom Nodes Manager button
  • 3. Enter ComfyUI-Hunyuan3D in the search bar
After installation, click the Restart button to restart ComfyUI. Then, manually refresh your browser to clear the cache and access the updated list of nodes.

Visit ComfyUI Online for ready-to-use ComfyUI environment

  • Free trial available
  • 16GB VRAM to 80GB VRAM GPU machines
  • 400+ preloaded models/nodes
  • Freedom to upload custom models/nodes
  • 200+ ready-to-run workflows
  • 100% private workspace with up to 200GB storage
  • Dedicated Support

Run ComfyUI Online

ComfyUI-Hunyuan3D Description

ComfyUI-Hunyuan3D complements native Hunyuan3D-2 nodes by loading images from URLs, converting generated meshes, adding UV coordinates for later texturing, and exporting shape-only 3D files.

ComfyUI-Hunyuan3D Introduction

ComfyUI-Hunyuan3D adds a small set of nodes to complement ComfyUI’s built-in Hunyuan3D-2 support. Together, they help turn an input image into a 3D mesh, prepare that mesh for a later texturing workflow, and export it in a usable file format.

The extension fills four practical gaps in an image-to-mesh workflow: loading an image from a URL, converting ComfyUI’s mesh output into a form the later nodes can use, creating UV coordinates, and saving the result. It was designed to support a Graydient image-to-mesh pipeline, but its mesh-preparation and export nodes are useful wherever the same ComfyUI outputs are available.

The resulting mesh is shape-only. UV unwrapping prepares its surface for texture painting or baking; it does not create or apply a texture.

How ComfyUI-Hunyuan3D Works

Think of the workflow as making and preparing a digital sculpture:

  1. Provide a reference image. Load an image from a local file or, with this extension’s URL loader, from a web address.
  2. Generate the shape. ComfyUI’s native Hunyuan3D-2 nodes process the image and produce a mesh through VoxelToMesh.
  3. Prepare the mesh. Mesh to Trimesh converts that output for the extension’s subsequent nodes. UV Unwrap Mesh then creates UV coordinates, which act like a flat map of the sculpture’s surface for later painting or baking.
  4. Export the result. Save Trimesh writes the prepared mesh to a 3D file.

The pipeline shown in the author’s original README is:

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

The Hunyuan3D-2 generation nodes in this example are part of ComfyUI’s native support (comfy_extras.nodes_hunyuan3d). ComfyUI-Hunyuan3D supplies the URL-loading, mesh-conversion, UV-unwrapping, and export steps around them.

ComfyUI-Hunyuan3D Features

  • Load Image From URL (Hy3DLoadImageFromURL) downloads an input image from a URL. It provides an alternative to loading a local image and supports Graydient’s init_image_url field mapping, which cannot use ComfyUI’s usual local-file validation in the same way.
  • Mesh to Trimesh (Hy3DMeshToTrimesh) converts the native MESH output from VoxelToMesh into a trimesh object. This is a compatibility step: place it between mesh generation and the extension’s UV or export nodes.
  • UV Unwrap Mesh (Hy3DUVUnwrapMesh) uses xatlas to create a single-chart UV unwrap. This gives the shape-only mesh UV coordinates for a follow-up texture-painting or baking workflow. It prepares a place for texture detail; it does not add that detail itself.
  • Save Trimesh (Hy3DSaveTrimesh) exports the mesh as GLB, OBJ, PLY, STL, 3MF, or DAE. Choose an export format based on the requirements of the application or workflow where you plan to use the mesh.

The supplied documentation does not specify additional controls or recommended values for these nodes. The main choices it describes are whether to use a local image or URL, whether to UV unwrap before export, and which supported file format to save.

For a Graydient deployment that needs to return a GLB through an image-only output channel, the author recommends pairing this extension with Meshsmuggler.

ComfyUI-Hunyuan3D Models

The example pipeline names hunyuan3d-dit-v2-mv-turbo as the checkpoint loaded by ImageOnlyCheckpointLoader for Hunyuan3D-2 shape generation. ComfyUI-Hunyuan3D itself adds workflow nodes, not a separate model. The supplied documentation does not list other checkpoints or compare their outputs or performance.

Troubleshooting ComfyUI-Hunyuan3D

The UV or save node cannot use the output from VoxelToMesh.

  1. Check that VoxelToMesh is producing the native MESH output.
  2. Connect that output to Hy3DMeshToTrimesh.
  3. Connect the converted output to Hy3DUVUnwrapMesh and then Hy3DSaveTrimesh, as shown in the pipeline above.

A URL-based image input does not work with the usual local image loader.

  1. Check whether your workflow is supplying a URL rather than a local file.
  2. Use Hy3DLoadImageFromURL for the URL input.
  3. In a Graydient workflow, check that init_image_url is mapped to that URL-loading step.

The exported mesh has no painted appearance.

The documented Hunyuan3D-2 workflow produces a shape-only mesh. Hy3DUVUnwrapMesh creates UV coordinates but does not generate a texture. Use a separate texture-painting or baking workflow after unwrapping if your project needs surface color or detail.

Which export format should I choose?

Hy3DSaveTrimesh supports GLB, OBJ, PLY, STL, 3MF, and DAE. Check which format your next application accepts. For the Graydient output workflow described by the author, the intended file is GLB.

Does this extension replace ComfyUI’s Hunyuan3D-2 nodes?

No. It complements ComfyUI’s native Hunyuan3D-2 support. The example pipeline uses native nodes to generate the shape and this extension’s nodes to handle URL input, mesh preparation, UV unwrapping, and export.

Learn More about ComfyUI-Hunyuan3D

  • ComfyUI’s native Hunyuan3D-2 nodes: Look for comfy_extras.nodes_hunyuan3d when examining the shape-generation portion of a workflow. The pipeline above shows where those nodes connect to this extension.
  • Meshsmuggler: See the project linked by the author for the Graydient-specific step of returning a GLB through an image-only output channel.

ComfyUI-Hunyuan3D Related Nodes

RunComfy
Copyright 2025 RunComfy. All Rights Reserved.

RunComfy is the premier ComfyUI platform, offering ComfyUI online environment and services, along with ComfyUI workflows featuring stunning visuals. RunComfy also provides AI Models, enabling artists to harness the latest AI tools to create incredible art.

ComfyUI-Hunyuan3D detailed guide | ComfyUI