Tencent-Hunyuan / Hunyuan3D-2
High-Resolution 3D Assets Generation with Large Scale Hunyuan3D Diffusion Models.
AI Architecture Analysis
This repository is indexed by RepoMind. By analyzing Tencent-Hunyuan/Hunyuan3D-2 in our AI interface, you can instantly generate complete architecture diagrams, visualize control flows, and perform automated security audits across the entire codebase.
Our Agentic Context Augmented Generation (Agentic CAG) engine loads full source files into context, avoiding the fragmentation of traditional RAG systems. Ask questions about the architecture, dependencies, or specific features to see it in action.
Embed this Badge
Showcase RepoMind's analysis directly in your repository's README.
Repository Summary (README)
Previewhttps://github.com/user-attachments/assets/a2cbc5b8-be22-49d7-b1c3-7aa2b20ba460
🔥 News
- July 26, 2025: 🤗 We release the first open-source, simulation-capable, immersive 3D world generation model, HunyuanWorld-1.0!
- June 23, 2025: 📄 Release the system technical report of Hunyuan3D 2.5.
- June 13, 2025: 🤗 Release Hunyuan3D-2.1, fully open-sourced with new PBR model, VAE encoder, and all training code.
- Apr 1, 2025: 🤗 Release turbo paint model Hunyuan3D-Paint-v2-0-Turbo, and multiview texture generation pipeline, try it here! Stay tuned for our new texture generation model RomanTex and PBR material generation MaterialMVP!
- Mar 19, 2025: 🤗 Release turbo model Hunyuan3D-2-Turbo, Hunyuan3D-2mini-Turbo and FlashVDM.
- Mar 18, 2025: 🤗 Release multiview shape model Hunyuan3D-2mv and 0.6B shape model Hunyuan3D-2mini.
- Feb 14, 2025: 🛠️ Release texture enhancement module, please obtain high-definition textures via here!
- Feb 3, 2025: 🐎 Release Hunyuan3D-DiT-v2-0-Fast, our guidance distillation model that could half the dit inference time, see here for usage.
- Jan 27, 2025: 🛠️ Release Blender addon for Hunyuan3D 2.0, Check it out here.
- Jan 23, 2025: 💬 We thank community members for creating Windows installation tool, ComfyUI support with ComfyUI-Hunyuan3DWrapper and ComfyUI-3D-Pack and other awesome extensions.
- Jan 21, 2025: 💬 Enjoy exciting 3D generation on our website Hunyuan3D Studio!
- Jan 21, 2025: 🤗 Release inference code and pretrained models of Hunyuan3D 2.0. Please give it a try via huggingface space and our official site!
Join our Wechat and Discord group to discuss and find help from us.
| Wechat Group | Xiaohongshu | X | Discord |
|---|---|---|---|
| <img src="assets/qrcode/wechat.png" height=140> | <img src="assets/qrcode/xiaohongshu.png" height=140> | <img src="assets/qrcode/x.png" height=140> | <img src="assets/qrcode/discord.png" height=140> |
Abstract
We present Hunyuan3D 2.0, an advanced large-scale 3D synthesis system for generating high-resolution textured 3D assets. This system includes two foundation components: a large-scale shape generation model - Hunyuan3D-DiT, and a large-scale texture synthesis model - Hunyuan3D-Paint. The shape generative model, built on a scalable flow-based diffusion transformer, aims to create geometry that properly aligns with a given condition image, laying a solid foundation for downstream applications. The texture synthesis model, benefiting from strong geometric and diffusion priors, produces high-resolution and vibrant texture maps for either generated or hand-crafted meshes. Furthermore, we build Hunyuan3D-Studio - a versatile, user-friendly production platform that simplifies the re-creation process of 3D assets. It allows both professional and amateur users to manipulate or even animate their meshes efficiently. We systematically evaluate our models, showing that Hunyuan3D 2.0 outperforms previous state-of-the-art models, including the open-source models and closed-source models in geometry details, condition alignment, texture quality, and e.t.c.
<p align="center"> <img src="assets/images/system.jpg"> </p>☯️ Hunyuan3D 2.0
Architecture
Hunyuan3D 2.0 features a two-stage generation pipeline, starting with the creation of a bare mesh, followed by the synthesis of a texture map for that mesh. This strategy is effective for decoupling the difficulties of shape and texture generation and also provides flexibility for texturing either generated or handcrafted meshes.
<p align="left"> <img src="assets/images/arch.jpg"> </p>Performance
We have evaluated Hunyuan3D 2.0 with other open-source as well as close-source 3d-generation methods. The numerical results indicate that Hunyuan3D 2.0 surpasses all baselines in the quality of generated textured 3D assets and the condition following ability.
| Model | CMMD(⬇) | FID_CLIP(⬇) | FID(⬇) | CLIP-score(⬆) |
|---|---|---|---|---|
| Top Open-source Model1 | 3.591 | 54.639 | 289.287 | 0.787 |
| Top Close-source Model1 | 3.600 | 55.866 | 305.922 | 0.779 |
| Top Close-source Model2 | 3.368 | 49.744 | 294.628 | 0.806 |
| Top Close-source Model3 | 3.218 | 51.574 | 295.691 | 0.799 |
| Hunyuan3D 2.0 | 3.193 | 49.165 | 282.429 | 0.809 |
Generation results of Hunyuan3D 2.0:
<p align="left"> <img src="assets/images/e2e-1.gif" height=250> <img src="assets/images/e2e-2.gif" height=250> </p>🎁 Models Zoo
It takes 6 GB VRAM for shape generation and 16 GB for shape and texture generation in total.
Hunyuan3D-2-1 Series
| Model | Description | Date | Size | Huggingface |
|---|---|---|---|---|
| Hunyuan3D-DiT-v2-1 | Mini Image to Shape Model | 2025-06-13 | 3.0B | Download |
| Hunyuan3D-Paint-v2-1 | Texture Generation Model | 2025-06-13 | 1.3B | Download |
Hunyuan3D-2mini Series
| Model | Description | Date | Size | Huggingface |
|---|---|---|---|---|
| Hunyuan3D-DiT-v2-mini-Turbo | Step Distillation Version | 2025-03-19 | 0.6B | Download |
| Hunyuan3D-DiT-v2-mini-Fast | Guidance Distillation Version | 2025-03-18 | 0.6B | Download |
| Hunyuan3D-DiT-v2-mini | Mini Image to Shape Model | 2025-03-18 | 0.6B | Download |
Hunyuan3D-2mv Series
| Model | Description | Date | Size | Huggingface |
|---|---|---|---|---|
| Hunyuan3D-DiT-v2-mv-Turbo | Step Distillation Version | 2025-03-19 | 1.1B | Download |
| Hunyuan3D-DiT-v2-mv-Fast | Guidance Distillation Version | 2025-03-18 | 1.1B | Download |
| Hunyuan3D-DiT-v2-mv | Multiview Image to Shape Model | 2025-03-18 | 1.1B | Download |
Hunyuan3D-2 Series
| Model | Description | Date | Size | Huggingface |
|---|---|---|---|---|
| Hunyuan3D-DiT-v2-0-Turbo | Step Distillation Model | 2025-03-19 | 1.1B | Download |
| Hunyuan3D-DiT-v2-0-Fast | Guidance Distillation Model | 2025-02-03 | 1.1B | Download |
| Hunyuan3D-DiT-v2-0 | Image to Shape Model | 2025-01-21 | 1.1B | Download |
| Hunyuan3D-Paint-v2-0 | Texture Generation Model | 2025-01-21 | 1.3B | Download |
| Hunyuan3D-Paint-v2-0-Turbo | Distillation Texure Model | 2025-04-01 | 1.3B | Download |
| Hunyuan3D-Delight-v2-0 | Image Delight Model | 2025-01-21 | 1.3B | Download |
🤗 Get Started with Hunyuan3D 2.0
Hunyuan3D 2.0 supports Macos, Windows, Linux. You may follow the next steps to use Hunyuan3D 2.0 via:
Install Requirements
Please install Pytorch via the official site. Then install the other requirements via
pip install -r requirements.txt
pip install -e .
# for texture
cd hy3dgen/texgen/custom_rasterizer
python3 setup.py install
cd ../../..
cd hy3dgen/texgen/differentiable_renderer
python3 setup.py install
Code Usage
We designed a diffusers-like API to use our shape generation model - Hunyuan3D-DiT and texture synthesis model - Hunyuan3D-Paint.
You could assess Hunyuan3D-DiT via:
from hy3dgen.shapegen import Hunyuan3DDiTFlowMatchingPipeline
pipeline = Hunyuan3DDiTFlowMatchingPipeline.from_pretrained('tencent/Hunyuan3D-2')
mesh = pipeline(image='assets/demo.png')[0]
The output mesh is a trimesh object, which you could save to glb/obj (or other format) file.
For Hunyuan3D-Paint, do the following:
from hy3dgen.texgen import Hunyuan3DPaintPipeline
from hy3dgen.shapegen import Hunyuan3DDiTFlowMatchingPipeline
# let's generate a mesh first
pipeline = Hunyuan3DDiTFlowMatchingPipeline.from_pretrained('tencent/Hunyuan3D-2')
mesh = pipeline(image='assets/demo.png')[0]
pipeline = Hunyuan3DPaintPipeline.from_pretrained('tencent/Hunyuan3D-2')
mesh = pipeline(mesh, image='assets/demo.png')
Please visit examples folder for more advanced usage, such as multiview image to 3D generation and * texture generation for handcrafted mesh*.
Gradio App
You could also host a Gradio App in your own computer via:
Standard Version
# Hunyuan3D-2mini
python3 gradio_app.py --model_path tencent/Hunyuan3D-2mini --subfolder hunyuan3d-dit-v2-mini --texgen_model_path tencent/Hunyuan3D-2 --low_vram_mode
# Hunyuan3D-2mv
python3 gradio_app.py --model_path tencent/Hunyuan3D-2mv --subfolder hunyuan3d-dit-v2-mv --texgen_model_path tencent/Hunyuan3D-2 --low_vram_mode
# Hunyuan3D-2
python3 gradio_app.py --model_path tencent/Hunyuan3D-2 --subfolder hunyuan3d-dit-v2-0 --texgen_model_path tencent/Hunyuan3D-2 --low_vram_mode
Turbo Version
# Hunyuan3D-2mini
python3 gradio_app.py --model_path tencent/Hunyuan3D-2mini --subfolder hunyuan3d-dit-v2-mini-turbo --texgen_model_path tencent/Hunyuan3D-2 --low_vram_mode --enable_flashvdm
# Hunyuan3D-2mv
python3 gradio_app.py --model_path tencent/Hunyuan3D-2mv --subfolder hunyuan3d-dit-v2-mv-turbo --texgen_model_path tencent/Hunyuan3D-2 --low_vram_mode --enable_flashvdm
# Hunyuan3D-2
python3 gradio_app.py --model_path tencent/Hunyuan3D-2 --subfolder hunyuan3d-dit-v2-0-turbo --texgen_model_path tencent/Hunyuan3D-2 --low_vram_mode --enable_flashvdm
API Server
You could launch an API server locally, which you could post web request for Image/Text to 3D, Texturing existing mesh, and e.t.c.
python api_server.py --host 0.0.0.0 --port 8080
A demo post request for image to 3D without texture.
img_b64_str=$(base64 -i assets/demo.png)
curl -X POST "http://localhost:8080/generate" \
-H "Content-Type: application/json" \
-d '{
"image": "'"$img_b64_str"'",
}' \
-o test2.glb
Blender Addon
With an API server launched, you could also directly use Hunyuan3D 2.0 in your blender with our Blender Addon. Please follow our tutorial to install and use.
https://github.com/user-attachments/assets/8230bfb5-32b1-4e48-91f4-a977c54a4f3e
Official Site
Don't forget to visit Hunyuan3D for quick use, if you don't want to host yourself.
📑 Open-Source Plan
- Inference Code
- Model Checkpoints
- Technical Report
- ComfyUI
- Finetuning
- TensorRT Version
🔗 BibTeX
If you found this repository helpful, please cite our reports:
@misc{lai2025hunyuan3d25highfidelity3d,
title={Hunyuan3D 2.5: Towards High-Fidelity 3D Assets Generation with Ultimate Details},
author={Tencent Hunyuan3D Team},
year={2025},
eprint={2506.16504},
archivePrefix={arXiv},
primaryClass={cs.CV},
url={https://arxiv.org/abs/2506.16504},
}
@misc{hunyuan3d22025tencent,
title={Hunyuan3D 2.0: Scaling Diffusion Models for High Resolution Textured 3D Assets Generation},
author={Tencent Hunyuan3D Team},
year={2025},
eprint={2501.12202},
archivePrefix={arXiv},
primaryClass={cs.CV}
}
@misc{yang2024hunyuan3d,
title={Hunyuan3D 1.0: A Unified Framework for Text-to-3D and Image-to-3D Generation},
author={Tencent Hunyuan3D Team},
year={2024},
eprint={2411.02293},
archivePrefix={arXiv},
primaryClass={cs.CV}
}
Community Resources
Thanks for the contributions of community members, here we have these great extensions of Hunyuan3D 2.0:
- ComfyUI-3D-Pack
- ComfyUI-Hunyuan3DWrapper
- Hunyuan3D-2-for-windows
- 📦 A bundle for running on Windows | 整合包
- Hunyuan3D-2GP
- Kaggle Notebook
Acknowledgements
We would like to thank the contributors to the Trellis, DINOv2, Stable Diffusion, FLUX, diffusers, HuggingFace, CraftsMan3D, and Michelangelo repositories, for their open research and exploration.