Hunyuan3D-2-WinPortable

环境要求

• Windows 系统 + NVIDIA 显卡，显卡驱动版本 ≥ 576.57（2025 年 6 月之后）
• 几何（白模）生成需 ≥ 3 GB 显存（2.1 模型最大优化下）
• 纹理生成需 ≥ 6 GB 显存（2.0 模型最大优化下）
• 系统内存 ≥ 24 GB，显存越少所需内存越多（用于模型卸载）
• 可选：CUDA Toolkit 12.9.1 与 Visual Studio Build Tools 2022，用于生成纹理

安装与启动步骤

1. 1确认显卡与显存

   查看自己的 NVIDIA 显卡型号与显存大小，确认满足几何 3GB、纹理 6GB 显存和 24GB 内存要求，并更新驱动到 576.57 以上。

2. 2按架构选整合包

   Blackwell/Ada/Ampere/Turing 选 CUDA 12.9 或 12.6 版；Volta、Pascal、Maxwell 等老架构只能用 CUDA 12.6 版，CUDA 12.9 不支持。

3. 3下载并解压整合包

   从项目 Release 下载对应 GPU 架构的压缩包，解压到空间充足的目录（建议非中文、非系统盘路径），包内已自带 Python、CUDA 运行时与依赖库。

4. 4运行启动脚本

   双击整合包内的批处理脚本启动 Hunyuan3D 2.0/2.1 官方 Gradio Web 应用，首次运行需等待模型加载，不要关闭命令行窗口。

5. 5安装 CUDA 工具包（可选）

   如需生成纹理，安装 CUDA Toolkit 12.9.1，安装时只需勾选 Libraries 和 Compilers；已有其他版本（如 13.0）理论上也可用，无需重装。

6. 6安装 VS 生成工具（可选）

   同样为生成纹理所需，下载安装 Visual Studio Build Tools 2022，在安装器中勾选“使用 C++ 的桌面开发”工作负载。

关键配置

如何确认成功

启动脚本窗口正常输出且 Gradio Web 界面能在浏览器中打开、输入提示词或图片能正常生成即算成功。

常见问题

注意事项

• CUDA 12.9 与 CUDA 12.6 整合包按显卡架构区分，选错会导致无法运行（12.9 不支持 Volta 及更早架构）。
• 显卡驱动必须 ≥576.57，否则可能无法正常调用 GPU。
• 不安装 CUDA Toolkit 和 VS Build Tools 只能得到白模，纹理功能不可用。
• 整合包为便携版，所有依赖已内置，不要手动替换包内的 Python 或 CUDA 运行库。