← all repositories
kijai/ComfyUI-Hunyuan3DWrapper

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.

ComfyUI-Hunyuan3DWrapper
Not currently ranked — collecting fresh signals.
star history

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 Preview3D node.

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.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.