Tencent's 3D Model, Repackaged for ComfyUI
It wraps Tencent's Hunyuan3D-2 into ComfyUI nodes so you can generate textured 3D meshes without duct-taping Python scripts.

What it does
This is largely glue code that wraps Tencent’s Hunyuan3D-2 text-to-3D pipeline into ComfyUI nodes, letting you generate textured meshes inside a visual workflow. It handles model conversion to .safetensors, autodownloads the remaining diffuser models, and adds a native 3D preview node—provided your ComfyUI install is recent enough.
The interesting bit
The author didn’t stop at Python plumbing; they bundled precompiled Windows wheels for a custom rasterizer and mesh processor so texture generation doesn’t force you into a C++ build hell. There’s even a manual xatlas source patch to fix UV wrapping on high-poly meshes, which is the kind of yak shave you don’t see every day.
Key highlights
- Brings Hunyuan3D-2 (text/image-to-3D) into ComfyUI as native nodes.
- Autodownloads diffuser models; main checkpoint offered as converted
.safetensors. - Ships precompiled Windows binaries for the texturegen rasterizer and mesh processor.
- Optional BPT (Bezier Patch Transformer) integration for alternative shape generation.
- Requires a bleeding-edge ComfyUI version for the
Preview3Dnode.
Caveats
- Precompiled wheels target a narrow Windows 11 / Python 3.12 / CUDA 12.6 setup; mismatch means compiling C++ extensions yourself.
- Fixing UV wrapping on high-poly meshes requires manually patching and reinstalling xatlas from source.
- Optional BPT support comes with “hefty requirements” and extra weight downloads.
Verdict
Worth a look if you’re already living in ComfyUI and want to experiment with generative 3D. If you’re not on the exact Windows portable stack, prepare for a build fight; otherwise, maybe wait for the ecosystem to smooth out the edges.
Frequently asked
- What is kijai/ComfyUI-Hunyuan3DWrapper?
- It wraps Tencent's Hunyuan3D-2 into ComfyUI nodes so you can generate textured 3D meshes without duct-taping Python scripts.
- Is ComfyUI-Hunyuan3DWrapper open source?
- Yes — kijai/ComfyUI-Hunyuan3DWrapper is an open-source project tracked on heatdrop.
- What language is ComfyUI-Hunyuan3DWrapper written in?
- kijai/ComfyUI-Hunyuan3DWrapper is primarily written in Python.
- How popular is ComfyUI-Hunyuan3DWrapper?
- kijai/ComfyUI-Hunyuan3DWrapper has 1k stars on GitHub.
- Where can I find ComfyUI-Hunyuan3DWrapper?
- kijai/ComfyUI-Hunyuan3DWrapper is on GitHub at https://github.com/kijai/ComfyUI-Hunyuan3DWrapper.