Skip to content
Agents tracked: 492 Releases (7d): 545 Agent status: 1 with issuesSince last limit reset: Claude 9d · Codex 7d For AI agents: Markdown Updated Nov 20, 2026

Hunyuan3D 2.0

by Tencent Hunyuan

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

AI 3D model generators Open source

GitHub repoWebsite

2. Commercial use: huggingface.co

“THIS LICENSE AGREEMENT DOES NOT APPLY IN THE EUROPEAN UNION, UNITED KINGDOM AND SOUTH KOREA”

Allowed only outside the EU, the UK and South Korea, under 1 million monthly active users, and within the Acceptable Use Policy.

huggingface.co

License checked Oct 25, 2026 against 1 official page. Tap a verdict to see its source. How we checked Report an error

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 you can 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 Idea

Fill an early game level or a 3D scene with quick stand-in objects made from concept sketches, then replace the best ones later.

3D views on product pages Idea

Turn a clean product photo into a model that shoppers can spin on the product page in a web 3D viewer.

As reported by Tencent Hunyuan: Beats the open and closed 3D generators it was compared with on texture quality and on following the input picture.

Hunyuan3D 2.0 popularity

38 / 100
Gid Score, same scale as developer tools
15,492
GitHub stars
Hunyuan3D 2.0: GitHub starsTencent-Hunyuan/Hunyuan3D-2 15,492

How the Gid Score is calculated

How to start

Tell your AI assistant

“Set up Hunyuan3D 2.0 from the Tencent-Hunyuan/Hunyuan3D-2 code (hy3dgen 2.0.2) in a virtual environment, generate a shape from product.png with Hunyuan3DDiTFlowMatchingPipeline, paint it with Hunyuan3DPaintPipeline and export product.glb; stop and ask me before downloading the weights.”

Show codeStep 1 or Step 2

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

Mistakes to avoid

Installing only requirements.txt and then calling Hunyuan3DPaintPipeline
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.

Running shape and texture together on an 8 GB graphics card
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.

Shipping the weights inside your app without the license and Notice file
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.

Serving generated models to visitors from the EU, the UK or South Korea, or training another model on the outputs
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.

Starting api_server.py with --host 0.0.0.0 on a machine reachable from the internet
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.

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.

Commercial use
With conditions

“THIS LICENSE AGREEMENT DOES NOT APPLY IN THE EUROPEAN UNION, UNITED KINGDOM AND SOUTH KOREA” huggingface.co

Credit
Not needed

“All distributions to Third Parties (other than through a Hosted Service) must be accompanied by a “Notice” text file” huggingface.co

Inside your app or game
With conditions

“is greater than 1 million monthly active users in the preceding calendar month, You must request a license from Tencent” huggingface.co

Pass the files on to your users
With conditions

Redistribution of the weights is allowed only in the Territory, with the license copy, the Notice file and notes on changed files.

“You must cause any modified files to carry prominent notices stating that You changed the files;” LICENSE on GitHub

AI training
Not stated
Bots and bulk downloads
Not stated

AllowedWith conditionsNot allowedNot stated or not checked yet

Is Hunyuan3D 2.0 free for commercial use? The full answer Not legal advice. Check the license page before you ship.

For your agent

License rules tell your agent what it may do with Hunyuan3D 2.0. Paste them into your prompt or AGENTS.md.

License rules
- 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/)
Can an agent use it by itself?
No.
API, key or account
Not needed. Everything runs on your side.
MCP server
None found
Credit line, if you want one
Powered by Tencent Hunyuan
This card for machines

Alternatives

Hunyuan3D 2.0 This page

Free With conditions Download

TRELLIS

Pick TRELLIS from Microsoft when you want MIT-licensed weights and outputs as meshes, 3D Gaussians or radiance fields from one image.

Free With conditions Download

TripoSR

Pick TripoSR when speed matters more than detail; its makers cite under 0.5 seconds per model on an A100 graphics card.

Free Commercial OK Download

Shap-E

Pick Shap-E from OpenAI when you want to start from a text prompt as well as from an image.

Free With conditions Download

Point-E

Official code and models for generating 3D point clouds from text or images, plus a model that turns point clouds into meshes.

Free With conditions Download

Depth Anything 3 (DA3-BASE)

Open-weights vision transformer that predicts depth maps, camera poses and 3D geometry from one or more images.

Free With conditions Download

All ai 3d model generators

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.