Hunyuan3D-2 安装教程从克隆到输出带纹理 3D 模型10 分钟跑通【免费下载链接】Hunyuan3D-2High-Resolution 3D Assets Generation with Large Scale Hunyuan3D Diffusion Models.项目地址: https://gitcode.com/GitHub_Trending/hu/Hunyuan3D-2第一次跑 Hunyuan3D-2——这个用单张图片生成带纹理 3D 模型的开源系统——最容易卡住的是编译光栅化器时弹出fatal error: cuda_runtime.h file not found或者from_pretrained下权重时长时间没动静。最短路径其实只有三条命令克隆、装依赖、跑 demo。有 NVIDIA 显卡的话约 10 分钟能拿到一个 GLB 文件。跑通Hunyuan3D-2 最短安装步骤系统要求LinuxUbuntu 20.04Windows 走 WSL2NVIDIA GPU CUDA 11.8/12.1几何生成约需 6GB 显存几何纹理全流程约 24.5GBPython 3.1050GB 可用磁盘其中约 8GB 以上为模型下载最短安装路径git clone https://gitcode.com/GitHub_Trending/hu/Hunyuan3D-2 cd Hunyuan3D-2 pip install torch # 先装 CUDA 版 PyTorch光栅化器编译依赖 CUDA 头文件 pip install -r requirements.txt # 一次装齐 diffusers、trimesh、gradio 等其余依赖两个自定义渲染模块需要本地编译纹理生成离不开它们cd hy3dgen/texgen/custom_rasterizer python3 setup.py install cd ../../.. # 自定义光栅化器没有现成 wheel必须本机编译 cd hy3dgen/texgen/differentiable_renderer python3 setup.py install cd ../../.. # 可微渲染器同样需要本机编译跑第一次生成python3 minimal_demo.py # 首次自动下载约 8GB 权重最后输出 demo.glb跑对了的标志当前目录出现demo.glb用 Blender 或任意网页 3D 查看器能直接打开。Hunyuan3D-2 编译报错解决编译失败几乎都是torch 不是 CUDA 版。先确认python3 -c import torch; print(torch.__version__, torch.version.cuda)第二行输出None就重装 CUDA 版 torch再按上面顺序重跑两个setup.py。显存只有 8GB先用 mini 版跑通流程python3 examples/shape_gen_mini.py⚠️ 仓库是只读的两个 setup.py 不要改。编译失败时优先检查 torch 版本缺构建工具则补装 ninja 与 pybind11pip install ninja pybind11。跑顺Hunyuan3D-2 高频报错与调优先拿一张官方示例图把几何生成跑起来现象原因解法权重下载卡住HF 官方访问不稳export HF_ENDPOINThttps://hf-mirror.com编译报cuda.h缺失torch 是 CPU 版重装 CUDA 版 torch 后重编纹理生成 OutOfMemory显存不足 24.5GB启动加--low_vram_mode或换 mini 模型Gradio 8080 端口占用端口冲突python3 gradio_app.py --port 8081调优建议模型缓存挪到大盘export HF_HOME/data/hf_cache8GB 显存走全流程--model_path tencent/Hunyuan3D-2mini --low_vram_mode用 Turbo 蒸馏模型提速--subfolder hunyuan3d-dit-v2-0-turbo --enable_flashvdm 24.5GB 是几何纹理两步合计只跑几何生成 6GB 显存就够纹理步骤可单独换机跑。跑深按使用场景接入 Hunyuan3D-2单次出图适合验证效果、出一两个模型。挑一张单主体图片仓库 assets/example_images 下就有现成例子python3 examples/shape_gen.py # 只生成几何输出 demo.glb python3 minimal_demo.py # 几何纹理全流程跑对了的标志目录里出现demo.glb拖进 Blender 或网页查看器能看到完整纹理。Gradio 界面操作适合不想写代码、边调参数边看效果python3 gradio_app.py --model_path tencent/Hunyuan3D-2 --subfolder hunyuan3d-dit-v2-0 --low_vram_mode浏览器打开http://localhost:8080。跑对了的标志页面显示 Hunyuan-3D-2.0左侧选一张示例图点生成右侧 3D 窗口能旋转预览网格。多视角图输入适合手里有正、背、侧多角度照片想要更准的几何python3 examples/shape_gen_multiview.py输入需要四视角图片目录仓库在 assets/example_mv_images 下备了成套示例。跑对了的标志绕到模型背面看轮廓与输入照片一致不像单图输入那样脑补变形。对外提供服务适合接进自己的 Web 应用或给团队共用python3 api_server.py --host 0.0.0.0 --port 8080 --enable_tex调用方只发 HTTP 请求img_b64$(base64 -i assets/demo.png) curl -X POST http://localhost:8080/generate -H Content-Type: application/json -d {\image\:\$img_b64\} -o out.glb跑对了的标志out.glb直接生成调用端不需要装任何模型依赖。延伸资源代码 API 说明docs/source/started/code.md10 使用示例多视角、FlashVDM 加速examples/模型列表mini/mv/Turbo 各版本与显存需求docs/source/modelzoo.mdAPI 服务说明docs/source/started/api.mdBlender 插件blender_addon.py需先启动 API 服务下一步建议先用 Turbo 蒸馏版把出图速度拉满再把 api_server.py 接进你现有的工作流。项目迭代快新功能和模型版本看 README_zh_cn.md 顶部的最新消息部分。【免费下载链接】Hunyuan3D-2High-Resolution 3D Assets Generation with Large Scale Hunyuan3D Diffusion Models.项目地址: https://gitcode.com/GitHub_Trending/hu/Hunyuan3D-2创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
