ComfyUI-Hunyuan3d-2-1

By visualbrunoView on GitHub →

ComfyUI Wrapper for [a/Hunyuan3D v2.1](https://github.com/Tencent-Hunyuan/Hunyuan3D-2.1) - From Images to High-Fidelity 3D Assets with Production-Ready PBR Material

How much VRAM does ComfyUI-Hunyuan3d-2-1 require?

Direct Answer: The ComfyUI node ComfyUI-Hunyuan3d-2-1 requires a minimum base VRAM of 128MB and is optimized for GPUs with at least 4GB of VRAM. Low VRAM mode is fully supported for resource-constrained setups.

High (2-4GB)
Base VRAM:
128MB (0.1GB)
Recommended GPU:
4GB+ VRAM
Low VRAM Mode:
✓ Supported
Estimation Confidence:
MEDIUM

Interactive VRAM Compatibility Estimator

Estimated Total VRAM: 3.00 GBTarget: 8 GB
✅ Comfortable Fit

Your GPU has plenty of headroom. You can run this node safely with your active configurations!

Deploy on High-Performance GPUs

Need more VRAM to run ComfyUI with this node? Rent low-cost, high-performance GPUs on Vast.ai instantly.

🚀 Deploy on Vast.ai

Deploy on Cloud GPUs

Need more VRAM to run ComfyUI with this node? Rent low-cost, high-performance cloud GPUs on RunPod instantly.

🚀 Deploy on RunPod

What Python packages are required for ComfyUI-Hunyuan3d-2-1?

Direct Answer: Running ComfyUI-Hunyuan3d-2-1 requires installing the following Python package dependencies: accelerate, configargparse, diffusers, huggingface-hub, meshlib, omegaconf, open3d, opencv-python, pybind11, pygltflib, pymeshlab, pytorch-lightning, pyyaml, safetensors, scikit-image, timm, transformers, trimesh, xatlas. Ensure your ComfyUI environment has these packages active before launching.

requirements.txt
accelerate
configargparse
diffusers
huggingface-hub
meshlib
omegaconf
open3d
opencv-python
pybind11
pygltflib
pymeshlab
pytorch-lightning
pyyaml
safetensors
scikit-image
timm
transformers
trimesh
xatlas

Interactive Setup & Dependency Resolver

Operating System:
Environment Type:
Run this terminal command in your ComfyUI root folder:
# Loading command...

Related Custom Nodes

The following custom nodes run in the same PyTorch / CUDA environment and share similar categories or workflows:

AAA Metadata System
by EricRollei128MB VRAM
Animatediff MotionLoRA Trainer
by kijai4.0GB VRAM
Arc2Face ComfyUI Node Library
by caleboleary128MB VRAM
Arthemy Live Tuner - SDXL
by aledelpho8.0GB VRAM
BokehDiffusionComfyUI
by jrabek256MB VRAM

Frequently Asked Questions

How much VRAM does ComfyUI-Hunyuan3d-2-1 require?

ComfyUI-Hunyuan3d-2-1 requires a minimum of 128MB (0.1GB) of VRAM for base operation. For optimal performance, a GPU with at least 4GB of VRAM is recommended. This node supports low VRAM mode for resource-constrained setups.

Can I run ComfyUI-Hunyuan3d-2-1 on an RTX 3060, RTX 4070, or RTX 4090?

✅ RTX 3060 (12GB): Yes, fully compatible with 10.7GB headroom. ✅ RTX 4070 (12GB): Yes, fully compatible with 10.7GB headroom. ✅ RTX 4070 Ti (16GB): Yes, fully compatible with 14.3GB headroom. ✅ RTX 4090 (24GB): Yes, fully compatible with 21.5GB headroom

What PyTorch version does ComfyUI-Hunyuan3d-2-1 need?

ComfyUI-Hunyuan3d-2-1 requires the following PyTorch-related packages: pytorch-lightning. Ensure your ComfyUI environment has these installed. Ensure your PyTorch installation matches your CUDA version (use torch.version.cuda to check).

What Python packages are required for ComfyUI-Hunyuan3d-2-1?

To run ComfyUI-Hunyuan3d-2-1, you need to install: accelerate, configargparse, diffusers, huggingface-hub, meshlib, omegaconf, open3d, opencv-python, pybind11, pygltflib, pymeshlab, pytorch-lightning, pyyaml, safetensors, scikit-image, timm, transformers, trimesh, xatlas. You can install these using pip or add them to your requirements.txt file.

How can I reduce VRAM usage when running ComfyUI-Hunyuan3d-2-1?

ComfyUI-Hunyuan3d-2-1 supports low VRAM mode. To reduce memory usage: (1) Enable --lowvram or --medvram flags in ComfyUI, (2) Reduce batch size to 1, (3) Use fp16 or fp8 precision if supported, (4) Close other GPU applications.

How do I install ComfyUI-Hunyuan3d-2-1 in ComfyUI?

To install ComfyUI-Hunyuan3d-2-1: (1) Navigate to your ComfyUI/custom_nodes directory, (2) Clone the repository: git clone https://github.com/visualbruno/ComfyUI-Hunyuan3d-2-1, (3) Install dependencies: pip install -r requirements.txt (if present), (4) Restart ComfyUI. Alternatively, use ComfyUI Manager for one-click installation.