Complete installation guide for ComfyUI-Hunyuan3DWrapper on NVIDIA Blackwell GPUs (RTX 5070 Ti, 5080, 5090) Covers custom_rasterizer manual compilation for sm_120 / compute_120 architecture.
System Configuration (Tested) ComponentDetailsGPUNVIDIA GeForce RTX 5070 Ti 16GB (Blackwell, sm_120)OSWindows 11Python3.12 (ComfyUI python_embeded)PyTorch2.8.0+cu128CUDA Toolkit12.8 (for compilation)Visual Studio2022 Build Tools (v14.44)ComfyUIEasy Install layout
Why This Guide Exists The prebuilt custom_rasterizer wheels included in ComfyUI-Hunyuan3DWrapper do not support Blackwell (sm_120): WheelArchitectureCompatible?custom_rasterizer-0.1-cp312-win_amd64.whlUnknown❌custom_rasterizer-0.1.0+torch260.cuda126sm_90 (Ada)❌custom_rasterizer-0.1.0+torch270.cuda128sm_90 (Ada)❌custom_rasterizer-0.1.0+torch2100.cuda130sm_90 (Ada)❌ You must compile from source with TORCH_CUDA_ARCH_LIST=12.0.
Prerequisites
- Visual Studio 2022 Build Tools Download and install: https://aka.ms/vs/17/release/vs_BuildTools.exe During installation, select "Desktop development with C++" workload.
- CUDA Toolkit 12.8 Download: https://developer.nvidia.com/cuda-12-8-0-download-archive Select: Windows → x86_64 → exe (local)
Note: You do not need to uninstall other CUDA versions. They can coexist.
- Verify VS 2022 Installation cmddir "C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools\VC\Tools\MSVC" You should see a directory like 14.44.35207. Note this version number.
Step 1 — Clone the Node If not already installed via ComfyUI Manager: cmdcd \custom_nodes git clone https://github.com/kijai/ComfyUI-Hunyuan3DWrapper Install Python requirements using ComfyUI's own Python: cmd<ComfyUI_root>\python_embeded\python.exe -m pip install -r \custom_nodes\ComfyUI-Hunyuan3DWrapper\requirements.txt
Step 2 — Install Missing Dependencies cmd<ComfyUI_root>\python_embeded\python.exe -m pip install Cython <ComfyUI_root>\python_embeded\python.exe -m pip install insightface onnxruntime-gpu
Step 3 — Download Models
Run the following using ComfyUI's Python. Note that snapshot_download may place files in a subdirectory — verify the structure afterward (see Step 3b).
cmd<ComfyUI_root>\python_embeded\python.exe -c "from huggingface_hub import snapshot_download; snapshot_download(repo_id='tencent/Hunyuan3D-2', allow_patterns='hunyuan3d-paint-v2-0/*', local_dir='/models/diffusers')"
For the DiT (shape generation) model in safetensors format:
Download from: https://huggingface.co/Kijai/Hunyuan3D-2_safetensors
Place at:
/models/diffusion_models/hy3dgen/hunyuan3d-dit-v2-0-fp16.safetensors
Step 3b — Fix Model Directory Structure
snapshot_download sometimes nests models in a subdirectory. Check:
cmddir \models\diffusers\hunyuan3d-paint-v2-0
If you see another hunyuan3d-paint-v2-0 folder inside, move the contents up:
cmdxcopy "\models\diffusers\hunyuan3d-paint-v2-0\hunyuan3d-paint-v2-0*" "\models\diffusers\hunyuan3d-paint-v2-0" /E /H /Y
xcopy "\models\diffusers\hunyuan3d-paint-v2-0\hunyuan3d-delight-v2-0*" "\models\diffusers\hunyuan3d-delight-v2-0" /E /H /Y
Verify that these files exist:
/models/diffusers/hunyuan3d-paint-v2-0/unet/config.json
/models/diffusers/hunyuan3d-delight-v2-0/unet/config.json
Step 4 — Patch setup.py (Blackwell Only) Open the following file in a text editor: \custom_nodes\ComfyUI-Hunyuan3DWrapper\hy3dgen\texgen\custom_rasterizer\setup.py Find this line: pythonnvcc_args = [] Replace with: pythonnvcc_args = ['--allow-unsupported-compiler'] Save and close.
This is required because CUDA 12.8 does not officially support VS 2022 v14.44+, but compilation succeeds in practice.
Step 5 — Compile custom_rasterizer for Blackwell Open a new Command Prompt and run all commands in the same window: Set environment variables cmdset PATH=C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools\VC\Tools\MSVC\14.44.35207\bin\Hostx64\x64;C:\Program Files\NVIDIA GPU Computing Toolkit\CUDA\v12.8\bin;C:\Windows\System32
set INCLUDE=C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools\VC\Tools\MSVC\14.44.35207\include;C:\Program Files (x86)\Windows Kits\10\Include\10.0.26100.0\ucrt;C:\Program Files (x86)\Windows Kits\10\Include\10.0.26100.0\um;C:\Program Files (x86)\Windows Kits\10\Include\10.0.26100.0\shared
set LIB=C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools\VC\Tools\MSVC\14.44.35207\lib\x64;C:\Program Files (x86)\Windows Kits\10\Lib\10.0.26100.0\ucrt\x64;C:\Program Files (x86)\Windows Kits\10\Lib\10.0.26100.0\um\x64
set CUDA_HOME=C:\Program Files\NVIDIA GPU Computing Toolkit\CUDA\v12.8
set TORCH_CUDA_ARCH_LIST=12.0
set VCToolsInstallDir=C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools\VC\Tools\MSVC\14.44.35207\
Navigate to the source directory cmd: cd \custom_nodes\ComfyUI-Hunyuan3DWrapper\hy3dgen\texgen\custom_rasterizer Build cmd<ComfyUI_root>\python_embeded\python.exe setup.py build_ext --inplace You should see output ending with: copying build\lib.win-amd64-cpython-312\custom_rasterizer_kernel.cp312-win_amd64.pyd -> . Install cmd<ComfyUI_root>\python_embeded\python.exe -m pip install . --force-reinstall
Step 6 — Verify and Launch Restart ComfyUI. The Hy3D Render MultiView node should now execute without errors.
Model File Reference ModelFormatLocationhunyuan3d-dit-v2-0-fp16.safetensorssafetensorsmodels/diffusion_models/hy3dgen/hunyuan3d-paint-v2-0diffusersmodels/diffusers/hunyuan3d-paint-v2-0/hunyuan3d-delight-v2-0diffusersmodels/diffusers/hunyuan3d-delight-v2-0/SDXL checkpoint (any)safetensorsmodels/checkpoints/SDXL/ControlNet Union SDXLsafetensorsmodels/checkpoints/SDXL/controlnet-union-sdxl-1.0/
Common Errors No module named 'custom_rasterizer' The wheel was not installed. Run Step 5. Windows fatal exception: code 0xc0000139 DLL mismatch — wrong wheel for your torch/CUDA version. Recompile from source (Step 5). CUDA error: no kernel image is available for execution on the device The rasterizer was compiled for a different GPU architecture. Make sure TORCH_CUDA_ARCH_LIST=12.0 is set before compiling. unsupported Microsoft Visual Studio version You are using VS 2026 or the wrong VS is in PATH. Set PATH explicitly to VS 2022 as shown in Step 5. Config not found at .../hunyuan3d-paint-v2-0/unet/config.json Model files are in the wrong directory. Follow Step 3b to fix the structure. CUDA version mismatch Wrong CUDA is active. Set CUDA_HOME and PATH to CUDA 12.8 explicitly as shown in Step 5.
Notes
All pip install commands must use <ComfyUI_root>\python_embeded\python.exe, not your system Python. Environment variables set via set are session-scoped. You must re-apply them each time you open a new CMD window for recompilation. If you update ComfyUI-Hunyuan3DWrapper, check whether setup.py was changed and re-apply the patch if needed. VS 2022 Build Tools should not be uninstalled — recompilation may be needed after future updates.
References
ComfyUI-Hunyuan3DWrapper by kijai Hunyuan3D-2 by Tencent Hunyuan3D-2 Safetensors by Kijai
Tested on: RTX 5070 Ti (Blackwell sm_120) · Windows 11 · PyTorch 2.8.0+cu128 · April 2026