# Hunyuan3D 2.0 — card for AI agents

Tencent's image-to-3D system: a shape model builds the mesh, then a paint model textures it.

Category: AI 3D model generators · maker Tencent Hunyuan · checked 2026-10-25

## Price
- Price: Free
- Free tier: Open weights, free to download.

## License
Tencent Hunyuan 3D 2.0 Community License — https://huggingface.co/tencent/Hunyuan3D-2/blob/main/LICENSE

- commercial: **conditions** (Commercial use with conditions)
  > THIS LICENSE AGREEMENT DOES NOT APPLY IN THE EUROPEAN UNION, UNITED KINGDOM AND SOUTH KOREA
  (https://huggingface.co/tencent/Hunyuan3D-2/blob/main/LICENSE)
- attribution: **no** (No credit needed)
  > All distributions to Third Parties (other than through a Hosted Service) must be accompanied by a “Notice” text file
  (https://huggingface.co/tencent/Hunyuan3D-2/blob/main/LICENSE)
- in app: **conditions** (Ship inside your app with conditions)
  > is greater than 1 million monthly active users in the preceding calendar month, You must request a license from Tencent
  (https://huggingface.co/tencent/Hunyuan3D-2/blob/main/LICENSE)

## Rules to follow
- Not licensed in the EU, the UK or South Korea; do not use, ship or show outputs there.
- Products with over 1 million monthly active users need a separate license from Tencent.
- Follow the Acceptable Use Policy; do not use outputs to improve other AI models.
- Ship the license and the Tencent Hunyuan 3D 2.0 Notice file with redistributed weights.

## How to connect
- Download only
- Repository: https://github.com/Tencent-Hunyuan/Hunyuan3D-2
- Website: https://huggingface.co/tencent/Hunyuan3D-2

## Notes
Hugging Face API, Oct 25, 2026: 160,751 downloads, 1,857 likes; GitHub Tencent-Hunyuan/Hunyuan3D-2: 15,198 stars.

## Numbers (AgentGid data)
- Gid Score: 38
- GitHub stars: 15,492

## Lines to paste into your prompt or AGENTS.md

```
- Hunyuan3D 2.0 (AI 3D model generators). Tencent's image-to-3D system: a shape model builds the mesh, then a paint model textures it. Price: free; commercial use with conditions; no credit needed; ship inside your app with conditions.
  Connect: download from https://huggingface.co/tencent/Hunyuan3D-2 (no API).
  Rule: Not licensed in the EU, the UK or South Korea; do not use, ship or show outputs there.
  Rule: Products with over 1 million monthly active users need a separate license from Tencent.
  Rule: Follow the Acceptable Use Policy; do not use outputs to improve other AI models.
  Rule: Ship the license and the Tencent Hunyuan 3D 2.0 Notice file with redistributed weights.
  License: https://huggingface.co/tencent/Hunyuan3D-2/blob/main/LICENSE (checked 2026-10-25; details: https://agentgid.com/assets/hunyuan3d-2/)
```

## Links
- AgentGid page: https://agentgid.com/assets/hunyuan3d-2/
- Is it free for commercial use? https://agentgid.com/assets/hunyuan3d-2/commercial-use/
- Source: https://huggingface.co/tencent/Hunyuan3D-2
- Source: https://huggingface.co/tencent/Hunyuan3D-2/blob/main/LICENSE
- Source: https://github.com/Tencent-Hunyuan/Hunyuan3D-2
- Source: https://huggingface.co/api/models/tencent/Hunyuan3D-2


## Hunyuan3D 2.0: turn one picture into a 3D model

Hunyuan3D 2.0 is a free AI model from Tencent that turns a picture of an object into a 3D model with colors painted on. You run it on your own computer with a strong graphics card, or call a small local service from your app. Its license does not cover the EU, the UK or South Korea, and very large products need a separate deal.

### Where to use it
- A 3D object from a photo: Give it one picture of a thing, such as a toy, a chair or a sneaker. You get back its shape as a 3D model to save and open elsewhere.
- Paint colors onto a model: Add colors and surface detail to a bare 3D model, either one the model just made or one a person modelled by hand.
- A local 3D service for your app: Run it as a small service on your own machine, so your app can send a picture and get a 3D file back.
- Make 3D assets inside Blender: Artists can call it from Blender through the official add-on and get the result straight into their scene.
- Props for a game prototype: Fill an early game level or a 3D scene with quick stand-in objects made from concept sketches, then replace the best ones later. (idea, not from the official pages)
- 3D views on product pages: Turn a clean product photo into a model that shoppers can spin on the product page in a web 3D viewer. (idea, not from the official pages)

### How to start
- Install PyTorch from its official site first, then install the code from the Hunyuan3D-2 folder, including the two texture parts.

```
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
```

- Or start the ready-made web page on your own computer, here with the smaller mini model and the low memory mode.

```
python3 gradio_app.py --model_path tencent/Hunyuan3D-2mini --subfolder hunyuan3d-dit-v2-mini --texgen_model_path tencent/Hunyuan3D-2 --low_vram_mode
```


### License
Tencent Hunyuan 3D 2.0 Community License: free, also for paid products, but only outside the EU, the UK and South Korea. Products with over 1 million monthly users need a separate license, and outputs may not be used to improve other AI models.

### Good to know
- It needs a strong graphics card. Making the shape takes about 6 GB of graphics memory, shape plus colors about 16 GB.
- Using it, or showing its results, in the EU, the UK or South Korea is not licensed.
- When you post generated content in public, its use policy asks you to say clearly that a machine made it.
- Tencent claims no rights in the models you make, but you are responsible for them and how they are used.
- Newer releases exist, such as Hunyuan3D 2.1 with a new color model and training code; this card covers 2.0.

Checked 2026-11-10 against: https://huggingface.co/tencent/Hunyuan3D-2, https://huggingface.co/tencent/Hunyuan3D-2/raw/main/README.md, https://huggingface.co/tencent/Hunyuan3D-2/raw/main/LICENSE, https://huggingface.co/tencent/Hunyuan3D-2/raw/main/NOTICE, https://huggingface.co/api/models/tencent/Hunyuan3D-2, https://github.com/Tencent-Hunyuan/Hunyuan3D-2, https://github.com/Tencent-Hunyuan/Hunyuan3D-2/blob/main/README.md, https://github.com/Tencent-Hunyuan/Hunyuan3D-2/blob/main/LICENSE, https://github.com/Tencent-Hunyuan/Hunyuan3D-2/blob/main/setup.py

### Mistakes to avoid
- Don't: Installing only requirements.txt and then calling Hunyuan3DPaintPipeline → Do: Also build custom_rasterizer and differentiable_renderer under hy3dgen/texgen, as in the install steps (The texture model needs these two compiled parts; the shape model alone works without them.)
- Don't: Running shape and texture together on an 8 GB graphics card → Do: Use 16 GB for both, or the mini model with --low_vram_mode, or shapes only (Shape alone needs about 6 GB, shape plus texture about 16 GB.)
- Don't: Shipping the weights inside your app without the license and Notice file → Do: Ship a copy of the license and a Notice text file with the exact notice from section 3(d), and mark changed files (The license makes the Notice file a condition of every distribution other than a hosted service.)
- Don't: Serving generated models to visitors from the EU, the UK or South Korea, or training another model on the outputs → Do: Block or skip those regions and keep outputs out of training data for other models (Use outside the Territory and improving other AI models with outputs are both forbidden by the license.)
- Don't: Starting api_server.py with --host 0.0.0.0 on a machine reachable from the internet → Do: Bind to 127.0.0.1 or put the service behind your own authenticated backend (The docs example listens on every network interface, and the request example sends no key.)

### Questions
- Can I use the 3D models it makes in a paid product? Yes, outside the EU, the UK and South Korea, while your products stay under 1 million monthly active users and you follow the use policy. Tencent claims no rights in the outputs.
- Which computers does it run on? The code supports macOS, Windows and Linux; you need about 6 GB of graphics memory for shapes and 16 GB with colors.
- Can I try it without installing anything? Yes, Tencent runs a web version, Hunyuan3D Studio. Your pictures then go to Tencent instead of staying on your machine.
- What file do I get? The shape comes back as a trimesh object that you save as GLB, OBJ or another 3D format.
- Is there a smaller version? Yes. Hunyuan3D-2mini has a 0.6 billion parameter shape model, next to the 1.1 billion one in the main release.

---
AgentGid's catalog is curated: every entry was checked against the maker's official pages (registry, repository, license and pricing pages) on the date shown; a license value shows the quote it stands on wherever AgentGid has one. Usage numbers come from AgentGid's own scan of public repositories set up for AI coding agents. Claims by makers are reported, not tested by AgentGid.
