Image-to-3D
Hunyuan3D-2
Diffusers
Safetensors
English
Chinese
text-to-3d
nielsr HF Staff commited on
Commit
a9cbd5d
·
verified ·
1 Parent(s): 34e2826

Update model card to Hunyuan3D 2.5

Browse files

This PR updates the model card to reflect the newest report (v2.5) and incorporates relevant details from the GitHub README.

Files changed (1) hide show
  1. README.md +167 -59
README.md CHANGED
@@ -1,15 +1,15 @@
1
  ---
 
 
 
2
  library_name: hunyuan3d-2
3
  license: other
4
  license_name: tencent-hunyuan-community
5
  license_link: https://huggingface.co/tencent/Hunyuan3D-2/blob/main/LICENSE.txt
6
- language:
7
- - en
8
- - zh
9
- tags:
10
- - image-to-3d
11
- - text-to-3d
12
  pipeline_tag: image-to-3d
 
 
 
13
  ---
14
 
15
  <p align="center">
@@ -21,56 +21,64 @@ pipeline_tag: image-to-3d
21
  <a href=https://huggingface.co/spaces/tencent/Hunyuan3D-2 target="_blank"><img src=https://img.shields.io/badge/%F0%9F%A4%97%20Demo-276cb4.svg height=22px></a>
22
  <a href=https://huggingface.co/tencent/Hunyuan3D-2 target="_blank"><img src=https://img.shields.io/badge/%F0%9F%A4%97%20Models-d96902.svg height=22px></a>
23
  <a href=https://3d-models.hunyuan.tencent.com/ target="_blank"><img src= https://img.shields.io/badge/Page-bb8a2e.svg?logo=github height=22px></a>
24
- <a href=https://discord.gg/GuaWYwzKbX target="_blank"><img src= https://img.shields.io/badge/Discord-white.svg?logo=discord height=22px></a>
25
- <a href=https://github.com/Tencent/Hunyuan3D-2/blob/main/assets/report/Tencent_Hunyuan3D_2_0.pdf target="_blank"><img src=https://img.shields.io/badge/Report-b5212f.svg?logo=arxiv height=22px></a>
 
 
26
  </div>
27
 
