Spaces:
Running on Zero
Running on Zero
| title: Viggle Turbo for Qwen-Image-2.1 | |
| emoji: ⚡ | |
| colorFrom: indigo | |
| colorTo: purple | |
| sdk: gradio | |
| sdk_version: 5.50.0 | |
| python_version: "3.12.12" | |
| app_file: app.py | |
| pinned: false | |
| license: other | |
| license_name: qwen-research | |
| license_link: ./LICENSE | |
| short_description: 6-step Qwen-Image-2.1, T2I + editing, vs-base comparison | |
| models: | |
| - Viggle/Qwen-Image-2.1-viggle-turbo | |
| - Qwen/Qwen-Image-2.1 | |
| tags: | |
| - text-to-image | |
| - image-editing | |
| - distillation | |
| # Hardware: this Space needs ZeroGPU, set in Space Settings. `suggested_hardware` is deliberately | |
| # unset, because the only ZeroGPU value the Hub metadata accepts is the legacy `zero-a10g`, and a | |
| # 24 GB A10G cannot hold this pipeline. `app.py` requests the 96 GB card with | |
| # @spaces.GPU(size="xlarge") (no VAE tiling). | |
| # Secrets: set HF_TOKEN (read scope) while Viggle/Qwen-Image-2.1-viggle-turbo is private. | |
| # `hf_oauth` is not needed: the app calls no user-scoped Hub API. | |
| # Viggle Turbo v0.3 — 6-step Qwen-Image-2.1 | |
| A distilled [Qwen-Image-2.1](https://huggingface.co/Qwen/Qwen-Image-2.1) that generates and edits images in | |
| **6 steps** with **no classifier-free guidance**, about **5× faster** than the 40-step base model. On most prompts it | |
| is hard to tell apart from the base model; small, dense text and complicated edits (multi-reference composition, face | |
| swaps, identity-preserving edits) can still fall short of it. | |
| **v0.3 (2026-09-29):** at 6 steps, less grain than v0.2.1 and a little softer on fine texture. We think 6 steps is | |
| close to its capacity: every further gain we found cost something elsewhere. The new **9-step** setting runs 7 turbo | |
| steps and lets the base model finish the last two: finer detail and small text right more often, at about 1.4–1.5× the | |
| time of 6 steps. | |
| Weights, numbers and ComfyUI workflows are on the | |
| [model card](https://huggingface.co/Viggle/Qwen-Image-2.1-viggle-turbo). | |
| **Generate:** leave **References** empty for text-to-image, or add one to six images for editing, composition or | |
| style transfer; the prompt refers to them as image 1, image 2, … in the order they were added. **Steps** runs from 3 | |
| to 9, 6 is the default. The **Examples** rows are pre-rendered by this exact app; clicking one loads its prompt, | |
| references, settings and seed. The reference photos `woman1/cat_window/bird.webp` and the three-reference prompt come | |
| from the [black-forest-labs/flux-klein-9b-kv](https://huggingface.co/spaces/black-forest-labs/flux-klein-9b-kv) Space; | |
| the `qwen_*` rows come from the [Qwen/Qwen-Image-2.1](https://huggingface.co/spaces/Qwen/Qwen-Image-2.1) Space. | |
| **Comparison** (no GPU needed): 32 of the 37 examples of the Qwen/Qwen-Image-2.1 Space, pre-rendered with this model | |
| and with the base model in 40 steps (same prompt, inputs and seed 42, prompt enhancement off, one sample each), in an | |
| image slider, plus Qwen's own API output where their Space ships one. | |
| ## Prompt enhancement | |
| **Enhance prompt**: **Auto** (default) rewrites prompts shorter than 30 tokens, **On** always rewrites, **Off** never | |
| does. The rewrite is done by DeepSeek V4.1 Flash through OpenRouter, prompted with shortened versions of the system | |
| prompts published with `Qwen/Qwen-Image-2.1-PE-T2I` / `-PE-I2I`. The rewritten prompt is shown under **Prompt sent to | |
| the model**; if the call fails, the original prompt is used. The rewrite can add things the request did not ask for, | |
| on-image text included, so switch it **Off** when the wording matters. | |
| **Privacy.** When enhancement runs, the prompt and the reference images (downscaled to at most 0.5 MP) are sent to | |
| OpenRouter and the provider it routes the request to; the request only allows providers that neither train on nor | |
| retain the data. With **Off**, nothing leaves the Space. | |
| ## Running it | |
| Environment: `LORA_FILE` (default the v0.3 r256 adapter; the v0.2.1 and v0.2 adapters in the model repo also work), | |
| `STUDENT_REPO`, `BASE_MODEL_ID`, `HF_TOKEN` (read scope, needed only while the model repo is private), | |
| `OPENROUTER_API_KEY` (prompt enhancement; without it every prompt is sent as written). The app needs ZeroGPU `xlarge` | |
| (96 GB): the largest calls do not fit on the 48 GB card untiled, and tiling the VAE breaks edits. | |
| ## License | |
| The base model is released under the [Qwen RESEARCH LICENSE AGREEMENT](./LICENSE) — **non-commercial: research or | |
| evaluation purposes only**. This distilled derivative and this demo inherit that restriction. Commercial use requires | |
| a separate license from Alibaba (`model-business@notice.qwencloud.com`). See `NOTICE` for the required attribution. | |
| > Qwen is licensed under the Qwen RESEARCH LICENSE AGREEMENT, Copyright (c) 2026 Hangzhou Tongyi | |
| > Laboratory Technology Co., Ltd. All Rights Reserved. | |