Hunyuan3D-1

环境要求

• Linux 系统（README 仅提供 Linux 安装指引）
• 已安装 conda 环境管理工具
• Python 3.9 / 3.10 / 3.11 / 3.12 之一
• 支持 CUDA 12.1 的 NVIDIA 显卡与驱动

安装与启动步骤

1. 1创建 conda 环境

   按 README 建议新建独立环境，Python 版本在 3.9~3.12 中选择，避免与其他项目依赖冲突。

   conda create -n hunyuan3d-1 python=3.10 -y
   conda activate hunyuan3d-1

   复制

2. 2拉取项目代码

   克隆官方仓库并进入目录，后续安装脚本与推理脚本都在该目录下执行。

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

   复制

3. 3安装 PyTorch

   使用 README 指定的 cu121 索引源安装 torch 与 torchvision，保证与 CUDA 12.1 匹配。

   pip3 install torch torchvision --index-url https://download.pytorch.org/whl/cu121

   复制

4. 4执行环境脚本

   运行仓库自带的环境安装脚本，安装其余依赖；需在已激活的 conda 环境中执行。

   bash env_install.sh

   复制

5. 5准备模型权重

   从 README 给出的 Checkpoints 页面获取 Hunyuan3D-1 权重，放置位置与加载方式以仓库说明为准。

6. 6校验环境可用

   导入 torch 并检查 CUDA 是否可用，输出 True 说明 GPU 环境已就绪。

   python -c "import torch; print(torch.cuda.is_available())"

   复制

如何确认成功

conda 环境激活后能以 bash env_install.sh 顺利安装依赖，且 torch.cuda.is_available() 返回 True。

常见问题

注意事项

• 安装命令均来自 README 的 Linux 安装指引，推理脚本的具体参数请以仓库最新说明为准。
• 模型权重体积较大，请预留充足磁盘空间并保证下载完整。
• 建议在独立 conda 环境中安装，避免与系统 Python 依赖冲突。