28
-
29
- [//]: # ( <a href=# target="_blank"><img src=https://img.shields.io/badge/Report-b5212f.svg?logo=arxiv height=22px></a>)
30
-
31
- [//]: # ( <a href=# target="_blank"><img src= https://img.shields.io/badge/Colab-8f2628.svg?logo=googlecolab height=22px></a>)
32
-
33
- [//]: # ( <a href="#"><img alt="PyPI - Downloads" src="https://img.shields.io/pypi/v/mulankit?logo=pypi" height=22px></a>)
34
-
35
  <br>
36
  <p align="center">
37
  “ Living out everyone’s imagination on creating and manipulating 3D assets.”
38
  </p>
39
 
40
- This repository contains the models of the paper [Hunyuan3D 2.0: Scaling Diffusion Models for High Resolution Textured 3D Assets Generation](https://huggingface.co/papers/2501.12202).
41
  For code and more details on how to use it, refer to the [Github repository](https://github.com/Tencent/Hunyuan3D-2).
42
 
43
  ## 🔥 News
44
 
45
- - Jan 21, 2025: 💬 Release [Hunyuan3D 2.0](https://huggingface.co/spaces/tencent/Hunyuan3D-2). Please give it a try!
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
46
 
47
  ## **Abstract**
48
 
49
- We present Hunyuan3D 2.0, an advanced large-scale 3D synthesis system for generating high-resolution textured 3D assets.
50
- This system includes two foundation components: a large-scale shape generation model - Hunyuan3D-DiT, and a large-scale
51
- texture synthesis model - Hunyuan3D-Paint.
52
- The shape generative model, built on a scalable flow-based diffusion transformer, aims to create geometry that properly
53
- aligns with a given condition image, laying a solid foundation for downstream applications.
54
- The texture synthesis model, benefiting from strong geometric and diffusion priors, produces high-resolution and vibrant
55
- texture maps for either generated or hand-crafted meshes.
56
- Furthermore, we build Hunyuan3D-Studio - a versatile, user-friendly production platform that simplifies the re-creation
57
- process of 3D assets. It allows both professional and amateur users to manipulate or even animate their meshes
58
- efficiently.
59
- We systematically evaluate our models, showing that Hunyuan3D 2.0 outperforms previous state-of-the-art models,
60
- including the open-source models and closed-source models in geometry details, condition alignment, texture quality, and
61
- e.t.c.
62
 
63
  <p align="center">
64
  <img src="assets/images/system.jpg">
65
  </p>
66
 
67
- ## ☯️ **Hunyuan3D 2.0**
68
 
69
  ### Architecture
70
 
71
- Hunyuan3D 2.0 features a two-stage generation pipeline, starting with the creation of a bare mesh, followed by the
72
- synthesis of a texture map for that mesh. This strategy is effective for decoupling the difficulties of shape and
73
- texture generation and also provides flexibility for texturing either generated or handcrafted meshes.
74
 
75
  <p align="left">
76
  <img src="assets/images/arch.jpg">
@@ -78,8 +86,8 @@ texture generation and also provides flexibility for texturing either generated
78
 
79
  ### Performance
80
 
81
- We have evaluated Hunyuan3D 2.0 with other open-source as well as close-source 3d-generation methods.
82
- The numerical results indicate that Hunyuan3D 2.0 surpasses all baselines in the quality of generated textured 3D assets
83
  and the condition following ability.
84
 
85
  | Model | CMMD(⬇) | FID_CLIP(⬇) | FID(⬇) | CLIP-score(⬆) |
@@ -88,25 +96,61 @@ and the condition following ability.
88
  | Top Close-source Model1 | 3.600 | 55.866 | 305.922 | 0.779 |
89
  | Top Close-source Model2 | 3.368 | 49.744 | 294.628 | 0.806 |
90
  | Top Close-source Model3 | 3.218 | 51.574 | 295.691 | 0.799 |
91
- | Hunyuan3D 2.0 | **3.193** | **49.165** | **282.429** | **0.809** |
92
 
93
- Generation results of Hunyuan3D 2.0:
94
  <p align="left">
95
- <img src="assets/images/e2e-1.gif" height=300>
96
- <img src="assets/images/e2e-2.gif" height=300>
97
  </p>
98
 
99
- ### Pretrained Models
 
 
 
 
100
 
101
- | Model | Date | Huggingface |
102
- |----------------------|------------|--------------------------------------------------------|
103
- | Hunyuan3D-DiT-v2-0 | 2025-01-21 | [Download](https://huggingface.co/tencent/Hunyuan3D-2) |
104
- | Hunyuan3D-Paint-v2-0 | 2025-01-21 | [Download](https://huggingface.co/tencent/Hunyuan3D-2) |
105
- | Hunyuan3D-Delight-v2-0 | 2025-01-21 | [Download](https://huggingface.co/tencent/Hunyuan3D-2/tree/main/hunyuan3d-delight-v2-0) |
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
106
 
107
  ## 🤗 Get Started with Hunyuan3D 2.0
108
 
109
- You may follow the next steps to use Hunyuan3D 2.0 via code or the Gradio App.
 
 
 
 
 
 
110
 
111
  ### Install Requirements
112
 
@@ -114,15 +158,16 @@ Please install Pytorch via the [official](https://pytorch.org/) site. Then insta
114
 
115
  ```bash
116
  pip install -r requirements.txt
 
117
  # for texture
118
  cd hy3dgen/texgen/custom_rasterizer
119
  python3 setup.py install
120
  cd ../../..
121
  cd hy3dgen/texgen/differentiable_renderer
122
- bash compile_mesh_painter.sh OR python3 setup.py install (on Windows)
123
  ```
124
 
125
- ### API Usage
126
 
127
  We designed a diffusers-like API to use our shape generation model - Hunyuan3D-DiT and texture synthesis model -
128
  Hunyuan3D-Paint.
@@ -153,18 +198,66 @@ pipeline = Hunyuan3DPaintPipeline.from_pretrained('tencent/Hunyuan3D-2')
153
  mesh = pipeline(mesh, image='assets/demo.png')
154
  ```
155
 
156
- Please visit [minimal_demo.py](https://github.com/Tencent/Hunyuan3D-2/blob/main/minimal_demo.py) for more advanced usage, such as **text to 3D** and **texture generation
 
157
  for handcrafted mesh**.
158
 
159
  ### Gradio App
160
 
161
  You could also host a [Gradio](https://www.gradio.app/) App in your own computer via:
162
 
 
 
163
  ```bash
164
- pip3 install gradio==3.39.0
165
- python3 gradio_app.py
 
 
 
 
166
  ```
167
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
168
  Don't forget to visit [Hunyuan3D](https://3d.hunyuan.tencent.com) for quick use, if you don't want to host yourself.
169
 
170
  ## 📑 Open-Source Plan
@@ -172,14 +265,25 @@ Don't forget to visit [Hunyuan3D](https://3d.hunyuan.tencent.com) for quick use,
172
  - [x] Inference Code
173
  - [x] Model Checkpoints
174
  - [x] Technical Report
175
- - [ ] ComfyUI
 
176
  - [ ] TensorRT Version
177
 
178
  ## 🔗 BibTeX
179
 
180
- If you found this repository helpful, please cite our report:
181
 
182
  ```bibtex
 
 
 
 
 
 
 
 
 
 
183
  @misc{hunyuan3d22025tencent,
184
  title={Hunyuan3D 2.0: Scaling Diffusion Models for High Resolution Textured 3D Assets Generation},
185
  author={Tencent Hunyuan3D Team},
@@ -189,8 +293,8 @@ If you found this repository helpful, please cite our report:
189
  primaryClass={cs.CV}
190
  }
191
 
192
- @misc{yang2024tencent,
193
- title={Tencent Hunyuan3D-1.0: A Unified Framework for Text-to-3D and Image-to-3D Generation},
194
  author={Tencent Hunyuan3D Team},
195
  year={2024},
196
  eprint={2411.02293},
@@ -203,15 +307,19 @@ If you found this repository helpful, please cite our report:
203
 
204
  Thanks for the contributions of community members, here we have these great extensions of Hunyuan3D 2.0:
205
 
 
206
  - [ComfyUI-Hunyuan3DWrapper](https://github.com/kijai/ComfyUI-Hunyuan3DWrapper)
207
  - [Hunyuan3D-2-for-windows](https://github.com/sdbds/Hunyuan3D-2-for-windows)
208
- - [📦 A bundle for running on Windows | 整合包](https://github.com/YanWenKun/Comfy3D-WinPortable/releases/tag/r8-hunyuan3d2)
 
 
209
 
210
  ## Acknowledgements
211
 
212
  We would like to thank the contributors to
213
- the [DINOv2](https://github.com/facebookresearch/dinov2), [Stable Diffusion](https://github.com/Stability-AI/stablediffusion), [FLUX](https://github.com/black-forest-labs/flux), [diffusers](https://github.com/huggingface/diffusers)
214
- and [HuggingFace](https://huggingface.co) repositories, for their open research and exploration.
 
215
 
216
  ## Star History
217
 
 
1
  ---
2
+ language:
3
+ - en
4
+ - zh
5
  library_name: hunyuan3d-2
6
  license: other
7
  license_name: tencent-hunyuan-community
8
  license_link: https://huggingface.co/tencent/Hunyuan3D-2/blob/main/LICENSE.txt
 
 
 
 
 
 
9
  pipeline_tag: image-to-3d
10
+ tags:
11
+ - image-to-3d
12
+ - text-to-3d
13
  ---
14
 
15
  <p align="center">
 
21
  <a href=https://huggingface.co/spaces/tencent/Hunyuan3D-2 target="_blank"><img src=https://img.shields.io/badge/%F0%9F%A4%97%20Demo-276cb4.svg height=22px></a>
22
  <a href=https://huggingface.co/tencent/Hunyuan3D-2 target="_blank"><img src=https://img.shields.io/badge/%F0%9F%A4%97%20Models-d96902.svg height=22px></a>
23
  <a href=https://3d-models.hunyuan.tencent.com/ target="_blank"><img src= https://img.shields.io/badge/Page-bb8a2e.svg?logo=github height=22px></a>
24
+ <a href=https://discord.gg/dNBrdrGGMa target="_blank"><img src= https://img.shields.io/badge/Discord-white.svg?logo=discord height=22px></a>
25
+ <a href=https://arxiv.org/abs/2506.16504 target="_blank"><img src=https://img.shields.io/badge/Report-b5212f.svg?logo=arxiv height=22px></a>
26
+ <a href=https://x.com/TencentHunyuan target="_blank"><img src=https://img.shields.io/badge/Hunyuan-black.svg?logo=x height=22px></a>
27
+ <a href="#community-resources" target="_blank"><img src=https://img.shields.io/badge/Community-lavender.svg?logo=homeassistantcommunitystore height=22px></a>
28
  </div>
29
 
 
 
 
 
 
 
 
30
  <br>
31
  <p align="center">
32
  “ Living out everyone’s imagination on creating and manipulating 3D assets.”
33
  </p>
34
 
35
+ This repository contains the models of the paper [Hunyuan3D 2.5: Towards High-Fidelity 3D Assets Generation with Ultimate Details](https://huggingface.co/papers/2506.16504).
36
  For code and more details on how to use it, refer to the [Github repository](https://github.com/Tencent/Hunyuan3D-2).
37
 
38
  ## 🔥 News
39
 
40
+ - June 23, 2025: 📄 Release the system technical report of [Hunyuan3D 2.5](https://arxiv.org/abs/2506.16504).
41
+ - June 13, 2025: 🤗 Release [Hunyuan3D-2.1](https://github.com/Tencent-Hunyuan/Hunyuan3D-2.1), fully open-sourced with new PBR model, VAE encoder, and all training code.
42
+ - Apr 1, 2025: 🤗 Release turbo paint model [Hunyuan3D-Paint-v2-0-Turbo](https://huggingface.co/tencent/Hunyuan3D-2/tree/main/hunyuan3d-paint-v2-0-turbo), and multiview texture generation pipeline, try it [here](examples/fast_texture_gen_multiview.py)! Stay tuned for our new texture generation model [RomanTex](https://github.com/oakshy/RomanTex) and PBR material generation [MaterialMVP](https://github.com/ZebinHe/MaterialMVP/)!
43
+ - Mar 19, 2025: 🤗 Release turbo model [Hunyuan3D-2-Turbo](https://huggingface.co/tencent/Hunyuan3D-2/), [Hunyuan3D-2mini-Turbo](https://huggingface.co/tencent/Hunyuan3D-2mini/) and [FlashVDM](https://github.com/Tencent/FlashVDM).
44
+ - Mar 18, 2025: 🤗 Release multiview shape model [Hunyuan3D-2mv](https://huggingface.co/tencent/Hunyuan3D-2mv) and 0.6B
45
+ shape model [Hunyuan3D-2mini](https://huggingface.co/tencent/Hunyuan3D-2mini).
46
+ - Feb 14, 2025: 🛠️ Release texture enhancement module, please obtain high-definition textures
47
+ via [here](minimal_demo.py)!
48
+ - Feb 3, 2025: 🐎
49
+ Release [Hunyuan3D-DiT-v2-0-Fast](https://huggingface.co/tencent/Hunyuan3D-2/tree/main/hunyuan3d-dit-v2-0-fast), our
50
+ guidance distillation model that could half the dit inference time, see [here](minimal_demo.py) for usage.
51
+ - Jan 27, 2025: 🛠️ Release Blender addon for Hunyuan3D 2.0, Check it out [here](#blender-addon).
52
+ - Jan 23, 2025: 💬 We thank community members for
53
+ creating [Windows installation tool](https://github.com/YanWenKun/Hunyuan3D-2-WinPortable), ComfyUI support
54
+ with [ComfyUI-Hunyuan3DWrapper](https://github.com/kijai/ComfyUI-Hunyuan3DWrapper)
55
+ and [ComfyUI-3D-Pack](https://github.com/MrForExample/ComfyUI-3D-Pack) and other
56
+ awesome [extensions](#community-resources).
57
+ - Jan 21, 2025: 💬 Enjoy exciting 3D generation on our website [Hunyuan3D Studio](https://3d.hunyuan.tencent.com)!
58
+ - Jan 21, 2025: 🤗 Release inference code and pretrained models
59
+ of [Hunyuan3D 2.0](https://huggingface.co/tencent/Hunyuan3D-2). Please give it a try
60
+ via [huggingface space](https://huggingface.co/spaces/tencent/Hunyuan3D-2) and
61
+ our [official site](https://3d.hunyuan.tencent.com)!
62
+
63
+ > Join our **[Wechat](#)** and **[Discord](https://discord.gg/dNBrdrGGMa)** group to discuss and find help from us.
64
+
65
+ | Wechat Group | Xiaohongshu | X | Discord |
66
+ |--------------------------------------------------|-------------------------------------------------------|---------------------------------------------|---------------------------------------------------|
67
+ | <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> |
68
 
69
  ## **Abstract**
70
 
71
+ In this report, we present Hunyuan3D 2.5, a robust suite of 3D diffusion models aimed at generating high-fidelity and detailed textured 3D assets. Hunyuan3D 2.5 follows two-stages pipeline of its previous version Hunyuan3D 2.0, while demonstrating substantial advancements in both shape and texture generation. In terms of shape generation, we introduce a new shape foundation model -- LATTICE, which is trained with scaled high-quality datasets, model-size, and compute. Our largest model reaches 10B parameters and generates sharp and detailed 3D shape with precise image-3D following while keeping mesh surface clean and smooth, significantly closing the gap between generated and handcrafted 3D shapes. In terms of texture generation, it is upgraded with phyiscal-based rendering (PBR) via a novel multi-view architecture extended from Hunyuan3D 2.0 Paint model. Our extensive evaluation shows that Hunyuan3D 2.5 significantly outperforms previous methods in both shape and end-to-end texture generation.
 
 
 
 
 
 
 
 
 
 
 
 
72
 
73
  <p align="center">
74
  <img src="assets/images/system.jpg">
75
  </p>
76
 
77
+ ## ☯️ **Hunyuan3D 2.5**
78
 
79
  ### Architecture
80
 
81
+ Hunyuan3D 2.5 follows two-stages pipeline of its previous version Hunyuan3D 2.0, while demonstrating substantial advancements in both shape and texture generation
 
 
82
 
83
  <p align="left">
84
  <img src="assets/images/arch.jpg">
 
86
 
87
  ### Performance
88
 
89
+ We have evaluated Hunyuan3D 2.5 with other open-source as well as close-source 3d-generation methods.
90
+ The numerical results indicate that Hunyuan3D 2.5 surpasses all baselines in the quality of generated textured 3D assets
91
  and the condition following ability.
92
 
93
  | Model | CMMD(⬇) | FID_CLIP(⬇) | FID(⬇) | CLIP-score(⬆) |
 
96
  | Top Close-source Model1 | 3.600 | 55.866 | 305.922 | 0.779 |
97
  | Top Close-source Model2 | 3.368 | 49.744 | 294.628 | 0.806 |
98
  | Top Close-source Model3 | 3.218 | 51.574 | 295.691 | 0.799 |
99
+ | Hunyuan3D 2.5 | **3.193** | **49.165** | **282.429** | **0.809** |
100
 
101
+ Generation results of Hunyuan3D 2.5:
102
  <p align="left">
103
+ <img src="assets/images/e2e-1.gif" height=250>
104
+ <img src="assets/images/e2e-2.gif" height=250>
105
  </p>
106
 
107
+ ## 🎁 Models Zoo
108
+
109
+ It takes 6 GB VRAM for shape generation and 16 GB for shape and texture generation in total.
110
+
111
+ Hunyuan3D-2-1 Series
112
 
113
+ | Model | Description | Date | Size | Huggingface |
114
+ |----------------------|----------------новой---------------|------------|------|-----------------------------------------------------------------------------------------|
115
+ | Hunyuan3D-DiT-v2-1 | Mini Image to Shape Model | 2025-06-13 | 3.0B | [Download](https://huggingface.co/tencent/Hunyuan3D-2.1/tree/main/hunyuan3d-dit-v2-1) |
116
+ | Hunyuan3D-Paint-v2-1 | Texture Generation Model | 2025-06-13 | 1.3B | [Download](https://huggingface.co/tencent/Hunyuan3D-2.1/tree/main/hunyuan3d-paintpbr-v2-1) |
117
+
118
+ Hunyuan3D-2mini Series
119
+
120
+ | Model | Description | Date | Size | Huggingface |
121
+ |-----------------------------|-------------------------------|------------|------|--------------------------------------------------------------------------------------------------|
122
+ | Hunyuan3D-DiT-v2-mini-Turbo | Step Distillation Version | 2025-03-19 | 0.6B | [Download](https://huggingface.co/tencent/Hunyuan3D-2mini/tree/main/hunyuan3d-dit-v2-mini-turbo) |
123
+ | Hunyuan3D-DiT-v2-mini-Fast | Guidance Distillation Version | 2025-03-18 | 0.6B | [Download](https://huggingface.co/tencent/Hunyuan3D-2mini/tree/main/hunyuan3d-dit-v2-mini-fast) |
124
+ | Hunyuan3D-DiT-v2-mini | Mini Image to Shape Model | 2025-03-18 | 0.6B | [Download](https://huggingface.co/tencent/Hunyuan3D-2mini/tree/main/hunyuan3d-dit-v2-mini) |
125
+
126
+ Hunyuan3D-2mv Series
127
+
128
+ | Model | Description | Date | Size | Huggingface |
129
+ |---------------------------|--------------------------------|------------|------|----------------------------------------------------------------------------------------------|
130
+ | Hunyuan3D-DiT-v2-mv-Turbo | Step Distillation Version | 2025-03-19 | 1.1B | [Download](https://huggingface.co/tencent/Hunyuan3D-2mv/tree/main/hunyuan3d-dit-v2-mv-turbo) |
131
+ | Hunyuan3D-DiT-v2-mv-Fast | Guidance Distillation Version | 2025-03-18 | 1.1B | [Download](https://huggingface.co/tencent/Hunyuan3D-2mv/tree/main/hunyuan3d-dit-v2-mv-fast) |
132
+ | Hunyuan3D-DiT-v2-mv | Multiview Image to Shape Model | 2025-03-18 | 1.1B | [Download](https://huggingface.co/tencent/Hunyuan3D-2mv/tree/main/hunyuan3d-dit-v2-mv) |
133
+
134
+ Hunyuan3D-2 Series
135
+
136
+ | Model | Description | Date | Size | Huggingface |
137
+ |----------------------------|-----------------------------|------------|------|-------------------------------------------------------------------------------------------|
138
+ | Hunyuan3D-DiT-v2-0-Turbo | Step Distillation Model | 2025-03-19 | 1.1B | [Download](https://huggingface.co/tencent/Hunyuan3D-2/tree/main/hunyuan3d-dit-v2-0-turbo) |
139
+ | Hunyuan3D-DiT-v2-0-Fast | Guidance Distillation Model | 2025-02-03 | 1.1B | [Download](https://huggingface.co/tencent/Hunyuan3D-2/tree/main/hunyuan3d-dit-v2-0-fast) |
140
+ | Hunyuan3D-DiT-v2-0 | Image to Shape Model | 2025-01-21 | 1.1B | [Download](https://huggingface.co/tencent/Hunyuan3D-2/tree/main/hunyuan3d-dit-v2-0) |
141
+ | Hunyuan3D-Paint-v2-0 | Texture Generation Model | 2025-01-21 | 1.3B | [Download](https://huggingface.co/tencent/Hunyuan3D-2/tree/main/hunyuan3d-paint-v2-0) |
142
+ | Hunyuan3D-Paint-v2-0-Turbo | Distillation Texure Model | 2025-04-01 | 1.3B | [Download](https://huggingface.co/tencent/Hunyuan3D-2/tree/main/hunyuan3d-paint-v2-0-turbo) |
143
+ | Hunyuan3D-Delight-v2-0 | Image Delight Model | 2025-01-21 | 1.3B | [Download](https://huggingface.co/tencent/Hunyuan3D-2/tree/main/hunyuan3d-delight-v2-0) |
144
 
145
  ## 🤗 Get Started with Hunyuan3D 2.0
146
 
147
+ Hunyuan3D 2.0 supports Macos, Windows, Linux. You may follow the next steps to use Hunyuan3D 2.0 via:
148
+
149
+ - [Code](#code-usage)
150
+ - [Gradio App](#gradio-app)
151
+ - [API Server](#api-server)
152
+ - [Blender Addon](#blender-addon)
153
+ - [Official Site](#official-site)
154
 
155
  ### Install Requirements
156
 
 
158
 
159
  ```bash
160
  pip install -r requirements.txt
161
+ pip install -e .
162
  # for texture
163
  cd hy3dgen/texgen/custom_rasterizer
164
  python3 setup.py install
165
  cd ../../..
166
  cd hy3dgen/texgen/differentiable_renderer
167
+ python3 setup.py install
168
  ```
169
 
170
+ ### Code Usage
171
 
172
  We designed a diffusers-like API to use our shape generation model - Hunyuan3D-DiT and texture synthesis model -
173
  Hunyuan3D-Paint.
 
198
  mesh = pipeline(mesh, image='assets/demo.png')
199
  ```
200
 
201
+ Please visit [examples](examples) folder for more advanced usage, such as **multiview image to 3D generation** and *
202
+ *texture generation
203
  for handcrafted mesh**.
204
 
205
  ### Gradio App
206
 
207
  You could also host a [Gradio](https://www.gradio.app/) App in your own computer via:
208
 
209
+ Standard Version
210
+
211
  ```bash
212
+ # Hunyuan3D-2mini
213
+ python3 gradio_app.py --model_path tencent/Hunyuan3D-2mini --subfolder hunyuan3d-dit-v2-mini --texgen_model_path tencent/Hunyuan3D-2 --low_vram_mode
214
+ # Hunyuan3D-2mv
215
+ python3 gradio_app.py --model_path tencent/Hunyuan3D-2mv --subfolder hunyuan3d-dit-v2-mv --texgen_model_path tencent/Hunyuan3D-2 --low_vram_mode
216
+ # Hunyuan3D-2
217
+ python3 gradio_app.py --model_path tencent/Hunyuan3D-2 --subfolder hunyuan3d-dit-v2-0 --texgen_model_path tencent/Hunyuan3D-2 --low_vram_mode
218
  ```
219
 
220
+ Turbo Version
221
+
222
+ ```bash
223
+ # Hunyuan3D-2mini
224
+ 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
225
+ # Hunyuan3D-2mv
226
+ 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
227
+ # Hunyuan3D-2
228
+ 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
229
+ ```
230
+
231
+ ### API Server
232
+
233
+ You could launch an API server locally, which you could post web request for Image/Text to 3D, Texturing existing mesh,
234
+ and e.t.c.
235
+
236
+ ```bash
237
+ python api_server.py --host 0.0.0.0 --port 8080
238
+ ```
239
+
240
+ A demo post request for image to 3D without texture.
241
+
242
+ ```bash
243
+ img_b64_str=$(base64 -i assets/demo.png)
244
+ curl -X POST "http://localhost:8080/generate" \
245
+ -H "Content-Type: application/json" \
246
+ -d '{
247
+ "image": "'"$img_b64_str"'",
248
+ }' \
249
+ -o test2.glb
250
+ ```
251
+
252
+ ### Blender Addon
253
+
254
+ With an API server launched, you could also directly use Hunyuan3D 2.0 in your blender with
255
+ our [Blender Addon](blender_addon.py). Please follow our tutorial to install and use.
256
+
257
+ https://github.com/user-attachments/assets/8230bfb5-32b1-4e48-91f4-a977c54a4f3e
258
+
259
+ ### Official Site
260
+
261
  Don't forget to visit [Hunyuan3D](https://3d.hunyuan.tencent.com) for quick use, if you don't want to host yourself.
262
 
263
  ## 📑 Open-Source Plan
 
265
  - [x] Inference Code
266
  - [x] Model Checkpoints
267
  - [x] Technical Report
268
+ - [x] ComfyUI
269
+ - [x] Finetuning
270
  - [ ] TensorRT Version
271
 
272
  ## 🔗 BibTeX
273
 
274
+ If you found this repository helpful, please cite our reports:
275
 
276
  ```bibtex
277
+ @misc{lai2025hunyuan3d25highfidelity3d,
278
+ title={Hunyuan3D 2.5: Towards High-Fidelity 3D Assets Generation with Ultimate Details},
279
+ author={Tencent Hunyuan3D Team},
280
+ year={2025},
281
+ eprint={2506.16504},
282
+ archivePrefix={arXiv},
283
+ primaryClass={cs.CV},
284
+ url={https://arxiv.org/abs/2506.16504},
285
+ }
286
+
287
  @misc{hunyuan3d22025tencent,
288
  title={Hunyuan3D 2.0: Scaling Diffusion Models for High Resolution Textured 3D Assets Generation},
289
  author={Tencent Hunyuan3D Team},
 
293
  primaryClass={cs.CV}
294
  }
295
 
296
+ @misc{yang2024hunyuan3d,
297
+ title={Hunyuan3D 1.0: A Unified Framework for Text-to-3D and Image-to-3D Generation},
298
  author={Tencent Hunyuan3D Team},
299
  year={2024},
300
  eprint={2411.02293},
 
307
 
308
  Thanks for the contributions of community members, here we have these great extensions of Hunyuan3D 2.0:
309
 
310
+ - [ComfyUI-3D-Pack](https://github.com/MrForExample/ComfyUI-3D-Pack)
311
  - [ComfyUI-Hunyuan3DWrapper](https://github.com/kijai/ComfyUI-Hunyuan3DWrapper)
312
  - [Hunyuan3D-2-for-windows](https://github.com/sdbds/Hunyuan3D-2-for-windows)
313
+ - [📦 A bundle for running on Windows | 整合包](https://github.com/YanWenKun/Hunyuan3D-2-WinPortable)
314
+ - [Hunyuan3D-2GP](https://github.com/deepbeepmeep/Hunyuan3D-2GP)
315
+ - [Kaggle Notebook](https://github.com/darkon12/Hunyuan3D-2GP_Kaggle)
316
 
317
  ## Acknowledgements
318
 
319
  We would like to thank the contributors to
320
+ the [Trellis](https://github.com/microsoft/TRELLIS), [DINOv2](https://github.com/facebookresearch/dinov2), [Stable Diffusion](https://github.com/Stability-AI/stablediffusion), [FLUX](https://github.com/black-forest-labs/flux), [diffusers](https://github.com/huggingface/diffusers), [HuggingFace](https://huggingface.co), [CraftsMan3D](https://github.com/wyysf-98/CraftsMan3D),
321
+ and [Michelangelo](https://github.com/NeuralCarver/Michelangelo/tree/main) repositories, for their open research and
322
+ exploration.
323
 
324
  ## Star History
325