Add Transformers library name and update model card
#1
by
nielsr
HF staff
- opened
README.md
CHANGED
@@ -1,17 +1,18 @@
|
|
1 |
---
|
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">
|
16 |
<img src="./assets/images/teaser.jpg">
|
17 |
</p>
|
@@ -42,7 +43,21 @@ For code and more details on how to use it, refer to the [Github repository](htt
|
|
42 |
|
43 |
## π₯ News
|
44 |
|
45 |
-
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
46 |
|
47 |
## **Abstract**
|
48 |
|
@@ -100,8 +115,8 @@ Generation results of Hunyuan3D 2.0:
|
|
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
|
@@ -119,7 +134,7 @@ cd hy3dgen/texgen/custom_rasterizer
|
|
119 |
python3 setup.py install
|
120 |
cd ../../..
|
121 |
cd hy3dgen/texgen/differentiable_renderer
|
122 |
-
|
123 |
```
|
124 |
|
125 |
### API Usage
|
@@ -161,10 +176,39 @@ for handcrafted mesh**.
|
|
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
|
@@ -177,7 +221,7 @@ Don't forget to visit [Hunyuan3D](https://3d.hunyuan.tencent.com) for quick use,
|
|
177 |
|
178 |
## π BibTeX
|
179 |
|
180 |
-
If you found this repository helpful, please cite our
|
181 |
|
182 |
```bibtex
|
183 |
@misc{hunyuan3d22025tencent,
|
@@ -189,8 +233,8 @@ If you found this repository helpful, please cite our report:
|
|
189 |
primaryClass={cs.CV}
|
190 |
}
|
191 |
|
192 |
-
@misc{
|
193 |
-
title={
|
194 |
author={Tencent Hunyuan3D Team},
|
195 |
year={2024},
|
196 |
eprint={2411.02293},
|
@@ -203,15 +247,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/
|
|
|
|
|
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 [
|
|
|
215 |
|
216 |
## Star History
|
217 |
|
@@ -221,4 +269,5 @@ and [HuggingFace](https://huggingface.co) repositories, for their open research
|
|
221 |
<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=Tencent/Hunyuan3D-2&type=Date" />
|
222 |
<img alt="Star History Chart" src="https://api.star-history.com/svg?repos=Tencent/Hunyuan3D-2&type=Date" />
|
223 |
</picture>
|
224 |
-
</a>
|
|
|
|
1 |
---
|
2 |
+
language:
|
3 |
+
- en
|
4 |
+
- zh
|
5 |
+
library_name: transformers
|
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 |
+
```markdown
|
16 |
<p align="center">
|
17 |
<img src="./assets/images/teaser.jpg">
|
18 |
</p>
|
|
|
43 |
|
44 |
## π₯ News
|
45 |
|
46 |
+
- Feb 14, 2025: π οΈ Release texture enhancement module, please obtain high-definition textures via [here](minimal_demo.py)!
|
47 |
+
- Feb 3, 2025: π
|
48 |
+
Release [Hunyuan3D-DiT-v2-0-Fast](https://huggingface.co/tencent/Hunyuan3D-2/tree/main/hunyuan3d-dit-v2-0-fast), our
|
49 |
+
guidance distillation model that could half the dit inference time, see [here](minimal_demo.py) for usage.
|
50 |
+
- Jan 27, 2025: π οΈ Release Blender addon for Hunyuan3D 2.0, Check it out [here](#blender-addon).
|
51 |
+
- Jan 23, 2025: π¬ We thank community members for
|
52 |
+
creating [Windows installation tool](https://github.com/YanWenKun/Hunyuan3D-2-WinPortable), ComfyUI support
|
53 |
+
with [ComfyUI-Hunyuan3DWrapper](https://github.com/kijai/ComfyUI-Hunyuan3DWrapper)
|
54 |
+
and [ComfyUI-3D-Pack](https://github.com/MrForExample/ComfyUI-3D-Pack) and other
|
55 |
+
awesome [extensions](#community-resources).
|
56 |
+
- Jan 21, 2025: π¬ Enjoy exciting 3D generation on our website [Hunyuan3D Studio](https://3d.hunyuan.tencent.com)!
|
57 |
+
- Jan 21, 2025: π€ Release inference code and pretrained models
|
58 |
+
of [Hunyuan3D 2.0](https://huggingface.co/tencent/Hunyuan3D-2). Please give it a try
|
59 |
+
via [huggingface space](https://huggingface.co/spaces/tencent/Hunyuan3D-2) and
|
60 |
+
our [official site](https://3d.hunyuan.tencent.com)!
|
61 |
|
62 |
## **Abstract**
|
63 |
|
|
|
115 |
|
116 |
| Model | Date | Huggingface |
|
117 |
|----------------------|------------|--------------------------------------------------------|
|
118 |
+
| Hunyuan3D-DiT-v2-0 | 2025-01-21 | [Download](https://huggingface.co/tencent/Hunyuan3D-2/tree/main/hunyuan3d-dit-v2-0) |
|
119 |
+
| Hunyuan3D-Paint-v2-0 | 2025-01-21 | [Download](https://huggingface.co/tencent/Hunyuan3D-2/tree/main/hunyuan3d-paint-v2-0) |
|
120 |
| Hunyuan3D-Delight-v2-0 | 2025-01-21 | [Download](https://huggingface.co/tencent/Hunyuan3D-2/tree/main/hunyuan3d-delight-v2-0) |
|
121 |
|
122 |
## π€ Get Started with Hunyuan3D 2.0
|
|
|
134 |
python3 setup.py install
|
135 |
cd ../../..
|
136 |
cd hy3dgen/texgen/differentiable_renderer
|
137 |
+
python3 setup.py install
|
138 |
```
|
139 |
|
140 |
### API Usage
|
|
|
176 |
You could also host a [Gradio](https://www.gradio.app/) App in your own computer via:
|
177 |
|
178 |
```bash
|
|
|
179 |
python3 gradio_app.py
|
180 |
```
|
181 |
|
182 |
+
### API Server
|
183 |
+
|
184 |
+
You could launch an API server locally, which you could post web request for Image/Text to 3D, Texturing existing mesh,
|
185 |
+
and e.t.c.
|
186 |
+
|
187 |
+
```bash
|
188 |
+
python api_server.py --host 0.0.0.0 --port 8080
|
189 |
+
```
|
190 |
+
|
191 |
+
A demo post request for image to 3D without texture.
|
192 |
+
|
193 |
+
```bash
|
194 |
+
img_b64_str=$(base64 -i assets/demo.png)
|
195 |
+
curl -X POST "http://localhost:8080/generate" \
|
196 |
+
-H "Content-Type: application/json" \
|
197 |
+
-d '{
|
198 |
+
"image": "'"$img_b64_str"'",
|
199 |
+
}' \
|
200 |
+
-o test2.glb
|
201 |
+
```
|
202 |
+
|
203 |
+
### Blender Addon
|
204 |
+
|
205 |
+
With an API server launched, you could also directly use Hunyuan3D 2.0 in your blender with
|
206 |
+
our [Blender Addon](blender_addon.py). Please follow our tutorial to install and use.
|
207 |
+
|
208 |
+
https://github.com/user-attachments/assets/8230bfb5-32b1-4e48-91f4-a977c54a4f3e
|
209 |
+
|
210 |
+
### Official Site
|
211 |
+
|
212 |
Don't forget to visit [Hunyuan3D](https://3d.hunyuan.tencent.com) for quick use, if you don't want to host yourself.
|
213 |
|
214 |
## π Open-Source Plan
|
|
|
221 |
|
222 |
## π BibTeX
|
223 |
|
224 |
+
If you found this repository helpful, please cite our reports:
|
225 |
|
226 |
```bibtex
|
227 |
@misc{hunyuan3d22025tencent,
|
|
|
233 |
primaryClass={cs.CV}
|
234 |
}
|
235 |
|
236 |
+
@misc{yang2024hunyuan3d,
|
237 |
+
title={Hunyuan3D 1.0: A Unified Framework for Text-to-3D and Image-to-3D Generation},
|
238 |
author={Tencent Hunyuan3D Team},
|
239 |
year={2024},
|
240 |
eprint={2411.02293},
|
|
|
247 |
|
248 |
Thanks for the contributions of community members, here we have these great extensions of Hunyuan3D 2.0:
|
249 |
|
250 |
+
- [ComfyUI-3D-Pack](https://github.com/MrForExample/ComfyUI-3D-Pack)
|
251 |
- [ComfyUI-Hunyuan3DWrapper](https://github.com/kijai/ComfyUI-Hunyuan3DWrapper)
|
252 |
- [Hunyuan3D-2-for-windows](https://github.com/sdbds/Hunyuan3D-2-for-windows)
|
253 |
+
- [π¦ A bundle for running on Windows | ζ΄εε
](https://github.com/YanWenKun/Hunyuan3D-2-WinPortable)
|
254 |
+
- [Hunyuan3D-2GP](https://github.com/deepbeepmeep/Hunyuan3D-2GP)
|
255 |
+
- [Kaggle Notebook](https://github.com/darkon12/Hunyuan3D-2GP_Kaggle)
|
256 |
|
257 |
## Acknowledgements
|
258 |
|
259 |
We would like to thank the contributors to
|
260 |
+
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), [HuggingFace](https://huggingface.co), [CraftsMan3D](https://github.com/wyysf-98/CraftsMan3D),
|
261 |
+
and [Michelangelo](https://github.com/NeuralCarver/Michelangelo/tree/main) repositories, for their open research and
|
262 |
+
exploration.
|
263 |
|
264 |
## Star History
|
265 |
|
|
|
269 |
<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=Tencent/Hunyuan3D-2&type=Date" />
|
270 |
<img alt="Star History Chart" src="https://api.star-history.com/svg?repos=Tencent/Hunyuan3D-2&type=Date" />
|
271 |
</picture>
|
272 |
+
</a>
|
273 |
+
```
|