Z Image

Z Image

A Gradio app built around the Z-Image model from Tongyi-MAI, which you try in the browser with nothing to install. Suits people who want to test the model or read the app's code.

Made by Tongyi-MAI on Hugging Face. These notes are Mindket's, written from its Space page and README; the app's own files and license are on Hugging Face.

About

What it is: This Space is a Gradio app built around the Z-Image model from Tongyi-MAI. Its record also names a second model repository, zerogpu-aoti/Z-Image. You open it in a browser and it runs on Hugging Face's zero-a10g hardware.

Who it suits: People who want to try the Z-Image model without installing anything, and developers who want a small Gradio app to read before building their own.

Industry | Who uses it | How they use it | Example
Design | Designers | Try the model on a quick idea before choosing a tool | Opening the page and seeing what the model gives back
Software | Developers | Read how a Gradio app is laid out | Looking through app.py, pe.py and prompt_check.py
Research | AI hobbyists | Test a Tongyi-MAI model in the browser | Spending a few minutes on the page and noting what it does

You can skip it if you want a finished product, because the source gives only the Space and a local copy.

Where to use it:

• A web browser, on the Space's own page at Hugging Face
• Windows, macOS or Linux with Python, as a copy on your own computer
• The Space carries an MCP tag, but the source gives no MCP setup

Use case | Who | What they get back
Trying the model online | Anyone curious about Z-Image | Whatever the page returns for what they enter
Reading the code | Developers | A look at how the app and its helper files fit together

How to set it up:

• A browser, if you only use the Space online
• Python and pip, if you run a copy yourself

1. Open the Space's page on Hugging Face to use it online. Nothing needs installing.
2. For a local copy, install the huggingface_hub package and download the Space's files.
3. Move into the new folder, then install Gradio and the packages in requirements.txt.
4. Start the app with python.

pip install -U huggingface_hub
hf download Tongyi-MAI/Z-Image --repo-type space --local-dir Z-Image
cd Z-Image
pip install gradio==6.0.1
pip install -r requirements.txt

How to use it: Open the Space's page and work with the controls it shows. On your own computer, start the app first, then open the page it serves in your browser.

python app.py

Tool | What it does
python app.py | Starts the app on your own computer

Example: You start the app with the python command, open the page it serves and try the model there. What you see depends on the Z-Image model and on what you enter.

For newcomers and experts: If you are new to this, open the Space page and try one small thing in it. Watch what comes back before you change anything else.

The repository is small, with app.py as the main file beside pe.py, prompt_check.py and one image file. On Hugging Face the Space runs on zero-a10g hardware. The source does not say what hardware a local copy needs, so check that before you download the model.

Open the Space or run python app.py
Use the page it shows
The app calls the Z-Image model
The result appears on the page

Good to know:

• Built with Gradio 6.0.1, and the main file is app.py
• License: apache-2
• Cost to run: none named
• Data it reaches: none named

On Hugging Face, 13 November 2026

• Likes: 187
• Built with: gradio
• License: apache-2.0

Links

• Space: https://huggingface.co/spaces/Tongyi-MAI/Z-Image
• Files: https://huggingface.co/spaces/Tongyi-MAI/Z-Image/tree/main

Try it

Open the Space in your browser, or copy it to your own Hugging Face account from its page. Nothing in this kit runs by itself.