ComfyUI-Hunyuan3DWrapper

前言

ComfyUI-Hunyuan3Dwrapper 由kijai开发，是对腾讯混元3D模型的在comfyui上的实现。主要功能用于生成带有高分辨率纹理贴图的高保真度3D模型(Hunyuan3D-DiT-v2-0)和生成大规模纹理(Hunyuan3D-Paint-v2-0)

安装方法

1.manager安装

通过manager搜索ComfyUI-Hunyuan3DWrapper 安装。

2.git clone安装

进入 ComfyUI 的 custom_nodes 目录，并打开cmd

使用以下命令克隆仓库：

git clone https://github.com/kijai/ComfyUI-Hunyuan3DWrapper.git

使用以下命令进行依赖安装：

python_embeded> python -m pip install -r C:\AI\ComfyUI_windows_portable\ComfyUI\custom_nodes\ComfyUI-Hunyuan3DWrapper\requirements.txt

其他依赖安装

安装custom_rasterizer

安装纹理生成部分所需环境需要使用以下命令安装:（要根据自己环境选择对应的轮子）

其中custom_rasterizer-0.1-cp312-cp312-win_amd64.whl是基于torch build on 124

python_embeded\python.exe -m pip install ComfyUI\custom_nodes\ComfyUI-Hunyuan3DWrapper\wheels\custom_rasterizer-0.1-cp312-cp312-win_amd64.whl

如果没有自己环境版本则需要自行编译，具体方法请参考https://github.com/kijai/ComfyUI-Hunyuan3DWrapper?tab=readme-ov-file的《If this doesn't work or there isn't a suitable wheel available for your system. you need to compile yourself:》章节

安装BPT(可选)

python_embeded\python.exe -m pip install -r ComfyUI\custom_nodes\ComfyUI-Hunyuan3DWrapper\hy3dgen\shapegen\bpt\requirements.txt

下载weights: https://huggingface.co/whaohan/bpt/blob/refs%2Fpr%2F1/bpt-8-16-500m.pt

将bpt-8-16-500m.pt 文件拷贝到ComfyUI-Hunyuan3DWrapper-main\hy3dgen\shapegen\bpt目录下

Xatlas 升级程序以修复 UV 包裹高多边形网格(可选)

python_embeded\python.exe -m pip uninstall xatlas

在ComfyUI_windows_portable根目录下执行以下命令

git clone --recursive https://github.com/mworchel/xatlas-python.git
cd .\xatlas-python\extern
删除xatlas文件夹
git clone --recursive https://github.com/jpcy/xatlas

在xatlas-python\extern\xatlas\source\xatlas修改xatlas.cpp文件

将第 6774 行更改#if 0为//#if 0

将第 6778 行更改#endif为//#endif

最后在ComfyUI_windows_portable根目录下执行以下命令执行：

.\python_embeded\python.exe -m pip install .\xatlas-python\

安装完成后请重启COMFYUI

模型安装

kijai转换模型

下载地址：https://huggingface.co/Kijai/Hunyuan3D-2_safetensors

存放目录：ComfyUI/models/diffusion_models/

官方模型

DELIGHT和PAINT模型

下载地址：https://huggingface.co/tencent/Hunyuan3D-2/tree/main

存放目录：ComfyUI/models/diffusion/

注意要整个目录全部存放在ComfyUI/models/diffusion/下，而不是单个文件,也可以通过(Down)Load Hy3D DelightModel,(Down)Load Hy3D PaintModel节点自动下载

多图参考模型

下载地址：https://huggingface.co/tencent/Hunyuan3D-2mv/tree/main