Übersicht Dokumentation Showcase Download

Dokumentation

Installation

DMG-Installer

DMG von der Release-Seite herunterladen (~12 GB, enthält Modellgewichte). Öffnen und Z-Image.app in den Programme-Ordner ziehen.

Das CLI-Tool ist im App-Bundle enthalten:

# Zum PATH hinzufügen (optional)
ln -s /Applications/Z-Image.app/Contents/MacOS/txt2zimage /usr/local/bin/txt2zimage

Aus dem Quellcode bauen

git clone https://gitlab.com/mlc0911-group/txt2zimage.git
cd txt2zimage
task build

Erfordert Go 1.21+, Task und die MLX-Bibliotheken (werden automatisch gebaut).

Schnellstart — Desktop-App

  1. Z-Image.app starten
  2. Prompt ins Textfeld eingeben
  3. Seitenverhältnis wählen (1:1, 4:3, 16:9, …)
  4. Generate klicken
  5. Schritt-für-Schritt-Fortschritt beobachten — das Bild erscheint in Sekunden

Tipps für bessere Ergebnisse

  • Detailliert beschreiben: "eine Tabby-Katze auf einem Holztisch, Studiolicht, geringe Schärfentiefe" funktioniert besser als "Katze"
  • Das Seed-Feld verwenden um ein gelungenes Ergebnis zu reproduzieren
  • Mit 9 Steps starten (Standard) — auf 12–15 erhöhen für mehr Details
  • Höhere Auflösungen (1536+) benötigen 24 GB+ RAM

Schnellstart — CLI

# Einfache Generierung
txt2zimage -p "ein roter Fuchs im Schnee" -o fuchs.png

# Eigene Auflösung
txt2zimage -p "Panorama-Bergansicht" -w 1920 -h 1080 -o panorama.png

# Mehr Steps für höhere Qualität
txt2zimage -p "detailliertes Porträt" -s 15 --seed 42 -o portrait.png

# Residenten Server für schnellere Generierung nutzen
txt2zimage serve &          # Server im Hintergrund starten
txt2zimage -p "Prompt" -o ergebnis.png   # verbindet automatisch

Modelle

Modell Parameter Größe Steps Beschreibung
z-image-turbo 10,3 Mrd. ~12 GB (FP8) 9 Standard — schnell, hohe Qualität
mlczimage 10,3 Mrd. + LoKr ~12 GB 9 Experimentell — verbesserte Seed-Vielfalt

Modelle werden in ~/.txt2zimage/models/ gespeichert und beim ersten Aufruf automatisch von HuggingFace heruntergeladen.

TeaCache

TeaCache ist standardmäßig aktiviert. Es cached Zwischen-Ergebnisse der Denoising-Schritte und überspringt ~4 von 9 Steps wenn möglich — etwa 2x schnellere Generierung bei minimalem Qualitätsverlust. Mit --no-teacache deaktivieren für maximale Qualität.

PNG-Metadaten

Jedes generierte Bild bettet seine Generierungsparameter in die PNG tEXt-Chunks ein: Prompt, Seed, Steps, Auflösung, Modellname und TeaCache-Status. Damit kann man jederzeit nachschauen wie ein Bild erstellt wurde und es reproduzieren.