ComfyUI-Hunyuan3DWrapper 项目安装与配置指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00733/article/details/147008342

ComfyUI-Hunyuan3DWrapper 项目安装与配置指南

ComfyUI-Hunyuan3DWrapper 项目地址: https://gitcode.com/gh_mirrors/co/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 加速）

安装步骤

克隆项目仓库

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

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

安装依赖

在项目目录中，执行以下命令安装项目所需的 Python 包：
```
pip install -r requirements.txt
```
如果您使用的是便携式 Python 环境（如 ComfyUI_windows_portable），则可能需要使用该环境中的 python_embeded\python.exe 来执行 pip 命令。
安装自定义编译的扩展

根据您的系统配置，可能需要编译和安装一些扩展。以下是一些示例命令：
- 安装自定义光栅化器
```
cd hy3dgen/texgen/custom_rasterizer
python setup.py install
```
- 安装网格处理扩展
```
cd hy3dgen/texgen/differentiable_renderer
python setup.py build_ext --inplace
```
如果您使用的是便携式 Python 环境，请使用嵌入式 Python 执行上述命令。
更新 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。
下载预训练权重

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