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-Hunyuan3DWrapper

ComfyUI Extension: ComfyUI-Hunyuan3DWrapper

Repo Name

ComfyUI-Hunyuan3DWrapper

Author
kijai (Account age: 2948 days)
Nodes
View all nodes(35)
Latest Updated
2026-07-29
Github Stars
1.03K

How to Install ComfyUI-Hunyuan3DWrapper

Install this extension via the ComfyUI Manager by searching for ComfyUI-Hunyuan3DWrapper
  • 1. Click the Manager button in the main menu
  • 2. Select Custom Nodes Manager button
  • 3. Enter ComfyUI-Hunyuan3DWrapper 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-Hunyuan3DWrapper Description

ComfyUI-Hunyuan3DWrapper is an extension for ComfyUI that integrates Hunyuan3D capabilities, enabling advanced 3D visualization and manipulation within the ComfyUI environment. It enhances user interaction with 3D models, providing tools for efficient rendering and editing.

ComfyUI-Hunyuan3DWrapper Introduction

The ComfyUI-Hunyuan3DWrapper is an extension designed to integrate the Hunyuan3D-2 model into the ComfyUI environment. This extension allows AI artists to leverage advanced 3D modeling capabilities within a user-friendly interface. By wrapping the Hunyuan3D-2 model, the extension simplifies the process of generating and manipulating 3D models, making it accessible even to those without extensive technical expertise. The primary goal of this extension is to enhance the creative workflow of AI artists by providing tools that facilitate the creation of complex 3D textures and models with ease.

How ComfyUI-Hunyuan3DWrapper Works

At its core, the ComfyUI-Hunyuan3DWrapper functions by integrating the Hunyuan3D-2 model into the ComfyUI framework. This integration is achieved through a series of nodes that allow users to input parameters and generate 3D models. The extension uses a combination of pre-trained models and custom nodes to process input data and produce high-quality 3D outputs. By abstracting the complex processes involved in 3D modeling, the extension enables users to focus on the creative aspects of their work, rather than the technical details.

ComfyUI-Hunyuan3DWrapper Features

The ComfyUI-Hunyuan3DWrapper offers several features designed to enhance the 3D modeling experience:

  • Model Integration: Seamlessly integrates the Hunyuan3D-2 model into ComfyUI, allowing for easy access and manipulation.
  • Custom Nodes: Provides a set of custom nodes that enable users to input parameters and generate 3D models with specific characteristics.
  • Texture Generation: Includes tools for generating and applying textures to 3D models, enhancing their visual appeal.
  • Preview3D Node: Offers a preview node that allows users to visualize their models in 3D before finalizing them. These features can be customized to suit individual preferences, allowing artists to experiment with different settings to achieve their desired results.

ComfyUI-Hunyuan3DWrapper Models

The extension primarily utilizes the Hunyuan3D-2 model, which is available in different formats:

  • Original Model: Available at Hugging Face.
  • Converted Model: Available as .safetensors at Hugging Face. These models are designed to work with the ComfyUI framework, providing robust capabilities for 3D model generation and manipulation.

What's New with ComfyUI-Hunyuan3DWrapper

Recent updates to the ComfyUI-Hunyuan3DWrapper have introduced several enhancements:

  • BPT Integration: Added support for the BPT model, which offers additional capabilities for shape generation. This feature is optional and can be installed at the user's discretion.
  • Xatlas Upgrade: Improved UV wrapping for high-poly meshes, enhancing the quality of texture mapping. These updates are designed to improve the overall functionality and performance of the extension, providing AI artists with more tools and options for their creative projects.

Troubleshooting ComfyUI-Hunyuan3DWrapper

If you encounter issues while using the ComfyUI-Hunyuan3DWrapper, consider the following troubleshooting steps:

  1. Model Loading Issues: Ensure that the models are correctly placed in the ComfyUI/models/diffusion_models/ directory.
  2. Installation Errors: Verify that all dependencies are installed correctly in your Python environment.
  3. Texture Generation Problems: Check that the necessary compilation steps for the texture generation part have been completed successfully. For common questions and solutions, refer to the FAQ section in the documentation or seek assistance from community forums.

Learn More about ComfyUI-Hunyuan3DWrapper

To further explore the capabilities of the ComfyUI-Hunyuan3DWrapper, consider accessing additional resources such as:

  • Tutorials: Online tutorials that provide step-by-step guidance on using the extension.
  • Documentation: Detailed documentation available on the extension's GitHub page.
  • Community Forums: Engage with other AI artists and developers in forums to share experiences and seek support. These resources are tailored to help AI artists maximize their use of the ComfyUI-Hunyuan3DWrapper and enhance their creative workflows.

ComfyUI-Hunyuan3DWrapper 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-Hunyuan3DWrapper detailed guide | ComfyUI