{
 "slug": "hunyuan3d-2",
 "name": "Hunyuan3D 2.0",
 "author": "Tencent Hunyuan",
 "density": "full",
 "status": "active",
 "status_note": null,
 "alternatives_page": null,
 "one_liner": "Tencent's image-to-3D system: a shape model builds the mesh, then a paint model textures it.",
 "category": {
  "slug": "ai-3d",
  "name": "AI 3D model generators"
 },
 "tags": [
  "Open source"
 ],
 "styles": [],
 "logo_url": "https://agentgid.com/media/avatars/tencent-hunyuan.png",
 "logo_letter": "H",
 "links": {
  "repo": "https://github.com/Tencent-Hunyuan/Hunyuan3D-2",
  "website": "https://huggingface.co/tencent/Hunyuan3D-2",
  "api_docs": null
 },
 "preview": null,
 "verdicts": [
  {
   "key": "price",
   "label": "Price",
   "value": "Free",
   "status": "yes",
   "sub": "No paid plan",
   "quote": null,
   "note": "Open weights, free to download.",
   "source": {
    "label": "huggingface.co/tencent/Hunyuan3D-2",
    "url": "https://huggingface.co/tencent/Hunyuan3D-2"
   },
   "n": 1
  },
  {
   "key": "commercial",
   "label": "Commercial use",
   "value": "With conditions",
   "status": "cond",
   "sub": "Tencent Hunyuan 3D 2.0…",
   "quote": "THIS LICENSE AGREEMENT DOES NOT APPLY IN THE EUROPEAN UNION, UNITED KINGDOM AND SOUTH KOREA",
   "note": "Allowed only outside the EU, the UK and South Korea, under 1 million monthly active users, and within the Acceptable Use Policy.",
   "source": {
    "label": "huggingface.co",
    "url": "https://huggingface.co/tencent/Hunyuan3D-2/blob/main/LICENSE"
   },
   "n": 2
  },
  {
   "key": "credit",
   "label": "Credit the author",
   "value": "Not needed",
   "status": "yes",
   "sub": null,
   "quote": "All distributions to Third Parties (other than through a Hosted Service) must be accompanied by a “Notice” text file",
   "note": null,
   "source": {
    "label": "huggingface.co",
    "url": "https://huggingface.co/tencent/Hunyuan3D-2/blob/main/LICENSE"
   },
   "n": 3
  },
  {
   "key": "agent_access",
   "label": "Agent access",
   "value": "Download",
   "status": "info",
   "sub": "Files by hand",
   "quote": null,
   "note": "There is no package or API. Files are downloaded by hand from the official site.",
   "source": {
    "label": "github.com/Tencent-Hunyuan/Hunyuan3D-2",
    "url": "https://github.com/Tencent-Hunyuan/Hunyuan3D-2"
   },
   "n": 4
  }
 ],
 "license": {
  "name": "Tencent Hunyuan 3D 2.0 Community License",
  "url": "https://huggingface.co/tencent/Hunyuan3D-2/blob/main/LICENSE",
  "summary": "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.",
  "pages_read": 1,
  "rules": [
   "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."
  ],
  "rows": [
   {
    "label": "Commercial use",
    "value": "With conditions",
    "status": "cond",
    "quote": "THIS LICENSE AGREEMENT DOES NOT APPLY IN THE EUROPEAN UNION, UNITED KINGDOM AND SOUTH KOREA",
    "source": {
     "label": "huggingface.co",
     "url": "https://huggingface.co/tencent/Hunyuan3D-2/blob/main/LICENSE"
    },
    "note": null
   },
   {
    "label": "Credit",
    "value": "Not needed",
    "status": "yes",
    "quote": "All distributions to Third Parties (other than through a Hosted Service) must be accompanied by a “Notice” text file",
    "source": {
     "label": "huggingface.co",
     "url": "https://huggingface.co/tencent/Hunyuan3D-2/blob/main/LICENSE"
    },
    "note": null
   },
   {
    "label": "Inside your app or game",
    "value": "With conditions",
    "status": "cond",
    "quote": "is greater than 1 million monthly active users in the preceding calendar month, You must request a license from Tencent",
    "source": {
     "label": "huggingface.co",
     "url": "https://huggingface.co/tencent/Hunyuan3D-2/blob/main/LICENSE"
    },
    "note": null
   },
   {
    "label": "Pass the files on to your users",
    "value": "With conditions",
    "status": "cond",
    "quote": "You must cause any modified files to carry prominent notices stating that You changed the files;",
    "source": {
     "label": "LICENSE on GitHub",
     "url": "https://github.com/Tencent-Hunyuan/Hunyuan3D-2/blob/main/LICENSE"
    },
    "note": "Redistribution of the weights is allowed only in the Territory, with the license copy, the Notice file and notes on changed files."
   },
   {
    "label": "AI training",
    "value": "Not stated",
    "status": "unknown",
    "quote": null,
    "source": null,
    "note": null
   },
   {
    "label": "Bots and bulk downloads",
    "value": "Not stated",
    "status": "unknown",
    "quote": null,
    "source": null,
    "note": null
   }
  ],
  "checked_at": "2026-10-25",
  "commercial_use_page": "https://agentgid.com/assets/hunyuan3d-2/commercial-use/"
 },
 "overview": {
  "heading": "Hunyuan3D 2.0: turn one picture into a 3D model",
  "body": "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."
 },
 "uses": [
  {
   "title": "A 3D object from a photo",
   "text": "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.",
   "idea": false,
   "image": null
  },
  {
   "title": "Paint colors onto a model",
   "text": "Add colors and surface detail to a bare 3D model, either one the model just made or one a person modelled by hand.",
   "idea": false,
   "image": null
  },
  {
   "title": "A local 3D service for your app",
   "text": "Run it as a small service on your own machine, so your app can send a picture and get a 3D file back.",
   "idea": false,
   "image": null
  },
  {
   "title": "Make 3D assets inside Blender",
   "text": "Artists can call it from Blender through the official add-on and get the result straight into their scene.",
   "idea": false,
   "image": null
  },
  {
   "title": "Props for a game prototype",
   "text": "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": true,
   "image": null
  },
  {
   "title": "3D views on product pages",
   "text": "Turn a clean product photo into a model that shoppers can spin on the product page in a web 3D viewer.",
   "idea": true,
   "image": null
  }
 ],
 "start": {
  "prompt": "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.",
  "install": null,
  "install_note": null,
  "code": [
   {
    "tab": "Step 1",
    "intro": "Install PyTorch from its official site first, then install the code from the Hunyuan3D-2 folder, including the two texture parts.",
    "source": "pip install -r requirements.txt\npip install -e .\n# for texture\ncd hy3dgen/texgen/custom_rasterizer\npython3 setup.py install\ncd ../../..\ncd hy3dgen/texgen/differentiable_renderer\npython3 setup.py install"
   },
   {
    "tab": "Step 2",
    "intro": "Or start the ready-made web page on your own computer, here with the smaller mini model and the low memory mode.",
    "source": "python3 gradio_app.py --model_path tencent/Hunyuan3D-2mini --subfolder hunyuan3d-dit-v2-mini --texgen_model_path tencent/Hunyuan3D-2 --low_vram_mode"
   }
  ]
 },
 "mistakes": [
  {
   "dont": "Installing only requirements.txt and then calling Hunyuan3DPaintPipeline",
   "fix": "Also build custom_rasterizer and differentiable_renderer under hy3dgen/texgen, as in the install steps",
   "why": "The texture model needs these two compiled parts; the shape model alone works without them.",
   "dont_code": false,
   "fix_code": false
  },
  {
   "dont": "Running shape and texture together on an 8 GB graphics card",
   "fix": "Use 16 GB for both, or the mini model with --low_vram_mode, or shapes only",
   "why": "Shape alone needs about 6 GB, shape plus texture about 16 GB.",
   "dont_code": false,
   "fix_code": false
  },
  {
   "dont": "Shipping the weights inside your app without the license and Notice file",
   "fix": "Ship a copy of the license and a Notice text file with the exact notice from section 3(d), and mark changed files",
   "why": "The license makes the Notice file a condition of every distribution other than a hosted service.",
   "dont_code": false,
   "fix_code": false
  },
  {
   "dont": "Serving generated models to visitors from the EU, the UK or South Korea, or training another model on the outputs",
   "fix": "Block or skip those regions and keep outputs out of training data for other models",
   "why": "Use outside the Territory and improving other AI models with outputs are both forbidden by the license.",
   "dont_code": false,
   "fix_code": false
  },
  {
   "dont": "Starting api_server.py with --host 0.0.0.0 on a machine reachable from the internet",
   "fix": "Bind to 127.0.0.1 or put the service behind your own authenticated backend",
   "why": "The docs example listens on every network interface, and the request example sends no key.",
   "dont_code": false,
   "fix_code": false
  }
 ],
 "agent": {
  "self_serve": false,
  "self_serve_text": null,
  "install": null,
  "repo": "https://github.com/Tencent-Hunyuan/Hunyuan3D-2",
  "api_docs": null,
  "api_account": "Not needed. Everything runs on your side.",
  "get_files": null,
  "formats": [],
  "limits": null,
  "mcp": null,
  "mcp_url": null,
  "credit_line": "Powered by Tencent Hunyuan",
  "rules_text": "- 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.\n  Connect: download from https://huggingface.co/tencent/Hunyuan3D-2 (no API).\n  Rule: Not licensed in the EU, the UK or South Korea; do not use, ship or show outputs there.\n  Rule: Products with over 1 million monthly active users need a separate license from Tencent.\n  Rule: Follow the Acceptable Use Policy; do not use outputs to improve other AI models.\n  Rule: Ship the license and the Tencent Hunyuan 3D 2.0 Notice file with redistributed weights.\n  License: https://huggingface.co/tencent/Hunyuan3D-2/blob/main/LICENSE (checked 2026-10-25; details: https://agentgid.com/assets/hunyuan3d-2/)",
  "agent_md": "https://agentgid.com/assets/hunyuan3d-2/agent.md",
  "card_json": "https://agentgid.com/assets/hunyuan3d-2/card.json"
 },
 "popularity": {
  "gid_score": 38,
  "stars": 15492,
  "downloads_7d": null,
  "downloads_7d_label": null,
  "downloads_change_4w_pct": null,
  "eco": null,
  "package": null,
  "repo": "Tencent-Hunyuan/Hunyuan3D-2",
  "agent_projects": null,
  "agent_projects_total": null,
  "downloads_unconfirmed": false,
  "series": {
   "downloads_weekly": [],
   "stars": [
    [
     "2026-11-07",
     15342
    ],
    [
     "2026-11-08",
     15350
    ],
    [
     "2026-11-09",
     15364
    ],
    [
     "2026-11-10",
     15376
    ],
    [
     "2026-11-11",
     15382
    ],
    [
     "2026-11-12",
     15391
    ],
    [
     "2026-11-13",
     15396
    ],
    [
     "2026-11-14",
     15401
    ],
    [
     "2026-11-15",
     15417
    ],
    [
     "2026-11-16",
     15436
    ],
    [
     "2026-11-17",
     15459
    ],
    [
     "2026-11-18",
     15487
    ],
    [
     "2026-11-19",
     15492
    ]
   ]
  },
  "stars_flat_since": null,
  "updated_at": "2026-11-19"
 },
 "alternatives": [
  {
   "slug": "hunyuan3d-2",
   "name": "Hunyuan3D 2.0",
   "why": null,
   "current": true,
   "price": "Free",
   "commercial": {
    "value": "With conditions",
    "status": "cond"
   },
   "access": "Download"
  },
  {
   "slug": "trellis",
   "name": "TRELLIS",
   "why": "Pick TRELLIS from Microsoft when you want MIT-licensed weights and outputs as meshes, 3D Gaussians or radiance fields from one image.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "With conditions",
    "status": "cond"
   },
   "access": "Download"
  },
  {
   "slug": "triposr",
   "name": "TripoSR",
   "why": "Pick TripoSR when speed matters more than detail; its makers cite under 0.5 seconds per model on an A100 graphics card.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "Download"
  },
  {
   "slug": "shap-e",
   "name": "Shap-E",
   "why": "Pick Shap-E from OpenAI when you want to start from a text prompt as well as from an image.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "With conditions",
    "status": "cond"
   },
   "access": "Download"
  },
  {
   "slug": "point-e",
   "name": "Point-E",
   "why": "Official code and models for generating 3D point clouds from text or images, plus a model that turns point clouds into meshes.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "With conditions",
    "status": "cond"
   },
   "access": "Download"
  },
  {
   "slug": "depth-anything",
   "name": "Depth Anything 3 (DA3-BASE)",
   "why": "Open-weights vision transformer that predicts depth maps, camera poses and 3D geometry from one or more images.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "With conditions",
    "status": "cond"
   },
   "access": "Download"
  }
 ],
 "faq": [
  {
   "q": "Can I use the 3D models it makes in a paid product?",
   "a": "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."
  },
  {
   "q": "Which computers does it run on?",
   "a": "The code supports macOS, Windows and Linux; you need about 6 GB of graphics memory for shapes and 16 GB with colors."
  },
  {
   "q": "Can I try it without installing anything?",
   "a": "Yes, Tencent runs a web version, Hunyuan3D Studio. Your pictures then go to Tencent instead of staying on your machine."
  },
  {
   "q": "What file do I get?",
   "a": "The shape comes back as a trimesh object that you save as GLB, OBJ or another 3D format."
  },
  {
   "q": "Is there a smaller version?",
   "a": "Yes. Hunyuan3D-2mini has a 0.6 billion parameter shape model, next to the 1.1 billion one in the main release."
  }
 ],
 "at_a_glance": {
  "latest_version": "2.0.2",
  "last_commit": "2025-10-28",
  "runtime": "PyTorch installed first; graphics card with about 6 GB memory for shapes, 16 GB for shapes with texture; texture parts compiled from the code folder",
  "key_needed": false
 },
 "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."
 ],
 "stack_snippets": [],
 "claims": [
  "Beats the open and closed 3D generators it was compared with on texture quality and on following the input picture"
 ],
 "checked": {
  "license_read": "2026-10-25",
  "overview_checked": "2026-11-10",
  "numbers_updated": "2026-11-19",
  "sources": [
   {
    "label": "huggingface.co/tencent/Hunyuan3D-2",
    "url": "https://huggingface.co/tencent/Hunyuan3D-2"
   },
   {
    "label": "huggingface.co",
    "url": "https://huggingface.co/tencent/Hunyuan3D-2/raw/main/README.md"
   },
   {
    "label": "huggingface.co",
    "url": "https://huggingface.co/tencent/Hunyuan3D-2/raw/main/LICENSE"
   },
   {
    "label": "huggingface.co",
    "url": "https://huggingface.co/tencent/Hunyuan3D-2/raw/main/NOTICE"
   },
   {
    "label": "huggingface.co",
    "url": "https://huggingface.co/api/models/tencent/Hunyuan3D-2"
   },
   {
    "label": "github.com/Tencent-Hunyuan/Hunyuan3D-2",
    "url": "https://github.com/Tencent-Hunyuan/Hunyuan3D-2"
   },
   {
    "label": "README on GitHub",
    "url": "https://github.com/Tencent-Hunyuan/Hunyuan3D-2/blob/main/README.md"
   },
   {
    "label": "LICENSE on GitHub",
    "url": "https://github.com/Tencent-Hunyuan/Hunyuan3D-2/blob/main/LICENSE"
   },
   {
    "label": "github.com/Tencent-Hunyuan/Hunyuan3D-2/blob/main/setup.py",
    "url": "https://github.com/Tencent-Hunyuan/Hunyuan3D-2/blob/main/setup.py"
   },
   {
    "label": "huggingface.co",
    "url": "https://huggingface.co/tencent/Hunyuan3D-2/blob/main/LICENSE"
   }
  ],
  "unverified": null
 },
 "user_reports": null,
 "url": "https://agentgid.com/assets/hunyuan3d-2/",
 "note": "Written by AgentGid from the official pages in checked.sources; quotes are copied from those pages. status: yes | cond | no | unknown | info. Prices and vendor claims are as reported on the checked date. Not legal advice."
}
