README.md

---
title: Mage-Flow
emoji: 🎨
colorFrom: green
colorTo: purple
sdk: gradio
sdk_version: 6.15.1
app_file: app.py
short_description: Efficient native-resolution image generation and editing
python_version: "3.12"
startup_duration_timeout: 30m
---

# Mage-Flow

Efficient Native-Resolution Foundation Model for Image Generation and Editing.

This Space demonstrates [Mage-Flow](https://huggingface.co/papers/2607.19064) from Microsoft, a 4B-scale image generation and editing foundation model through a single unified interface:

- **No image** → text-to-image generation.
- **With an uploaded image** → instruction-based image editing.

Choose **Mage-Flow-Turbo · Fast** (4 steps, CFG 1.0) or **Mage-Flow · Quality**. The quality variant uses 20 steps / CFG 5.0 for generation and 30 steps / CFG 5.0 for editing; uploading or removing an image updates these defaults automatically.

## Usage

1. Enter a prompt.
2. *(Optional)* Upload an image to edit — the prompt becomes an edit instruction.
3. Choose Fast or Quality, then click **Run**.

## References

- Paper: [Mage-Flow: An Efficient Native-Resolution Foundation Model for Image Generation and Editing](https://huggingface.co/papers/2607.19064)
- GitHub: [microsoft/Mage](https://github.com/microsoft/Mage)
- Models: [Mage-Flow](https://huggingface.co/microsoft/Mage-Flow), [Mage-Flow-Turbo](https://huggingface.co/microsoft/Mage-Flow-Turbo), [Mage-Flow-Edit](https://huggingface.co/microsoft/Mage-Flow-Edit), [Mage-Flow-Edit-Turbo](https://huggingface.co/microsoft/Mage-Flow-Edit-Turbo)