Fast. Private. Free. Open Source.
This repository contains three ways to use Z-Image-Turbo:
- π₯οΈ Desktop App - Native macOS/Windows/Linux app (Tauri)
- π Web App - Browser-based interface (React + FastAPI)
- π¨ Landing Page - Marketing site for the desktop app
- Desktop App β - Download and run locally (recommended)
- Landing Page β - Learn more about Z-Image
- Web App β - Deploy your own web version
- Original Z-Image Docs - Model information
Native desktop application for macOS, Windows, and Linux.
- β‘ Blazing fast - Generate 1024x1024 images in <1 second
- π Completely private - All processing local, no cloud
- π Mac optimized - Native Apple Silicon support with Metal
- π¨ Professional quality - 6B parameter Z-Image-Turbo model
- π¦ Self-contained - Tauri desktop app with embedded Python backend
cd desktop-app
npm install
npm run tauri:devFull Desktop App Documentation β
Browser-based interface with cloud deployment options.
- π¨ Neo-brutalist design
- β‘ Optimized for speed
- π± Responsive (mobile, tablet, desktop)
- π Easy deployment (Netlify, Vercel, etc.)
Backend:
cd web-app/backend
pip install -r requirements.txt
python main.pyFrontend:
cd web-app/frontend
npm install
npm run devFull Web App Documentation β
High-converting marketing page for the desktop app.
Bold neo-brutalist design that emphasizes speed, privacy, and zero cost.
cd landing-page
npm install
npm run dev- Push to GitHub
- Connect to Netlify
- Configure: Base directory:
landing-page, Build:npm run build, Publish:landing-page/dist
Landing Page Documentation β
| Feature | Desktop App | Web App | Original Python |
|---|---|---|---|
| Speed | β‘β‘β‘ Sub-second | β‘β‘ Fast | β‘β‘β‘ Fast |
| Privacy | π 100% Local | βοΈ Depends on deployment | π 100% Local |
| Ease of Use | π¦ Install & run | π Access from browser | π» CLI |
| UI | π¨ Native app | π¨ Web interface | β None |
| Platform | macOS/Windows/Linux | Any with browser | Any with Python |
| Best For | Personal use | Sharing with others | Development |
- β Maximum speed and privacy
- β No server setup/hosting
- β Native app experience
- β Offline usage after model download
- β Share with others (deploy to cloud)
- β No local installation required
- β Access from any device
- β Custom branding/styling
- β Integrate into your own code
- β Batch processing
- β Custom workflows
- β Maximum control
Z-Image is a powerful and highly efficient image generation model with 6B parameters.
-
π Z-Image-Turbo β A distilled version that matches or exceeds leading competitors with only 8 NFEs (Number of Function Evaluations). It offers β‘οΈsub-second inference latencyβ‘οΈ on enterprise-grade H800 GPUs and fits comfortably within 16G VRAM consumer devices.
-
π§± Z-Image-Base β The non-distilled foundation model (coming soon)
-
βοΈ Z-Image-Edit β Fine-tuned for image editing tasks (coming soon)
| Model | Hugging Face | ModelScope |
|---|---|---|
| Z-Image-Turbo |
import torch
from diffusers import ZImagePipeline
pipe = ZImagePipeline.from_pretrained(
"Tongyi-MAI/Z-Image-Turbo",
torch_dtype=torch.bfloat16,
)
pipe.to("cuda") # or "mps" for Mac, "cpu" for CPU
image = pipe(
prompt="Your prompt here",
height=1024,
width=1024,
num_inference_steps=9,
guidance_scale=0.0,
).images[0]
image.save("output.png")- Cache-DiT - Inference acceleration with DBCache
- stable-diffusion.cpp - Pure C++ inference engine (4GB VRAM!)
- Tauri - Lightweight native app framework (Rust)
- React - UI framework
- Python - ML inference backend
- PyTorch - ML framework
- FastAPI - Backend API
- React - Frontend framework
- Vite - Build tool
- FastAPI - Backend API
- Diffusers - Hugging Face pipelines
- React - UI framework
- Vite - Build tool
- Netlify - Deployment
- macOS 10.13+ (Windows/Linux support for desktop app coming)
- 16GB+ RAM (unified memory on Apple Silicon)
- Apple Silicon (M1/M2/M3) or NVIDIA GPU
- 20GB free disk space
- Python 3.10+
- 8GB RAM (slower, ~5-10s per image)
- CPU only (no GPU required but much slower)
Contributions welcome! Please:
- Fork the repository
- Create a feature branch
- Make your changes
- Submit a pull request
This project follows the Z-Image repository license.
- Z-Image-Turbo by Tongyi-MAI
- Diffusers by Hugging Face
- Tauri for the desktop framework
- FastAPI by SebastiΓ‘n RamΓrez
- React by Meta
- All contributors to this project