English | 中文说明

Hunyuan3D 2.0/2.1 Windows Portable Pack

A dedicated package for running Hunyuan3D 2.0 and Hunyuan3D 2.1 Gradio Web App (official demo) on Windows.

Integrated mmgp from Hunyuan3D-2GP made by DeepBeepMeep, allowing the models to run on consumer-grade GPUs.

Instructions - Preparation

1. Basic Requirements

• NVIDIA GPU with driver version ≥576.57 (i.e., after June 2025).

• ≥ 3 GB VRAM for geometry generation (with maximum optimization for 2.1 model)

• ≥ 6 GB VRAM for texture generation (with maximum optimization for 2.0 model)

• ≥ 24 GB System RAM (the less VRAM you have, the more RAM is needed for model offloading)

2. Download the Pack Based on Your GPU Architecture

GPU Architecture	Blackwell	Ada Lovelace	Ampere	Turing	Volta	Pascal	Maxwell
Example GPU	RTX 5090	RTX 4090	RTX 3090	RTX 2080	TITAN V	GTX 1080	GTX 980
CUDA 12.9	✔️	✔️	✔️	✔️	❌	❌	❌
CUDA 12.6	❌	✔️	✔️	✔️	✔️	✔️	✔️

Note: This CUDA compatibility limitation comes from PyTorch and is not related to NVIDIA CUDA Toolkit.

• Download for CUDA 12.9:

  • Hunyuan3D2_WinPortable_cu129.7z.001

  • Hunyuan3D2_WinPortable_cu129.7z.002

• Download for CUDA 12.6:

  • Hunyuan3D2_WinPortable_cu126.7z.001

  • Hunyuan3D2_WinPortable_cu126.7z.002

• After downloading 001 and 002 files, place them in the same directory, then open and extract the 001 file.

  • Extract to a shallow directory path, such as C:\AI\HY3D2, to avoid errors caused by long paths (exceeding the MAX_PATH limit of 260 characters).

  • You do not need to open the 002 file. The extraction software will automatically handle it when decompressing the 001 file. They are two parts of a single large archive created using "split compression".

  • You can use 7-Zip for extraction.

• You can also check the Releases page for other versions.

3. (Optional) Enable Developer Mode

Search for "Developer settings" in the Start Menu, or go to Settings → System → For developers, and enable "Developer Mode".

This mode enables the file system’s symbolic link (symlink) feature, which prevents the Hugging Face Hub from repeatedly downloading model files and causing the model storage directory to become excessively large.

4. (Optional) Install Tools for Texture Generation

If you do not install the following tools, the program can still generate mesh ("shape" or "white model"), but it will not be able to generate textures.

1. Install CUDA Toolkit 12.9.1

   • During installation, you only need to select Libraries and Compilers.

   • Other versions (e.g., 13.0 ) should theoretically work fine, and there is no need to reinstall if you already have one.

2. Install Visual Studio Build Tools 2022 ( Download page | Installer )

   • In the installer, select the "Desktop development with C++" workload.

Instructions - Launcher

1. Double-click RUN.bat to run the launcher.

2. If you check "Enable Texture Generation", the necessary dependencies for this feature will be automatically compiled and installed on the first launch, which may take longer.

3. Model files will be downloaded on demand when the program starts.

4. After the message running on http://0.0.0.0:8080 appears, open http://localhost:8080/ in your browser.

5. You can force quit the program by closing the command line window.

Instructions - Program Selection

1. Hunyuan3D 2.0: Corresponds to the Hunyuan3D-2 folder. Generated files are in its gradio_cache subdirectory.

2. Hunyuan3D 2.0 Official Code: Corresponds to the Hunyuan3D-2-vanilla folder. Generated files are in its gradio_cache subdirectory.

   • Does not use mmgp optimizations. It requires more VRAM but generates faster.

   • Available model references:

   • https://huggingface.co/tencent/Hunyuan3D-2/tree/main

   • https://huggingface.co/tencent/Hunyuan3D-2mini/tree/main

   • https://huggingface.co/tencent/Hunyuan3D-2mv/tree/main

   • Third-party fine-tuned models should theoretically work but have not been tested.

3. Hunyuan3D 2.1: Corresponds to the Hunyuan3D-2.1 folder. Generated files are in its save_dir subdirectory.

4. API 2.0: Corresponds to the Hunyuan3D-2 folder, includes partial mmgp VRAM optimizations.

5. API 2.1: Corresponds to the Hunyuan3D-2.1 folder, does not include mmgp VRAM optimizations.

   • Available model references:

   • https://huggingface.co/tencent/Hunyuan3D-2.1/tree/main

Usage Tips

1. To view 3D files like glb and obj, you can use MeshLab.

2. After checking "Use Turbo Model", you can still select Fast or Standard mode in the web UI to improve generation quality.

3. The "Remove Background" feature uses rembg with its default settings, which might leave faint white edges. If your image already has a clean (alpha/transparent) background, there is no need to check this option.

4. "Developer Mode" can be turned off at any time.

Advanced Information

1. The "Text-to-3D" feature uses the HunyuanDiT-v1.1-Diffusers-Distilled text-to-image model.

2. For the specific meaning of each mmgp optimization level, please refer to the mmgp documentation .

3. For process control and batch generation, consider using ComfyUI. Refer to its example workflow, and be aware of its functional limitations.

4. For more advanced usage, it is recommended to write Python scripts with the help of AI and run them using this portable pack. The entire generation process has many adjustable parameters, and scripts can offer a more streamlined and flexible approach.

5. This pack does not include bpy (Headless Blender) because the packaging CI could not install it in its environment. Its main purpose in the code is to convert 3D file formats, but its absence has not affected the software’s usability.

Related Repositories

The following code repositories were bundled in this pack:

Official 2.0 Repository	https://github.com/Tencent-Hunyuan/Hunyuan3D-2
2.0 with mmgp integration	https://github.com/YanWenKun/Hunyuan3D-2
2.1 with mmgp integration and Windows adaptation	https://github.com/YanWenKun/Hunyuan3D-2.1
Scripts for legacy versions	https://github.com/YanWenKun/Hunyuan3D-2-WinPortable-Scripts
Scripts for the latest version	https://github.com/YanWenKun/Hunyuan3D-2-WinPortable-Scripts-GUI

Acknowledgements

• Special thanks to all the researchers, developers, and community contributors of Hunyuan3D 2.0 and Hunyuan3D 2.1

• Kudos to DeepBeepMeep for creating mmgp and Hunyuan3D-2GP, bringing Hunyuan3D 2 to less-capable GPUs.

More

Explore my other projects:

• Comfy3D-WinPortable - Run ComfyUI-3D-Pack on Windows.

• StableFast3D-WinPortable - Run SF3D on Windows.

• ComfyUI-Windows-Portable - A ComfyUI bundle with 40+ custom nodes.

• ComfyUI-WinPortable-XPU - A ComfyUI bundle for Intel GPUs.

• ComfyUI-Docker - Run ComfyUI in containers.