Skip to content

2025/01/22 Hunyuan3D-2 Special

Pre-release
Pre-release
Compare
Choose a tag to compare
@github-actions github-actions released this 23 Jan 02:14
· 3 commits to fd6fb9fc35c233e11789f482ebe52276f8759bec since this release
r8-hunyuan3d2
30876e3
This commit was signed with the committer’s verified signature.
YanWenKun YAN Wenkun
GPG key ID: CF637F3AF52930DE
Verified
Learn about vigilant mode.

screenshot

UPDATE

This sub-project has become a standalone project. Please visit the new repository and use the updated package:
本项目已移至独立仓库，请前往下载新版：
https://github.com/YanWenKun/Hunyuan3D-2-WinPortable

This is a special release for Hunyuan3D-2. It only runs the Hunyuan3D-2 Gradio app (official demo) and has nothing to do with ComfyUI. I put it here just for convenience.

Usage

  1. Install MSVC and CUDA, see INSTRUCTIONS.
  2. Download and extract Hunyuan3D2_WinPortable.7z.
    Run the scripts 1-2-3.
    Unlike Comfy3D-WinPortable, you don't need to edit these scripts, except for configuring internet proxies.
  3. Open http://localhost:8080/
  4. The output files are saved under Hunyuan3D-2\gradio_cache.

Notes

  • This bundle integrates the mmgp made by deepbeepmeep. Which means:

    • 6GB of VRAM is sufficient for generating meshes only.
    • 10GB of VRAM for generating meshes and textures.
    • 24GB of system RAM is required.

  • The "Remove Background" feature uses rembg with default settings, which may output slightly white edges. Turn it off if your images already have clear alpha channels.

  • The "Text to 3D" feature is disabled by default. It consists of:

    1. Text to Image
    2. Image to 3D
      For experienced users, it might not be worth downloading another Text-to-Image model.

  • For GPUs earlier than Turing (RTX 20 series), a message "EP Error: Can't load TensorRT" will appear. And it will automatically fallback to CUDA, so you can safely ignore this message.

本次发布专门适配 混元3D 2.0 的 Gradio App，与 ComfyUI 无关，放这里只是为了省事，毕竟用户群重合。

用法

  1. 安装 MSVC 和 CUDA，参照当前 Comfy3D-WinPortable 文档
  2. 下载并解压 Hunyuan3D2_WinPortable.7z ，把中文脚本复制到上级目录，无需修改脚本，按顺序 123 执行即可
  3. 启动完毕后，打开 http://localhost:8080/
  4. 生成的文件保存在 Hunyuan3D-2\gradio_cache 下

备注

  • 本包整合了 mmgp，大幅减少显存需求，只需 6GB 显存就可生成网格，10GB 显存可生成网格与纹理。注意系统内存需要不低于 24GB。
  • 移除背景（Remove Background）功能使用的是 rembg （默认配置），可能会生成轻微白边。如果你的图片本身已经抠干净背景了，就没必要勾选这个功能了。
  • 文生 3D 的原理是先文生图，再图生 3D。对于有经验的用户而言，可能没有必要再下载一个文生图模型，因此默认不启用该功能。
  • 对于 20 系之前的显卡，会提示 "EP Error: Can't load TensorRT"，忽略即可，程序找不到 Tensor 执行会自动改用 CUDA 执行。

THANKS TO:

Thanks for all of you! It happens so quick and was truly amazing!

Versions Info
PyTorch 2.5.1 | CUDA 12.4 | Python 3.12.8

Modified repo used by this bundle: https://github.com/YanWenKun/Hunyuan3D-2
Build scripts for this bundle: https://github.com/YanWenKun/Comfy3D-WinPortable/tree/main/pt25-cu124-hunyuan3d2

Assets 3
Loading