{
 "slug": "hunyuandit",
 "name": "HunyuanDiT",
 "author": "Tencent Hunyuan",
 "density": "full",
 "status": "active",
 "status_note": null,
 "alternatives_page": null,
 "one_liner": "Tencent's diffusion-transformer text-to-image model with fine-grained Chinese and English prompt understanding.",
 "category": {
  "slug": "ai-images",
  "name": "AI image 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/HunyuanDiT",
  "website": "https://huggingface.co/Tencent-Hunyuan/HunyuanDiT",
  "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-Hunyuan/HunyuanDiT",
    "url": "https://huggingface.co/Tencent-Hunyuan/HunyuanDiT"
   },
   "n": 1
  },
  {
   "key": "commercial",
   "label": "Commercial use",
   "value": "With conditions",
   "status": "cond",
   "sub": "Tencent Hunyuan Community…",
   "quote": "is greater than 100 million monthly active users in the preceding calendar month, You must request a license from Tencent",
   "note": "Allowed under the Tencent Hunyuan Community License if you follow the Acceptable Use Policy, stay under 100 million monthly users and, under the code repository license, stay outside the EU.",
   "source": {
    "label": "huggingface.co",
    "url": "https://huggingface.co/Tencent-Hunyuan/HunyuanDiT/blob/main/LICENSE.txt"
   },
   "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-Hunyuan/HunyuanDiT/blob/main/LICENSE.txt"
   },
   "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/HunyuanDiT",
    "url": "https://github.com/Tencent-Hunyuan/HunyuanDiT"
   },
   "n": 4
  }
 ],
 "license": {
  "name": "Tencent Hunyuan Community License",
  "url": "https://huggingface.co/Tencent-Hunyuan/HunyuanDiT/blob/main/LICENSE.txt",
  "summary": "Free to use, also in paid products, under the Tencent Hunyuan Community License. Very large services need Tencent's permission, and the license file published with the code does not cover the European Union. Pictures you make are yours, but posted AI pictures must be marked as machine-made.",
  "pages_read": 1,
  "rules": [
   "Products with over 100 million monthly active users need a separate license from Tencent.",
   "Follow the Acceptable Use Policy; do not use outputs to improve other large language models.",
   "Give recipients a copy of the license and ship the Tencent Hunyuan Notice file with redistributed weights."
  ],
  "rows": [
   {
    "label": "Commercial use",
    "value": "With conditions",
    "status": "cond",
    "quote": "is greater than 100 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-Hunyuan/HunyuanDiT/blob/main/LICENSE.txt"
    },
    "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-Hunyuan/HunyuanDiT/blob/main/LICENSE.txt"
    },
    "note": null
   },
   {
    "label": "Inside your app or game",
    "value": "With conditions",
    "status": "cond",
    "quote": "You must provide all such Third Party recipients of the Tencent Hunyuan Works or products or services using them a copy of this Agreement",
    "source": {
     "label": "huggingface.co",
     "url": "https://huggingface.co/Tencent-Hunyuan/HunyuanDiT/blob/main/LICENSE.txt"
    },
    "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": "huggingface.co",
     "url": "https://huggingface.co/Tencent-Hunyuan/HunyuanDiT/raw/main/LICENSE.txt"
    },
    "note": "Share the weights only with the license, the Notice file and a clear note on files you changed."
   },
   {
    "label": "Monetized YouTube",
    "value": "With conditions",
    "status": "cond",
    "quote": "Tencent claims no rights in Outputs You generate. You and Your users are solely responsible for Outputs and their subsequent uses.",
    "source": {
     "label": "huggingface.co",
     "url": "https://huggingface.co/Tencent-Hunyuan/HunyuanDiT/blob/main/LICENSE.txt"
    },
    "note": null
   },
   {
    "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/hunyuandit/commercial-use/"
 },
 "overview": {
  "heading": "Hunyuan-DiT: open image model for Chinese and English prompts",
  "body": "Hunyuan-DiT is an open AI model from Tencent that draws pictures from a written description in Chinese or English. It is known for understanding Chinese culture and long, detailed prompts, and a helper model can refine a picture over several chat turns. You run it on your own NVIDIA graphics card; business use is free under Tencent's own license with some rules."
 },
 "uses": [
  {
   "title": "Pictures from Chinese prompts",
   "text": "Make illustrations from prompts written in Chinese, including Chinese art styles and cultural details that many other models miss.",
   "idea": false,
   "image": null
  },
  {
   "title": "Quicker drafts with the fast version",
   "text": "Use the distilled model with fewer steps when you need many draft pictures, for example to pick a direction for a poster.",
   "idea": false,
   "image": null
  },
  {
   "title": "Refine a picture by chatting",
   "text": "Describe a picture, then ask for changes in follow-up messages; a helper model rewrites the prompt each turn.",
   "idea": false,
   "image": null
  },
  {
   "title": "Follow a pose or outline",
   "text": "Give it an edge sketch, a pose or a depth picture, and it draws a new image that keeps that layout.",
   "idea": false,
   "image": null
  },
  {
   "title": "Teach it your own style",
   "text": "Train a small add-on on your own pictures, such as a product line or a house style, and reuse it in every prompt.",
   "idea": false,
   "image": null
  },
  {
   "title": "Visuals for Chinese-speaking customers",
   "text": "Make banners and social images for a shop or app aimed at Chinese-speaking customers, written straight from Chinese briefs.",
   "idea": true,
   "image": null
  }
 ],
 "start": {
  "prompt": "On my Linux machine with an NVIDIA card of 11 GB or more, install diffusers and generate a 1024x1024 image with HunyuanDiTPipeline from Tencent-Hunyuan/HunyuanDiT-v1.2-Diffusers for a Chinese prompt, and mark the saved image as AI-generated where we publish it.",
  "install": "pip install diffusers",
  "install_note": "On Linux with an NVIDIA card of at least 11 GB, install PyTorch 2.0 or newer and the diffusers library.",
  "code": [
   {
    "tab": "Step 1",
    "intro": "Load the v1.2 model in Diffusers format and draw a picture from a Chinese or English prompt.",
    "source": "pipe = HunyuanDiTPipeline.from_pretrained(\"Tencent-Hunyuan/HunyuanDiT-v1.2-Diffusers\", torch_dtype=torch.float16)\npipe.to(\"cuda\")"
   },
   {
    "tab": "Step 2",
    "intro": "For the chat-style refining and the full scripts, clone the code and download all model files into ckpts.",
    "source": "huggingface-cli download Tencent-Hunyuan/HunyuanDiT-v1.2 --local-dir ./ckpts"
   }
  ]
 },
 "mistakes": [
  {
   "dont": "HunyuanDiTPipeline.from_pretrained(\"Tencent-Hunyuan/HunyuanDiT\")",
   "fix": "HunyuanDiTPipeline.from_pretrained(\"Tencent-Hunyuan/HunyuanDiT-v1.2-Diffusers\", torch_dtype=torch.float16)",
   "why": "The official Diffusers example loads the -Diffusers model page; the original page holds files for the project's own scripts in t2i/ and dialoggen/ folders.",
   "dont_code": false,
   "fix_code": false
  },
  {
   "dont": "Loading the prompt helper and the image model together on a 16 GB card",
   "fix": "Start with --no-enhance, or load the helper in 4-bit with --load-4bit",
   "why": "DialogGen plus Hunyuan-DiT needs about 32 GB; the image model alone needs 11 GB.",
   "dont_code": false,
   "fix_code": false
  },
  {
   "dont": "Publishing generated pictures on a site or social account with no AI label",
   "fix": "Mark them clearly as machine-generated, for example in the caption or alt text",
   "why": "The Acceptable Use Policy in the license requires it for public content.",
   "dont_code": false,
   "fix_code": false
  },
  {
   "dont": "Running the GitHub code for users in the European Union without checking the license",
   "fix": "Check where your users are; the license in the code repository is limited to a territory that excludes the EU",
   "why": "Use outside the territory is unlicensed.",
   "dont_code": false,
   "fix_code": false
  },
  {
   "dont": "Shipping the model files in your product without the license and Notice file",
   "fix": "Give recipients the license and include the Notice text file",
   "why": "The license makes both a condition of distribution.",
   "dont_code": false,
   "fix_code": false
  }
 ],
 "agent": {
  "self_serve": false,
  "self_serve_text": null,
  "install": null,
  "repo": "https://github.com/Tencent-Hunyuan/HunyuanDiT",
  "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": "- HunyuanDiT (AI image generators). Tencent's diffusion-transformer text-to-image model with fine-grained Chinese and English prompt understanding. Price: free; commercial use with conditions; no credit needed; ship inside your app with conditions.\n  Connect: download from https://huggingface.co/Tencent-Hunyuan/HunyuanDiT (no API).\n  Rule: Products with over 100 million monthly active users need a separate license from Tencent.\n  Rule: Follow the Acceptable Use Policy; do not use outputs to improve other large language models.\n  Rule: Give recipients a copy of the license and ship the Tencent Hunyuan Notice file with redistributed weights.\n  License: https://huggingface.co/Tencent-Hunyuan/HunyuanDiT/blob/main/LICENSE.txt (checked 2026-10-25; details: https://agentgid.com/assets/hunyuandit/)",
  "agent_md": "https://agentgid.com/assets/hunyuandit/agent.md",
  "card_json": "https://agentgid.com/assets/hunyuandit/card.json"
 },
 "popularity": {
  "gid_score": 24,
  "stars": 4292,
  "downloads_7d": null,
  "downloads_7d_label": null,
  "downloads_change_4w_pct": null,
  "eco": null,
  "package": null,
  "repo": "Tencent-Hunyuan/HunyuanDiT",
  "agent_projects": null,
  "agent_projects_total": null,
  "downloads_unconfirmed": false,
  "series": {
   "downloads_weekly": [],
   "stars": [
    [
     "2026-11-07",
     4290
    ],
    [
     "2026-11-08",
     4290
    ],
    [
     "2026-11-09",
     4289
    ],
    [
     "2026-11-10",
     4289
    ],
    [
     "2026-11-11",
     4289
    ],
    [
     "2026-11-12",
     4289
    ],
    [
     "2026-11-13",
     4290
    ],
    [
     "2026-11-14",
     4290
    ],
    [
     "2026-11-15",
     4290
    ],
    [
     "2026-11-16",
     4290
    ],
    [
     "2026-11-17",
     4290
    ],
    [
     "2026-11-18",
     4291
    ],
    [
     "2026-11-19",
     4292
    ]
   ]
  },
  "stars_flat_since": null,
  "updated_at": "2026-11-19"
 },
 "alternatives": [
  {
   "slug": "hunyuandit",
   "name": "HunyuanDiT",
   "why": null,
   "current": true,
   "price": "Free",
   "commercial": {
    "value": "With conditions",
    "status": "cond"
   },
   "access": "Download"
  },
  {
   "slug": "sdxl",
   "name": "Stable Diffusion XL base 1.0",
   "why": "Pick Stable Diffusion XL for a widely used open image model with a large add-on ecosystem; it works alone or with its refiner.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "With conditions",
    "status": "cond"
   },
   "access": "Download"
  },
  {
   "slug": "flux-1-dev",
   "name": "FLUX.1 [dev]",
   "why": "Pick FLUX.1 [dev] for an open-weight model from Black Forest Labs; it is free only for non-commercial use.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Non-commercial",
    "status": "no"
   },
   "access": "Download"
  },
  {
   "slug": "z-image-turbo",
   "name": "Z-Image-Turbo",
   "why": "Pick Z-Image-Turbo for an efficient open-weights image model built on a single-stream diffusion transformer.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "Download"
  },
  {
   "slug": "invokeai",
   "name": "InvokeAI",
   "why": "Free open-source, self-hosted AI image generation app with a layer-based canvas and node-based workflows.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "Commercial OK",
    "status": "yes"
   },
   "access": "Download"
  },
  {
   "slug": "if",
   "name": "DeepFloyd IF",
   "why": "Open-source text-to-image diffusion model with a T5 text encoder and three cascaded stages, producing up to 1024x1024 px images.",
   "current": false,
   "price": "Free",
   "commercial": {
    "value": "With conditions",
    "status": "cond"
   },
   "access": "PyPI"
  }
 ],
 "faq": [
  {
   "q": "Can I use the pictures in a paid product?",
   "a": "Yes. Tencent claims no rights in the pictures you make, and commercial use is allowed below 100 million monthly users, if you follow the usage rules."
  },
  {
   "q": "Does it understand English prompts?",
   "a": "Yes. It reads both Chinese and English; its strength is fine detail in Chinese prompts."
  },
  {
   "q": "Will it run on a smaller graphics card?",
   "a": "The makers released scripts for cards with 6 GB of memory; the standard setup needs 11 GB."
  },
  {
   "q": "Can I use it in the European Union?",
   "a": "Unclear. The license in the GitHub code repository excludes the EU, but the license files on the v1.0 and v1.2 model pages have no such clause."
  }
 ],
 "at_a_glance": {
  "latest_version": "0.42.1 (latest checked; the makers ask for 0.28.1 or newer)",
  "last_commit": "2026-10-08",
  "runtime": "Python 3.11+ for diffusers 0.42.1, PyTorch 2.0+, an NVIDIA GPU with 11 GB or more (32 GB with the DialogGen helper); tested on Linux",
  "key_needed": false
 },
 "good_to_know": [
  "It needs an NVIDIA graphics card with at least 11 GB of memory; the chat helper model raises that to 32 GB. Tencent tested it only on Linux.",
  "The license file published with the code on GitHub excludes the European Union, while the files on the model pages do not. Check with a lawyer before any use in the EU.",
  "The usage rules forbid posting its pictures publicly without clearly saying they are machine-made, and forbid copying real people without consent.",
  "This page's model is the first release from May 2024. Newer versions 1.1 and 1.2 sit in separate model pages.",
  "Pictures or results from it may not be used to improve another large language model."
 ],
 "stack_snippets": [],
 "claims": [
  "SDXL scored 42.7 overall in the makers' own human review",
  "Hunyuan-DiT scores 59.0 overall in that review",
  "The distilled version is about 50% faster on NVIDIA cards"
 ],
 "checked": {
  "license_read": "2026-10-25",
  "overview_checked": "2026-11-12",
  "numbers_updated": "2026-11-19",
  "sources": [
   {
    "label": "huggingface.co/Tencent-Hunyuan/HunyuanDiT",
    "url": "https://huggingface.co/Tencent-Hunyuan/HunyuanDiT"
   },
   {
    "label": "huggingface.co",
    "url": "https://huggingface.co/Tencent-Hunyuan/HunyuanDiT/raw/main/README.md"
   },
   {
    "label": "huggingface.co",
    "url": "https://huggingface.co/Tencent-Hunyuan/HunyuanDiT/raw/main/LICENSE.txt"
   },
   {
    "label": "huggingface.co",
    "url": "https://huggingface.co/Tencent-Hunyuan/HunyuanDiT/raw/main/Notice"
   },
   {
    "label": "huggingface.co",
    "url": "https://huggingface.co/Tencent-Hunyuan/HunyuanDiT-v1.2/raw/main/LICENSE.txt"
   },
   {
    "label": "huggingface.co",
    "url": "https://huggingface.co/api/models/Tencent-Hunyuan/HunyuanDiT"
   },
   {
    "label": "github.com/Tencent-Hunyuan/HunyuanDiT",
    "url": "https://github.com/Tencent-Hunyuan/HunyuanDiT"
   },
   {
    "label": "README on GitHub",
    "url": "https://github.com/Tencent-Hunyuan/HunyuanDiT/blob/main/README.md"
   },
   {
    "label": "github.com/Tencent-Hunyuan/HunyuanDiT/blob/main/LICENSE.txt",
    "url": "https://github.com/Tencent-Hunyuan/HunyuanDiT/blob/main/LICENSE.txt"
   },
   {
    "label": "pypi.org/pypi/diffusers/json",
    "url": "https://pypi.org/pypi/diffusers/json"
   },
   {
    "label": "raw.githubusercontent.com",
    "url": "https://raw.githubusercontent.com/huggingface/diffusers/v0.42.1/src/diffusers/pipelines/hunyuandit/pipeline_hunyuandit.py"
   },
   {
    "label": "huggingface.co",
    "url": "https://huggingface.co/Tencent-Hunyuan/HunyuanDiT/blob/main/LICENSE.txt"
   }
  ],
  "unverified": "The Hugging Face API reports 0 downloads for this repo (its weights sit in a t2i/ subfolder, which the counter may not track). This repo holds the original v1.0 release; later versions are published in separate repos."
 },
 "user_reports": null,
 "url": "https://agentgid.com/assets/hunyuandit/",
 "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."
}
