LibreAI / Image / HunyuanImage-3.0
// image · Tencent-Hunyuan/HunyuanImage-3.0

HunyuanImage-3.0

Tencent's HunyuanImage-3.0 — a powerful native multimodal model for image generation.

★ 3.3k stars⑂ 191 forksNOASSERTIONupdated 2026-06
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

HunyuanImage-3.0 is an open-source image project by Tencent-Hunyuan (Tencent-Hunyuan/HunyuanImage-3.0 on GitHub). It has 3,284 GitHub stars and 191 forks, is released under the NOASSERTION license, and was last updated on GitHub on 23 June 2026.

GitHub stars
3,284
Forks
191
License
NOASSERTION
Last updated on GitHub
23 June 2026
Category
Image
Listing
Full install guide
Official site
Official site
// how it works

How it works

  1. Clarify your goal

    Decide the first concrete outcome you want from it, so you can pick the right example, template or mode instead of exploring everything at once.

  2. Get the project

    Clone the repository (or install the published package) and skim its README quick start for the requirements for your platform.

  3. Install and configure

    Run the documented install step and set any required configuration — such as provider keys, data sources or local services — before the first run.

  4. Run your first task

    Execute the smallest documented example end to end, confirm the output is what you expected, then adapt it to your real data or workflow.

// features

Why people love it

Native multimodal generation

A single model architecture designed natively for text-to-image generation.

Instruct with reasoning

HunyuanImage-3.0-Instruct enhances prompts intelligently and supports image-to-image editing and multi-image fusion.

Distilled fast checkpoint

The Instruct-Distil checkpoint is recommended at 8 sampling steps for efficient deployment.

Transformers quick start

Load weights with Transformers (renaming the folder to avoid dots, as the README notes) and generate in a few lines.

vLLM acceleration

A documented vLLM path significantly speeds up inference serving.

Gradio demo

An interactive Gradio demo is included for local experimentation.

Advertisement
// run it

Run it yourself

  1. Clone the repository

    Get the source so you can inspect, configure and run it locally.

    git clone https://github.com/Tencent-Hunyuan/HunyuanImage-3.0.git
    cd HunyuanImage-3.0
  2. Install dependencies

    Install PyTorch (CUDA 12.8), the other requirements, and optionally FlashInfer for optimised MoE inference.

    pip install torch==2.8.0 torchvision==0.23.0 torchaudio==2.8.0 --index-url https://download.pytorch.org/whl/cu128
    pip install -r requirements.txt
    pip install flashinfer-python==0.5.0  # optional
  3. Download weights and run a demo

    Fetch the Instruct weights from Hugging Face, rename the directory (no dots), then run the repo demo scripts.

    hf download tencent/HunyuanImage-3.0-Instruct --local-dir ./HunyuanImage-3-Instruct
    # then run the demo — see README: run_demo_instruct.sh
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains HunyuanImage-3.0?

It is maintained by Tencent-Hunyuan on GitHub (Tencent-Hunyuan/HunyuanImage-3.0), where the source, issues and releases live.

Is it free to use?

No clear licence was identified from the repo metadata or README, so check the repository's licence file before relying on it commercially.

Does it need a paid API key?

No API key for local inference — you download the open weights and run them on substantial GPU hardware; the optional Tencent Cloud prompt-enhancement uses that cloud account.

How does it compare to hosted image APIs such as Midjourney or DALL-E?

Compared with hosted image APIs such as Midjourney or DALL-E, HunyuanImage-3.0's distinguishing focus is: tencent's HunyuanImage-3.0 — a powerful native multimodal model for image generation. Pick it when that focus matches your need; the alternative may suit you better if its broader or different scope is the priority.

How do I get started?

Clone https://github.com/Tencent-Hunyuan/HunyuanImage-3.0 (or install its published package), follow the README quick start to install and configure it, then run the smallest documented example — the Run section on this page mirrors those steps.

// keep exploring

Similar tools

Image

Bagel

ByteDance's open-source unified multimodal model for understanding, generation and image editing.

★ 6.2k starsApache-2.0
View guide →
Image

OmniGen

OmniGen: one unified model for text-to-image, editing, subject-driven and identity-preserving generation

★ 4.3k starsMIT
View guide →
Image

pydantic-ai

How Python does AI. Agents, realtime voice, image generation, embeddings. Every model, every interface, typed end to end.

★ 20.4k starsMIT
View guide →
Image

flux

Black Forest Labs' official inference repo for the FLUX.1 image generation models

★ 26.0k starsApache-2.0
View guide →
Image

awesome-nano-banana-pro-prompts

🍌 World's largest Nano Banana Pro prompt library — 10,000+ curated prompts with preview images, 16 languages. Google Gemini AI image generation. Free & open …

★ 13.5k starsUnknown
View guide →
Image

LLM-Hub

Run LLMs plus image, video and music generation locally on your phone

★ 603 starsCustom
View guide →
// alternatives

Alternatives in Image

The most-starred other Image projects in the LibreAI catalogue — the realistic shortlist if HunyuanImage-3.0 is not the right fit.

Get HunyuanImage-3.0

Free and open — grab the source, star the repo, and start creating.