ComfyUI-Hunyuan3D-2.1

By Yuan-ManXView on GitHub →

ComfyUI-Hunyuan3D-2.1 is now available in ComfyUI, Hunyuan3D-2.1 is a scalable 3D asset creation system that advances state-of-the-art 3D generation through two pivotal innovations: Fully Open-Source Framework and Physically-Based Rendering (PBR) Texture Synthesis.

How much VRAM does ComfyUI-Hunyuan3D-2.1 require?

Direct Answer: The ComfyUI node ComfyUI-Hunyuan3D-2.1 requires a minimum base VRAM of 4096MB and is optimized for GPUs with at least 8GB of VRAM. Low VRAM mode is not supported for this node.

Very High (4-8GB)
Base VRAM:
4096MB (4.0GB)
Recommended GPU:
8GB+ VRAM
Low VRAM Mode:
✗ Not 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==1.1.1, basicsr==1.4.2, bpy==4.0, configargparse==1.7, cupy-cuda12x==13.4.1, deepspeed, diffusers==0.30.0, einops==0.8.0, fastapi==0.115.12, gradio==5.33.0, huggingface-hub==0.30.2, imageio==2.36.0, ninja==1.11.1.1, numpy==1.24.4, omegaconf==2.3.0, onnxruntime==1.16.3, open3d==0.18.0, opencv-python==4.10.0.84, pandas==2.2.2, psutil==6.0.0, pybind11==2.13.4, pydantic==2.10.6, pygltflib==1.16.3, pymeshlab==2022.2.post3, pythreejs, pytorch-lightning==1.9.5, pyyaml==6.0.2, realesrgan==0.3.0, rembg==2.0.65, safetensors==0.4.4, scikit-image==0.24.0, scipy==1.14.1, tb_nightly==2.18.0a20240726, timm, torchdiffeq, torchmetrics==1.6.0, tqdm==4.66.5, transformers==4.46.0, trimesh==4.4.7, uvicorn==0.34.3, xatlas==0.0.9. Ensure your ComfyUI environment has these packages active before launching.

requirements.txt
accelerate==1.1.1
basicsr==1.4.2
bpy==4.0
configargparse==1.7
cupy-cuda12x==13.4.1
deepspeed
diffusers==0.30.0
einops==0.8.0
fastapi==0.115.12
gradio==5.33.0
huggingface-hub==0.30.2
imageio==2.36.0
ninja==1.11.1.1
numpy==1.24.4
omegaconf==2.3.0
onnxruntime==1.16.3
open3d==0.18.0
opencv-python==4.10.0.84
pandas==2.2.2
psutil==6.0.0
pybind11==2.13.4
pydantic==2.10.6
pygltflib==1.16.3
pymeshlab==2022.2.post3
pythreejs
pytorch-lightning==1.9.5
pyyaml==6.0.2
realesrgan==0.3.0
rembg==2.0.65
safetensors==0.4.4
scikit-image==0.24.0
scipy==1.14.1
tb_nightly==2.18.0a20240726
timm
torchdiffeq
torchmetrics==1.6.0
tqdm==4.66.5
transformers==4.46.0
trimesh==4.4.7
uvicorn==0.34.3
xatlas==0.0.9

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:

ComfyUI-Bagel
by Yuan-ManX128MB VRAM
ComfyUI-Direct3D-S2
by Yuan-ManX4.0GB VRAM
Atom_AI
by AtomAI-GR12.0GB VRAM
Bawk Nodes Collection
by juddisjudd12.0GB VRAM
Bobs_Latent_Optimizer
by bobsblazed12.0GB VRAM

Frequently Asked Questions

How much VRAM does ComfyUI-Hunyuan3D-2.1 require?

ComfyUI-Hunyuan3D-2.1 requires a minimum of 4096MB (4.0GB) of VRAM for base operation. For optimal performance, a GPU with at least 8GB of VRAM is recommended. Low VRAM mode is not supported for this node.

Can I run ComfyUI-Hunyuan3D-2.1 on an RTX 3060, RTX 4070, or RTX 4090?

✅ RTX 3060 (12GB): Yes, fully compatible with 6.8GB headroom. ✅ RTX 4070 (12GB): Yes, fully compatible with 6.8GB headroom. ✅ RTX 4070 Ti (16GB): Yes, fully compatible with 10.4GB headroom. ✅ RTX 4090 (24GB): Yes, fully compatible with 17.6GB headroom

What PyTorch version does ComfyUI-Hunyuan3D-2.1 need?

ComfyUI-Hunyuan3D-2.1 requires the following PyTorch-related packages: pytorch-lightning==1.9.5, torchdiffeq, torchmetrics==1.6.0. 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==1.1.1, basicsr==1.4.2, bpy==4.0, configargparse==1.7, cupy-cuda12x==13.4.1, deepspeed, diffusers==0.30.0, einops==0.8.0, fastapi==0.115.12, gradio==5.33.0, huggingface-hub==0.30.2, imageio==2.36.0, ninja==1.11.1.1, numpy==1.24.4, omegaconf==2.3.0, onnxruntime==1.16.3, open3d==0.18.0, opencv-python==4.10.0.84, pandas==2.2.2, psutil==6.0.0, pybind11==2.13.4, pydantic==2.10.6, pygltflib==1.16.3, pymeshlab==2022.2.post3, pythreejs, pytorch-lightning==1.9.5, pyyaml==6.0.2, realesrgan==0.3.0, rembg==2.0.65, safetensors==0.4.4, scikit-image==0.24.0, scipy==1.14.1, tb_nightly==2.18.0a20240726, timm, torchdiffeq, torchmetrics==1.6.0, tqdm==4.66.5, transformers==4.46.0, trimesh==4.4.7, uvicorn==0.34.3, xatlas==0.0.9. You can install these using pip or add them to your requirements.txt file.

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/Yuan-ManX/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.