Skip to content

beausterling/z-fast

Β 
Β 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

29 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

⚑️ Z-Image
Ultra-Fast Local AI Image Generation

Official Site Desktop App Landing Page Web App

Fast. Private. Free. Open Source.

This repository contains three ways to use Z-Image-Turbo:

  1. πŸ–₯️ Desktop App - Native macOS/Windows/Linux app (Tauri)
  2. 🌐 Web App - Browser-based interface (React + FastAPI)
  3. 🎨 Landing Page - Marketing site for the desktop app

πŸš€ Quick Links

For End Users

For Developers


πŸ–₯️ Desktop App (Recommended)

⚑ SUB-SECOND β€’ πŸ”’ 100% PRIVATE β€’ πŸ’° FREE FOREVER

Native desktop application for macOS, Windows, and Linux.

Features

  • ⚑ 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

Quick Start

cd desktop-app
npm install
npm run tauri:dev

Full Desktop App Documentation β†’


🌐 Web App

Browser-based interface with cloud deployment options.

Features

  • 🎨 Neo-brutalist design
  • ⚑ Optimized for speed
  • πŸ“± Responsive (mobile, tablet, desktop)
  • πŸš€ Easy deployment (Netlify, Vercel, etc.)

Quick Start

Backend:

cd web-app/backend
pip install -r requirements.txt
python main.py

Frontend:

cd web-app/frontend
npm install
npm run dev

Full Web App Documentation β†’

Deployment Guide β†’


🎨 Landing Page

High-converting marketing page for the desktop app.

Bold neo-brutalist design that emphasizes speed, privacy, and zero cost.

Quick Start

cd landing-page
npm install
npm run dev

Deploy to Netlify

  1. Push to GitHub
  2. Connect to Netlify
  3. Configure: Base directory: landing-page, Build: npm run build, Publish: landing-page/dist

Landing Page Documentation β†’


πŸ“Š Comparison

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

🎯 Which One to Use?

Use Desktop App if you want:

  • βœ… Maximum speed and privacy
  • βœ… No server setup/hosting
  • βœ… Native app experience
  • βœ… Offline usage after model download

Use Web App if you want:

  • βœ… Share with others (deploy to cloud)
  • βœ… No local installation required
  • βœ… Access from any device
  • βœ… Custom branding/styling

Use Original Python if you want:

  • βœ… Integrate into your own code
  • βœ… Batch processing
  • βœ… Custom workflows
  • βœ… Maximum control

⚑️ Original Z-Image Documentation

Z-Image is a powerful and highly efficient image generation model with 6B parameters.

Model Variants

  • πŸš€ 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 Zoo

Model Hugging Face ModelScope
Z-Image-Turbo HF MS

Original Quick Start

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")

Key Papers

  • Z-Image: arXiv
  • Decoupled-DMD: arXiv
  • DMDR: arXiv

Community Works


πŸ—οΈ Tech Stack

Desktop App

  • Tauri - Lightweight native app framework (Rust)
  • React - UI framework
  • Python - ML inference backend
  • PyTorch - ML framework
  • FastAPI - Backend API

Web App

  • React - Frontend framework
  • Vite - Build tool
  • FastAPI - Backend API
  • Diffusers - Hugging Face pipelines

Landing Page

  • React - UI framework
  • Vite - Build tool
  • Netlify - Deployment

πŸ“‹ System Requirements

Recommended

  • 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+

Minimum

  • 8GB RAM (slower, ~5-10s per image)
  • CPU only (no GPU required but much slower)

🀝 Contributing

Contributions welcome! Please:

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Submit a pull request

πŸ“œ License

This project follows the Z-Image repository license.


πŸ™ Credits

  • 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

πŸ†˜ Support


Built for speed. Designed for privacy. Made with love.

βš‘πŸ”’β€οΈ

Star History

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • JavaScript 53.2%
  • CSS 23.3%
  • Python 12.4%
  • Rust 5.2%
  • HTML 3.0%
  • Shell 2.9%