← all repositories
YanWenKun/Hunyuan3D-2-WinPortable

Tencent’s 3D AI, repackaged for GPUs as small as 3 GB

A pre-assembled Windows bundle that squeezes Tencent’s Hunyuan3D 2.x onto consumer-grade NVIDIA GPUs.

1.3k stars Batchfile Image · Video · Audio
Hunyuan3D-2-WinPortable
Not currently ranked — collecting fresh signals.
star history

What it does

This is a portable Windows distribution of Tencent’s Hunyuan3D 2.0 and 2.1, the diffusion models that generate textured 3D meshes from text or images. The repo is essentially packaging glue: it bundles the official code, a Gradio web frontend, and DeepBeepMeep’s mmgp memory optimizations into a single archive. The goal is to let you run the official demo locally on Windows without assembling Python environments or hunting for compatible CUDA wheels.

The interesting bit

The value is in the subtraction. By integrating mmgp, the pack brings VRAM requirements down to roughly 3 GB for geometry and 6 GB for texture generation—territory that mid-range consumer cards actually own. It also splits the archive into split-compressed chunks and handles model downloading on demand, which turns a multi-repo science project into something that runs from a single folder.

Key highlights

  • Bundles both Hunyuan3D 2.0 and 2.1, plus vanilla and API variants, in one download.
  • Integrates mmgp memory optimizations so the official models run on consumer NVIDIA GPUs with limited VRAM.
  • Ships a launcher script and updater; models download on first run rather than bloating the initial archive.
  • Requires NVIDIA driver version 576.57 or newer (June 2025 onward) and at least 24 GB of system RAM for offloading when VRAM is tight.
  • Texture generation depends on separately installed CUDA Toolkit and Visual Studio Build Tools; without them you still get untextured “white” meshes.

Caveats

  • Texture generation is not fully self-contained: you need your own CUDA Toolkit and Visual Studio Build Tools installed, or you are limited to untextured white meshes.
  • The package cannot include bpy (Headless Blender) due to CI packaging constraints, though the README states this does not materially affect usability.
  • NVIDIA driver 576.57 or newer is mandatory, and GPU architecture dictates whether you must use the CUDA 12.6 or 12.9 build.

Verdict

Grab this if you want to run Tencent’s official Hunyuan3D demo on a Windows box with a mid-range NVIDIA card and do not feel like manually wrestling PyTorch, Gradio, and mmgp into place. Skip it if you are on Linux, macOS, or an AMD GPU; this is a Windows-only convenience layer.

Frequently asked

What is YanWenKun/Hunyuan3D-2-WinPortable?
A pre-assembled Windows bundle that squeezes Tencent’s Hunyuan3D 2.x onto consumer-grade NVIDIA GPUs.
Is Hunyuan3D-2-WinPortable open source?
Yes — YanWenKun/Hunyuan3D-2-WinPortable is open source, released under the GPL-3.0 license.
What language is Hunyuan3D-2-WinPortable written in?
YanWenKun/Hunyuan3D-2-WinPortable is primarily written in Batchfile.
How popular is Hunyuan3D-2-WinPortable?
YanWenKun/Hunyuan3D-2-WinPortable has 1.3k stars on GitHub.
Where can I find Hunyuan3D-2-WinPortable?
YanWenKun/Hunyuan3D-2-WinPortable is on GitHub at https://github.com/YanWenKun/Hunyuan3D-2-WinPortable.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.