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** → the prompt generates a new image (routes to [Mage-Flow-Turbo](https://huggingface.co/microsoft/Mage-Flow-Turbo)).
- **With an uploaded image** → the prompt is treated as an edit instruction (routes to [Mage-Flow-Edit-Turbo](https://huggingface.co/microsoft/Mage-Flow-Edit-Turbo)).

The demo uses the Turbo variants for fast, few-step inference (4 steps, CFG 1.0).

## Usage

1. Enter a prompt.
2. *(Optional)* Upload an image to edit — the prompt becomes an edit instruction.
3. 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: [microsoft/Mage-Flow-Turbo](https://huggingface.co/microsoft/Mage-Flow-Turbo), [microsoft/Mage-Flow-Edit-Turbo](https://huggingface.co/microsoft/Mage-Flow-Edit-Turbo)