{"id":25556636,"url":"https://github.com/anongecko/3d-setup","last_synced_at":"2025-07-27T12:33:55.188Z","repository":{"id":277570666,"uuid":"932838106","full_name":"anongecko/3d-setup","owner":"anongecko","description":"unusable","archived":false,"fork":false,"pushed_at":"2025-02-14T16:22:07.000Z","size":69633,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-14T17:28:24.624Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/anongecko.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-02-14T16:02:42.000Z","updated_at":"2025-02-14T16:22:11.000Z","dependencies_parsed_at":"2025-02-14T17:39:15.209Z","dependency_job_id":null,"html_url":"https://github.com/anongecko/3d-setup","commit_stats":null,"previous_names":["anongecko/3d-setup"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anongecko%2F3d-setup","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anongecko%2F3d-setup/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anongecko%2F3d-setup/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anongecko%2F3d-setup/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/anongecko","download_url":"https://codeload.github.com/anongecko/3d-setup/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239857871,"owners_count":19708767,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-02-20T14:38:58.960Z","updated_at":"2025-02-20T14:38:59.619Z","avatar_url":"https://github.com/anongecko.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"[中文阅读](README_zh_cn.md)\n[日本語で読む](README_ja_jp.md)\n\n\u003cp align=\"center\"\u003e \n  \u003cimg src=\"./assets/images/teaser.jpg\"\u003e\n\n\u003c/p\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=https://3d.hunyuan.tencent.com target=\"_blank\"\u003e\u003cimg src=https://img.shields.io/badge/Official%20Site-333399.svg?logo=homepage height=22px\u003e\u003c/a\u003e\n  \u003ca href=https://huggingface.co/spaces/tencent/Hunyuan3D-2  target=\"_blank\"\u003e\u003cimg src=https://img.shields.io/badge/%F0%9F%A4%97%20Demo-276cb4.svg height=22px\u003e\u003c/a\u003e\n  \u003ca href=https://huggingface.co/tencent/Hunyuan3D-2 target=\"_blank\"\u003e\u003cimg src=https://img.shields.io/badge/%F0%9F%A4%97%20Models-d96902.svg height=22px\u003e\u003c/a\u003e\n  \u003ca href=https://3d-models.hunyuan.tencent.com/ target=\"_blank\"\u003e\u003cimg src= https://img.shields.io/badge/Page-bb8a2e.svg?logo=github height=22px\u003e\u003c/a\u003e\n  \u003ca href=https://discord.gg/GuaWYwzKbX target=\"_blank\"\u003e\u003cimg src= https://img.shields.io/badge/Discord-white.svg?logo=discord height=22px\u003e\u003c/a\u003e\n  \u003ca href=https://arxiv.org/abs/2501.12202 target=\"_blank\"\u003e\u003cimg src=https://img.shields.io/badge/Report-b5212f.svg?logo=arxiv height=22px\u003e\u003c/a\u003e\n  \u003ca href=https://x.com/txhunyuan target=\"_blank\"\u003e\u003cimg src=https://img.shields.io/badge/Hunyuan-black.svg?logo=x height=22px\u003e\u003c/a\u003e\n \u003ca href=\"#community-resources\" target=\"_blank\"\u003e\u003cimg src=https://img.shields.io/badge/Community-lavender.svg?logo=homeassistantcommunitystore height=22px\u003e\u003c/a\u003e\n\u003c/div\u003e\n\n[//]: # (  \u003ca href=# target=\"_blank\"\u003e\u003cimg src=https://img.shields.io/badge/Report-b5212f.svg?logo=arxiv height=22px\u003e\u003c/a\u003e)\n\n[//]: # (  \u003ca href=# target=\"_blank\"\u003e\u003cimg src= https://img.shields.io/badge/Colab-8f2628.svg?logo=googlecolab height=22px\u003e\u003c/a\u003e)\n\n[//]: # (  \u003ca href=\"#\"\u003e\u003cimg alt=\"PyPI - Downloads\" src=\"https://img.shields.io/pypi/v/mulankit?logo=pypi\"  height=22px\u003e\u003c/a\u003e)\n\n\u003cbr\u003e\n\n\n\u003e Join our **[Wechat](#)** and **[Discord](https://discord.gg/GuaWYwzKbX)** group to discuss and find help from us.\n\n| Wechat Group                                     | Xiaohongshu                                           | X                                           | Discord                                           |\n|--------------------------------------------------|-------------------------------------------------------|---------------------------------------------|---------------------------------------------------|\n| \u003cimg src=\"assets/qrcode/wechat.png\"  height=140\u003e | \u003cimg src=\"assets/qrcode/xiaohongshu.png\"  height=140\u003e | \u003cimg src=\"assets/qrcode/x.png\"  height=140\u003e | \u003cimg src=\"assets/qrcode/discord.png\"  height=140\u003e |        \n\n---\n\n\u003cp align=\"center\"\u003e\n“ Living out everyone’s imagination on creating and manipulating 3D assets.”\n\u003c/p\u003e\n\n## 🔥 News\n\n- Feb 3, 2025: 🐎\n  Release [Hunyuan3D-DiT-v2-0-Fast](https://huggingface.co/tencent/Hunyuan3D-2/tree/main/hunyuan3d-dit-v2-0-fast), our\n  guidance distillation model that could half the dit inference time, see [here](minimal_demo.py) for usage.\n- Jan 27, 2025: 🛠️ Release Blender addon for Hunyuan3D 2.0, Check it out [here](#blender-addon).\n- Jan 23, 2025: 💬 We thank community members for\n  creating [Windows installation tool](https://github.com/YanWenKun/Hunyuan3D-2-WinPortable), ComfyUI support\n  with [ComfyUI-Hunyuan3DWrapper](https://github.com/kijai/ComfyUI-Hunyuan3DWrapper)\n  and [ComfyUI-3D-Pack](https://github.com/MrForExample/ComfyUI-3D-Pack) and other\n  awesome [extensions](#community-resources).\n- Jan 21, 2025: 💬 Enjoy exciting 3D generation on our website [Hunyuan3D Studio](https://3d.hunyuan.tencent.com)!\n- Jan 21, 2025: 🤗 Release inference code and pretrained models\n  of [Hunyuan3D 2.0](https://huggingface.co/tencent/Hunyuan3D-2). Please give it a try\n  via [huggingface space](https://huggingface.co/spaces/tencent/Hunyuan3D-2) and\n  our [official site](https://3d.hunyuan.tencent.com)!\n\n## **Abstract**\n\nWe present Hunyuan3D 2.0, an advanced large-scale 3D synthesis system for generating high-resolution textured 3D assets.\nThis system includes two foundation components: a large-scale shape generation model - Hunyuan3D-DiT, and a large-scale\ntexture synthesis model - Hunyuan3D-Paint.\nThe shape generative model, built on a scalable flow-based diffusion transformer, aims to create geometry that properly\naligns with a given condition image, laying a solid foundation for downstream applications.\nThe texture synthesis model, benefiting from strong geometric and diffusion priors, produces high-resolution and vibrant\ntexture maps for either generated or hand-crafted meshes.\nFurthermore, we build Hunyuan3D-Studio - a versatile, user-friendly production platform that simplifies the re-creation\nprocess of 3D assets. It allows both professional and amateur users to manipulate or even animate their meshes\nefficiently.\nWe systematically evaluate our models, showing that Hunyuan3D 2.0 outperforms previous state-of-the-art models,\nincluding the open-source models and closed-source models in geometry details, condition alignment, texture quality, and\ne.t.c.\n\n\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/images/system.jpg\"\u003e\n\u003c/p\u003e\n\n## ☯️ **Hunyuan3D 2.0**\n\n### Architecture\n\nHunyuan3D 2.0 features a two-stage generation pipeline, starting with the creation of a bare mesh, followed by the\nsynthesis of a texture map for that mesh. This strategy is effective for decoupling the difficulties of shape and\ntexture generation and also provides flexibility for texturing either generated or handcrafted meshes.\n\n\u003cp align=\"left\"\u003e\n  \u003cimg src=\"assets/images/arch.jpg\"\u003e\n\u003c/p\u003e\n\n### Performance\n\nWe have evaluated Hunyuan3D 2.0 with other open-source as well as close-source 3d-generation methods.\nThe numerical results indicate that Hunyuan3D 2.0 surpasses all baselines in the quality of generated textured 3D assets\nand the condition following ability.\n\n| Model                   | CMMD(⬇)   | FID_CLIP(⬇) | FID(⬇)      | CLIP-score(⬆) |\n|-------------------------|-----------|-------------|-------------|---------------|\n| Top Open-source Model1  | 3.591     | 54.639      | 289.287     | 0.787         |\n| Top Close-source Model1 | 3.600     | 55.866      | 305.922     | 0.779         |\n| Top Close-source Model2 | 3.368     | 49.744      | 294.628     | 0.806         |\n| Top Close-source Model3 | 3.218     | 51.574      | 295.691     | 0.799         |\n| Hunyuan3D 2.0           | **3.193** | **49.165**  | **282.429** | **0.809**     |\n\nGeneration results of Hunyuan3D 2.0:\n\u003cp align=\"left\"\u003e\n  \u003cimg src=\"assets/images/e2e-1.gif\"  height=250\u003e\n  \u003cimg src=\"assets/images/e2e-2.gif\"  height=250\u003e\n\u003c/p\u003e\n\n## 🎁 Models Zoo\n\nIt takes 11.5 GB VRAM for shape generation and 24.5 GB for shape and texture generation in total.\n\n| Model                   |    Description                         | Date       | Size | Huggingface                                                                              |\n|-------------------------|-----------------------------|------------|------|------------------------------------------------------------------------------------------| \n| Hunyuan3D-DiT-v2-0-Fast | Guidance Distillation Model | 2025-02-03 | 2.6B | [Download](https://huggingface.co/tencent/Hunyuan3D-2/tree/main/hunyuan3d-dit-v2-0-fast) |\n| Hunyuan3D-DiT-v2-0      | Image to Shape Model        | 2025-01-21 | 2.6B | [Download](https://huggingface.co/tencent/Hunyuan3D-2/tree/main/hunyuan3d-dit-v2-0)      |\n| 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)    |\n| 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)  | \n\n## 🤗 Get Started with Hunyuan3D 2.0\n\nYou may follow the next steps to use Hunyuan3D 2.0 via:\n\n- [Code](#code-usage)\n- [Gradio App](#gradio-app)\n- [API Server](#api-server)\n- [Blender Addon](#blender-addon)\n- [Official Site](#official-site)\n\n### Install Requirements\n\nPlease install Pytorch via the [official](https://pytorch.org/) site. Then install the other requirements via\n\n```bash\npip install -r requirements.txt\n# for texture\ncd hy3dgen/texgen/custom_rasterizer\npython3 setup.py install\ncd ../../..\ncd hy3dgen/texgen/differentiable_renderer\npython3 setup.py install\n```\n\n### Code Usage\n\nWe designed a diffusers-like API to use our shape generation model - Hunyuan3D-DiT and texture synthesis model -\nHunyuan3D-Paint.\n\nYou could assess **Hunyuan3D-DiT** via:\n\n```python\nfrom hy3dgen.shapegen import Hunyuan3DDiTFlowMatchingPipeline\n\npipeline = Hunyuan3DDiTFlowMatchingPipeline.from_pretrained('tencent/Hunyuan3D-2')\nmesh = pipeline(image='assets/demo.png')[0]\n```\n\nThe output mesh is a [trimesh object](https://trimesh.org/trimesh.html), which you could save to glb/obj (or other\nformat) file.\n\nFor **Hunyuan3D-Paint**, do the following:\n\n```python\nfrom hy3dgen.texgen import Hunyuan3DPaintPipeline\nfrom hy3dgen.shapegen import Hunyuan3DDiTFlowMatchingPipeline\n\n# let's generate a mesh first\npipeline = Hunyuan3DDiTFlowMatchingPipeline.from_pretrained('tencent/Hunyuan3D-2')\nmesh = pipeline(image='assets/demo.png')[0]\n\npipeline = Hunyuan3DPaintPipeline.from_pretrained('tencent/Hunyuan3D-2')\nmesh = pipeline(mesh, image='assets/demo.png')\n```\n\nPlease visit [minimal_demo.py](minimal_demo.py) for more advanced usage, such as **text to 3D** and **texture generation\nfor handcrafted mesh**.\n\n### Gradio App\n\nYou could also host a [Gradio](https://www.gradio.app/) App in your own computer via:\n\n```bash\npython3 gradio_app.py\n```\n\n### API Server\n\nYou could launch an API server locally, which you could post web request for Image/Text to 3D, Texturing existing mesh,\nand e.t.c.\n\n```bash\npython api_server.py --host 0.0.0.0 --port 8080\n```\n\nA demo post request for image to 3D without texture.\n\n```bash\nimg_b64_str=$(base64 -i assets/demo.png)\ncurl -X POST \"http://localhost:8080/generate\" \\\n     -H \"Content-Type: application/json\" \\\n     -d '{\n           \"image\": \"'\"$img_b64_str\"'\",\n         }' \\\n     -o test2.glb\n```\n\n### Blender Addon\n\nWith an API server launched, you could also directly use Hunyuan3D 2.0 in your blender with\nour [Blender Addon](blender_addon.py). Please follow our tutorial to install and use.\n\nhttps://github.com/user-attachments/assets/8230bfb5-32b1-4e48-91f4-a977c54a4f3e\n\n### Official Site\n\nDon't forget to visit [Hunyuan3D](https://3d.hunyuan.tencent.com) for quick use, if you don't want to host yourself.\n\n## 📑 Open-Source Plan\n\n- [x] Inference Code\n- [x] Model Checkpoints\n- [x] Technical Report\n- [ ] ComfyUI\n- [ ] TensorRT Version\n\n## 🔗 BibTeX\n\nIf you found this repository helpful, please cite our reports:\n\n```bibtex\n@misc{hunyuan3d22025tencent,\n    title={Hunyuan3D 2.0: Scaling Diffusion Models for High Resolution Textured 3D Assets Generation},\n    author={Tencent Hunyuan3D Team},\n    year={2025},\n    eprint={2501.12202},\n    archivePrefix={arXiv},\n    primaryClass={cs.CV}\n}\n\n@misc{yang2024hunyuan3d,\n    title={Hunyuan3D 1.0: A Unified Framework for Text-to-3D and Image-to-3D Generation},\n    author={Tencent Hunyuan3D Team},\n    year={2024},\n    eprint={2411.02293},\n    archivePrefix={arXiv},\n    primaryClass={cs.CV}\n}\n```\n\n## Community Resources\n\nThanks for the contributions of community members, here we have these great extensions of Hunyuan3D 2.0:\n\n- [ComfyUI-3D-Pack](https://github.com/MrForExample/ComfyUI-3D-Pack)\n- [ComfyUI-Hunyuan3DWrapper](https://github.com/kijai/ComfyUI-Hunyuan3DWrapper)\n- [Hunyuan3D-2-for-windows](https://github.com/sdbds/Hunyuan3D-2-for-windows)\n- [📦 A bundle for running on Windows | 整合包](https://github.com/YanWenKun/Hunyuan3D-2-WinPortable)\n- [Hunyuan3D-2GP](https://github.com/deepbeepmeep/Hunyuan3D-2GP)\n\n## Acknowledgements\n\nWe would like to thank the contributors to\nthe [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),\nand [Michelangelo](https://github.com/NeuralCarver/Michelangelo/tree/main) repositories, for their open research and\nexploration.\n\n## Star History\n\n\u003ca href=\"https://star-history.com/#Tencent/Hunyuan3D-2\u0026Date\"\u003e\n \u003cpicture\u003e\n   \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://api.star-history.com/svg?repos=Tencent/Hunyuan3D-2\u0026type=Date\u0026theme=dark\" /\u003e\n   \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"https://api.star-history.com/svg?repos=Tencent/Hunyuan3D-2\u0026type=Date\" /\u003e\n   \u003cimg alt=\"Star History Chart\" src=\"https://api.star-history.com/svg?repos=Tencent/Hunyuan3D-2\u0026type=Date\" /\u003e\n \u003c/picture\u003e\n\u003c/a\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fanongecko%2F3d-setup","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fanongecko%2F3d-setup","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fanongecko%2F3d-setup/lists"}