Hunyuan3D-1 使用教程

Hunyuan3D-1 使用教程

Hunyuan3D-1 Tencent Hunyuan3D-1.0: A Unified Framework for Text-to-3D and Image-to-3D Generation 项目地址: https://gitcode.com/gh_mirrors/hu/Hunyuan3D-1

1. 项目介绍

Hunyuan3D-1 是腾讯开源的一个统一框架，用于文本到3D和图像到3D的生成。该框架包括轻量版和标准版，两者都支持基于文本和图像的条件生成。Hunyuan3D-1 通过两阶段的生成方式，第一阶段使用多视角扩散模型高效生成多视角RGB图像，第二阶段则引入一个前向重构模型，迅速且忠实地重建3D资产。

2. 项目快速启动

环境搭建

首先，克隆仓库到本地：

git clone https://github.com/Tencent/Hunyuan3D-1
cd Hunyuan3D-1

然后，使用提供的脚本设置环境：

conda create -n hunyuan3d-1 python=3.9
conda activate hunyuan3d-1
pip3 install torch torchvision --index-url https://download.pytorch.org/whl/cu121
bash env_install.sh

或者，直接安装依赖：

pip3 install -r requirements.txt --index-url https://download.pytorch.org/whl/cu121
pip3 install git+https://github.com/facebookresearch/pytorch3d@stable
pip3 install git+https://github.com/NVlabs/nvdiffrast

下载预训练模型

模型可以从 Hugging Face 仓库下载：

mkdir weights
huggingface-cli download tencent/Hunyuan3D-1 --local-dir ./weights
mkdir weights/hunyuanDiT
huggingface-cli download Tencent-Hunyuan/HunyuanDiT-v1.1-Diffusers-Distilled --local-dir ./weights/hunyuanDiT

文本到3D生成

使用以下命令进行文本到3D的生成：

python3 main.py --text_prompt "一个可爱的兔子" --save_folder ./outputs/test --max_faces_num 90000 --do_texture_mapping --do_render

图像到3D生成

使用以下命令进行图像到3D的生成：

python3 main.py --image_prompt "/path/to/your/image" --save_folder ./outputs/test --max_faces_num 90000 --do_texture_mapping --do_render

3. 应用案例和最佳实践

• 案例1：使用 Hunyuan3D-1 为游戏开发创建3D角色模型。
• 案例2：通过 Hunyuan3D-1 生成虚拟现实环境中的3D物体。
• 最佳实践：在生成3D模型时，合理设置 --max_faces_num 和 --gen_steps 以优化模型的质量和生成速度。

4. 典型生态项目

• 项目1：使用 Hunyuan3D-1 生成的3D模型在Unity游戏引擎中的集成。
• 项目2：将 Hunyuan3D-1 集成到Web应用中，为用户提供在线3D模型生成服务。

Hunyuan3D-1 Tencent Hunyuan3D-1.0: A Unified Framework for Text-to-3D and Image-to-3D Generation 项目地址: https://gitcode.com/gh_mirrors/hu/Hunyuan3D-1