【亲测免费】 ComfyUI-Hunyuan3DWrapper 项目安装与配置指南

1. 项目基础介绍

ComfyUI-Hunyuan3DWrapper 是一个开源项目，它为 ComfyUI 提供了 Hunyuan3D-2 模型的包装。Hunyuan3D-2 是一个基于深度学习的三维模型处理框架，主要用于生成和编辑三维模型。该项目的主要编程语言是 Python，同时也包含了一些 C++ 和 Cuda 代码。

2. 关键技术与框架

该项目使用的关键技术包括：

• Hunyuan3D-2 模型：用于三维模型处理的核心算法。
• ComfyUI：一个易于使用的图形用户界面，用于操作 Hunyuan3D-2 模型。
• PyTorch：一个流行的深度学习框架，用于模型的训练和推理。
• CUDA：NVIDIA 提供的并行计算平台和编程模型，用于加速计算。

3. 安装与配置

准备工作

在开始安装之前，请确保您的系统中已经安装了以下依赖：

• Python 3.12
• pip（Python 的包管理工具）
• CUDA（如果您需要 GPU 加速）

安装步骤

1. 克隆项目仓库

   打开命令行工具，执行以下命令以克隆项目仓库：

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

2. 安装依赖

   在项目目录中，执行以下命令安装项目所需的 Python 包：

   pip install -r requirements.txt
   

   如果您使用的是便携式 Python 环境（如 ComfyUI_windows_portable），则可能需要使用该环境中的 python_embeded\python.exe 来执行 pip 命令。

3. 安装自定义编译的扩展

   根据您的系统配置，可能需要编译和安装一些扩展。以下是一些示例命令：

   • 安装自定义光栅化器

     cd hy3dgen/texgen/custom_rasterizer
     python setup.py install
     

   • 安装网格处理扩展

     cd hy3dgen/texgen/differentiable_renderer
     python setup.py build_ext --inplace
     

   如果您使用的是便携式 Python 环境，请使用嵌入式 Python 执行上述命令。

4. 更新 Xatlas

   如果需要处理高多边形网格的 UV 包裹，可能需要更新 Xatlas：

   pip uninstall xatlas
   git clone --recursive https://github.com/mworchel/xatlas-python.git
   cd xatlas-python/extern
   git clone --recursive https://github.com/jpcy/xatlas
   

   然后修改 xatlas.cpp 文件，按照项目说明中的指示进行更改，并安装更新后的 xatlas。

5. 下载预训练权重

   根据项目说明，从 Hugging Face 或其他指定位置下载 Hunyuan3D-2 的预训练权重文件，并将其复制到项目目录中相应的位置。

完成以上步骤后，您应该已经成功安装了 ComfyUI-Hunyuan3DWrapper 项目，并可以开始使用了。如果有任何额外的配置或步骤，请参考项目仓库中的 README.md 文件。