Add Transformers library name and update model card

#1
by nielsr HF staff - opened
Files changed (1) hide show
  1. README.md +68 -19
README.md CHANGED
@@ -1,17 +1,18 @@
1
  ---
2
- library_name: hunyuan3d-2.0
 
 
 
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
- - Jan 21, 2025: πŸ’¬ Release [Hunyuan3D 2.0](https://huggingface.co/spaces/tencent/Hunyuan3D-2). Please give it a try!
 
 
 
 
 
 
 
 
 
 
 
 
 
 
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
- bash compile_mesh_painter.sh OR python3 setup.py install (on Windows)
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 report:
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{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 +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/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
 
@@ -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
+ ```