ComfyUI-Hunyuan3DWrapper 使用教程

1. 项目介绍

ComfyUI-Hunyuan3DWrapper 是一个开源项目，旨在为 ComfyUI 提供一个 Hunyuan3D-2 模型的包装器。Hunyuan3D-2 是一个三维模型生成模型，通过这个包装器，用户可以在 ComfyUI 中方便地使用 Hunyuan3D-2 的功能。

2. 项目快速启动

环境准备

在开始之前，确保你的环境中已经安装了 Python。然后，克隆项目到本地：

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

安装依赖

安装项目所需的依赖：

pip install -r requirements.txt

如果你的系统是 Windows，并且使用的是便携式 ComfyUI 安装，你可能需要使用以下命令：

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

编译纹理生成部分

项目中的纹理生成部分需要编译。如果你使用的是 Windows 11，Python 3.12，CUDA 126，可以安装预编译的 wheel 文件：

pip install wheels\custom_rasterizer-0.1-cp312-cp312-win_amd64.whl

对于便携式 ComfyUI 安装，使用以下命令：

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

如果预编译的 wheel 文件不适用于你的系统，你需要自己编译：

cd hy3dgen/texgen/custom_rasterizer
python setup.py install

下载模型权重

从 Hugging Face 下载 Hunyuan3D-2 的模型权重，并将其复制到项目的相应目录：

# 示例下载命令
# 实际下载链接可能需要根据官方提供的最新链接进行替换
wget https://huggingface.co/tencent/Hunyuan3D-2/blob/main/hunyuan3d-dit-v2-0/model.ckpt -O hunyuan3d-dit-v2-0/model.ckpt
cp hunyuan3d-dit-v2-0/model.ckpt ComfyUI/models/diffusion_models/

3. 应用案例和最佳实践

（由于项目具体应用案例和最佳实践未提供，此处为示例性内容）

案例一：三维模型生成

通过 ComfyUI-Hunyuan3DWrapper，用户可以生成具有不同风格的三维模型。以下是一个简单的示例代码：

# 示例代码，实际使用时需要根据项目文档进行调整
from ComfyUI import ComfyUI
from ComfyUI_Hunyuan3DWrapper import Hunyuan3DModel

# 初始化 ComfyUI
ui = ComfyUI()

# 加载 Hunyuan3D-2 模型
model = Hunyuan3DModel.load_model('path/to/model.ckpt')

# 生成三维模型
model.generate_model(style='style_name')

案例二：模型风格迁移

用户可以利用 Hunyuan3D-2 模型进行模型风格迁移，将一个模型的风格应用到另一个模型上。

# 示例代码，实际使用时需要根据项目文档进行调整
from ComfyUI import ComfyUI
from ComfyUI_Hunyuan3DWrapper import Hunyuan3DModel

# 初始化 ComfyUI
ui = ComfyUI()

# 加载 Hunyuan3D-2 模型
model = Hunyuan3DModel.load_model('path/to/model.ckpt')

# 加载源模型和目标模型
source_model = ui.load_model('path/to/source_model')
target_model = ui.load_model('path/to/target_model')

# 进行风格迁移
model.style_transfer(source_model, target_model, style='style_name')

4. 典型生态项目

（由于项目生态未提供详细信息，此处为示例性内容）

ComfyUI-Hunyuan3DWrapper 可以与其他开源项目结合使用，例如：

• ComfyUI-Extension: 一个扩展 ComfyUI 功能的插件项目。
• 3D-Viewer: 一个用于查看和交互三维模型的网页应用。

通过整合这些项目，用户可以构建一个完整的三维模型生成和展示工作流程。