admin 管理员组文章数量: 1184232
一份真正小白可跟着敲的“保姆级”本地部署教程，以腾讯混元 Hunyuan3D-2.1为例（它是目前官方主推、带 PBR 材质的 3D 资产生成模型，并自带浏览器可视化界面）。 Windows 11推荐用 WSL2+Ubuntu 22.04。部署成功启动后网页访问图如下。
先说“门槛”
显存需求（官方给出的测试数据）：仅“生成形状（mesh）”≈ 10 GB；仅“生成纹理（PBR 材质）”≈ 21 GB；形状+纹理全流程≈ 29 GB。低显存也能跑，但需开启
--low_vram_mode，速度会慢、分辨率可能下调。环境版本（官方测试）：Python 3.10，PyTorch 2.5.1 + CUDA 12.4。支持 macOS / Windows / Linux，并提供 Gradio 可视化 Web 界面。
一、Windows 11（WSL2 + Ubuntu 22.04）
0）一次性准备
-
更新 NVIDIA 显卡驱动（最新版 Game Ready 或 Studio 都可），官方下载网址下载 NVIDIA 官方驱动 | NVIDIA。
-
开启 WSL2：管理员 PowerShell 执行（没有安装WSL2，请查看Windows 10/11 安装wsl2及前置条件-CSDN博客）
wsl --install -d Ubuntu-22.04重启后打开“Ubuntu”终端，执行
nvidia-smi能看到显卡即表示 WSL 已接管 GPU。 -
在 Ubuntu 里更新基础工具：
sudo apt update && sudo apt install -y git wget python3.10 python3.10-venv python3-pip build-essential
1）创建工程
# 1. 拉仓库（官方）
git clone https://github/Tencent-Hunyuan/Hunyuan3D-2.1.git
cd Hunyuan3D-2.1
2）安装 PyTorch（与 CUDA 版本匹配）
这个要根据自己的显卡型号安装对应版本。
pip install --pre torch torchvision torchaudio --index-url https://download.pytorch/whl/nightly/cu128
pip install "numpy<2"
3）安装其余依赖并编译渲染模块
项目有两个需要编译的组件：
custom_rasterizer与DifferentiableRenderer（官方 README 就是这么写的）。
# 项目依赖
pip install -r requirements.txt
# 编译 custom_rasterizer
cd hy3dpaint/custom_rasterizer
pip install -e .
cd ../..
# 编译 DifferentiableRenderer
cd hy3dpaint/DifferentiableRenderer
bash compile_mesh_painter.sh
cd ../..
4）下载超分模型权重（用于纹理阶段）
官方指定 Real-ESRGAN 的权重文件下载路径与保存目录：
wget https://github/xinntao/Real-ESRGAN/releases/download/v0.1.0/RealESRGAN_x4plus.pth -P hy3dpaint/ckpt
5）启动可视化网页（Gradio）
仓库自带
gradio_app.py，官方给了启动示例；--low_vram_mode适合显存吃紧时使用：
# 形状+纹理都要（显存足够时）
python gradio_app.py \
--model_path tencent/Hunyuan3D-2.1 \
--subfolder hunyuan3d-dit-v2-1 \
--texgen_model_path tencent/Hunyuan3D-2.1
# 显存紧张（建议加上低显存模式）
python gradio_app.py \
--model_path tencent/Hunyuan3D-2.1 \
--subfolder hunyuan3d-dit-v2-1 \
--texgen_model_path tencent/Hunyuan3D-2.1 \
--low_vram_mode
打开浏览器访问 http://127.0.0.1:8080，即可用图生 3D 的可视化界面。（根据显示端口调整）
二、硬件与性能建议（选型小抄）
-
只做形状（mesh）：建议 ≥ 10 GB 显存（如 RTX 3080/4070 等都可）。
-
做形状+纹理（PBR）：建议 ≥ 24–30 GB 显存（如 3090/4090/A5000 等更稳）。
-
系统内存：至少 32 GB 体验更顺；磁盘预留几十 GB（模型权重+缓存+导出）。
-
低显存机器：使用
--low_vram_mode，先跑形状，纹理阶段降规格或分步处理。以上显存数字均来自官方 README。
三、常见坑 & 解决办法
-
torch/CUDA版本不匹配 → 查看显卡支持的cuda最高版本。 -
显存不够 → 加上
--low_vram_mode，或先只生成形状，纹理阶段降低分辨率/视角数。
如果你觉得“蓝白AI”公众号或这篇文章对你有帮助，请给我点赞、在看、转发分享给更多的朋友。
有任何问题或者想法，欢迎在评论区留言交流。
版权声明：本文标题：腾讯混元 Hunyuan3D-2.1真正小白可跟着敲的“保姆级”本地部署教程 内容由网友自发贡献，该文观点仅代表作者本人， 转载请联系作者并注明出处：http://www.roclinux.cn/b/1767919139a3517916.html， 本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌抄袭侵权/违法违规的内容，一经查实，本站将立刻删除。
发表评论