README.md

---
title: Dispatch AI — Wallpaper Engine
emoji: 🎨
colorFrom: blue
colorTo: indigo
sdk: gradio
sdk_version: "4.44.1"
app_file: app.py
pinned: true
license: mit
tags:
  - wallpaper
  - flux
  - image-generation
  - dispatch-ai
  - phone
---

# Dispatch AI — Wallpaper Engine 🎨

A Gradio app that generates phone wallpapers using **FLUX.1-schnell** via the HuggingFace Inference API.

Built by **Dispatch AI (FZE)** — UAE · License 10818.

## Features

- ✍️ **Text prompt input** — describe your dream wallpaper
- 📐 **Aspect ratio selector** — 9:16 (phone), HD phone, 1:1 (square), 16:9 (wide), 4:5 (portrait)
- 🎚️ **Inference steps slider** — schnell works well at 4 steps
- 🎨 **One-click presets**:
  - UAE Sunset
  - Cyberpunk City
  - Minimal Dark
  - Arabic Calligraphy
  - Desert Stars
  - Dubai Skyline
  - Ocean Waves
  - Mountain Peak
  - Abstract Neon
  - Falcon Majesty
- ⬇️ **Download button** — save your wallpaper as PNG
- 🌙 **Dark theme** (#0A0F1A bg, #1FE0E6 cyan accent)

## Model

`black-forest-labs/FLUX.1-schnell` — a fast, 4-step distilled flow-matching model optimized for low-step image generation.

## Setup

1. Set your HuggingFace token as a Space secret named `HF_TOKEN`.
2. The app reads `HF_TOKEN` from the environment automatically.

## Usage

1. Type a prompt OR pick a preset and click **Load Preset**.
2. Choose your aspect ratio (default: 9:16 for phones).
3. Adjust inference steps if desired.
4. Click **Generate Wallpaper**.
5. Download the PNG.

## License

MIT — Dispatch AI (FZE).