Skip to content

docs(z-image) add Z-Image requirements and starter bundle #8734

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
lstein merged 9 commits into from
Jan 4, 2026
+41 −15
Merged

docs(z-image) add Z-Image requirements and starter bundle #8734

Show file tree
Hide file tree
Changes from 2 commits
Commits
Show all changes
9 commits
Select commit Hold shift + click to select a range
9f15156
docs(z-image) add minimum requirements for Z-Image and create Z-Image…
lstein Jan 3, 2026
a062de4
Merge branch 'main' into lstein/docs/zimage-docs
lstein Jan 3, 2026
2620ab2
fix(model manager) add flux VAE to Z-Image bundle
lstein Jan 3, 2026
c986cd6
docs(model manager) remove out-of-date model info link
lstein Jan 4, 2026
d943413
chore: fix frontendchecks
lstein Jan 4, 2026
5bdb5af
chore: lint:prettier
lstein Jan 4, 2026
86a42fd
docs(model manager): clarify minimum hardware for z-image turbo
lstein Jan 4, 2026
6a089e0
Merge branch 'main' into lstein/docs/zimage-docs
lstein Jan 4, 2026
2f57062
(fix) add flux VAE to ZIT starter dependencies & tweak UI docs
lstein Jan 4, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 6 additions & 0 deletions docs/installation/quick_start.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -31,6 +31,12 @@ Hardware requirements vary significantly depending on model and image output siz
- Memory: At least 32GB RAM.
- Disk: 10GB for base installation plus 200GB for models.

=== "Z-Image Turbo - 1024x1024"
- GPU: Nvidia 20xx series or later, 8GB+ VRAM.
- Memory: At least 16GB RAM.
- Disk: 10GB for base installation plus 35GB for models.


More detail on system requirements can be found [here](./requirements.md).

## Step 2: Download and Set Up the Launcher
Expand Down
5 changes: 5 additions & 0 deletions docs/installation/requirements.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -31,6 +31,11 @@ The requirements below are rough guidelines for best performance. GPUs with less
- Memory: At least 32GB RAM.
- Disk: 10GB for base installation plus 200GB for models.

=== "Z-Image Turbo - 1024x1024"
- GPU: Nvidia 20xx series or later, 8GB+ VRAM.
- Memory: At least 16GB RAM.
- Disk: 10GB for base installation plus 35GB for models.

!!! info "`tmpfs` on Linux"

If your temporary directory is mounted as a `tmpfs`, ensure it has sufficient space.
Expand Down
8 changes: 8 additions & 0 deletions invokeai/backend/model_manager/starter_models.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -890,10 +890,18 @@ class StarterModelBundle(BaseModel):
flux_krea_quantized,
]

zimage_bundle: list[StarterModel] = [
z_image_turbo_quantized,
z_image_qwen3_encoder_quantized,
z_image_controlnet_union,
z_image_controlnet_tile,
]

STARTER_BUNDLES: dict[str, StarterModelBundle] = {
BaseModelType.StableDiffusion1: StarterModelBundle(name="Stable Diffusion 1.5", models=sd1_bundle),
BaseModelType.StableDiffusionXL: StarterModelBundle(name="SDXL", models=sdxl_bundle),
BaseModelType.Flux: StarterModelBundle(name="FLUX.1 dev", models=flux_bundle),
BaseModelType.ZImage: StarterModelBundle(name="Z-Image Turbo", models=zimage_bundle),
}

assert len(STARTER_MODELS) == len({m.source for m in STARTER_MODELS}), "Duplicate starter models"