Instructions to use StabilityLabs/Stable-Layers with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- PEFT
How to use StabilityLabs/Stable-Layers with PEFT:
Task type is invalid.
- Notebooks
- Google Colab
- Kaggle
Update README.md
Browse files
README.md
CHANGED
|
@@ -1,19 +1,14 @@
|
|
| 1 |
-
#
|
| 2 |
|
| 3 |
Decomposes an image into ordered layers (background + separated objects) using
|
| 4 |
**Qwen-Image-Layered** with a GRPO-trained LoRA.
|
| 5 |
|
| 6 |
---
|
| 7 |
|
| 8 |
-
##
|
| 9 |
|
| 10 |
> ### **Heun sampler · 50 steps · CFG 1.0 · 640 px · 4 layers**
|
| 11 |
|
| 12 |
-
These are the settings every published result was produced with, and they are
|
| 13 |
-
the **defaults** in `decompose.py`. If you override them the script prints a
|
| 14 |
-
warning — lowering the step count or raising CFG visibly degrades the
|
| 15 |
-
decomposition (blurrier background inpainting, mushier layer boundaries).
|
| 16 |
-
|
| 17 |
| Setting | Value | Flag |
|
| 18 |
|---|---|---|
|
| 19 |
| **Sampler** | **Heun (2nd order)** | always used — not configurable |
|
|
@@ -22,9 +17,7 @@ decomposition (blurrier background inpainting, mushier layer boundaries).
|
|
| 22 |
| Resolution | 640 px (max dim) | `--size 640` |
|
| 23 |
| Layers | 4 | `--num-layers 4` |
|
| 24 |
|
| 25 |
-
**Note:**
|
| 26 |
-
each step runs two forward passes. That is by design; don't "optimise" it by
|
| 27 |
-
halving the steps.
|
| 28 |
|
| 29 |
---
|
| 30 |
|
|
@@ -45,19 +38,6 @@ Requires **one GPU** — the base model is ~40 GB in bf16, so an 80 GB-class car
|
|
| 45 |
The base model is pulled from HuggingFace automatically
|
| 46 |
(`Qwen/Qwen-Image-Layered`). You supply the LoRA adapter:
|
| 47 |
|
| 48 |
-
```
|
| 49 |
-
checkpoint-600/
|
| 50 |
-
adapter_config.json
|
| 51 |
-
adapter_model.safetensors # ~316 MB
|
| 52 |
-
```
|
| 53 |
-
|
| 54 |
-
By default `decompose.py` looks for `checkpoint-600/` next to the script; point
|
| 55 |
-
elsewhere with `--lora /path/to/adapter`.
|
| 56 |
-
|
| 57 |
-
> **The LoRA is ~316 MB, which exceeds GitHub's 100 MB per-file limit.** Don't
|
| 58 |
-
> commit it directly — use Git LFS, or host it (e.g. on the HuggingFace Hub) and
|
| 59 |
-
> download it alongside this script.
|
| 60 |
-
|
| 61 |
---
|
| 62 |
|
| 63 |
## Usage
|
|
|
|
| 1 |
+
# Stable Layers — Inference
|
| 2 |
|
| 3 |
Decomposes an image into ordered layers (background + separated objects) using
|
| 4 |
**Qwen-Image-Layered** with a GRPO-trained LoRA.
|
| 5 |
|
| 6 |
---
|
| 7 |
|
| 8 |
+
## Recommended inference settings
|
| 9 |
|
| 10 |
> ### **Heun sampler · 50 steps · CFG 1.0 · 640 px · 4 layers**
|
| 11 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 12 |
| Setting | Value | Flag |
|
| 13 |
|---|---|---|
|
| 14 |
| **Sampler** | **Heun (2nd order)** | always used — not configurable |
|
|
|
|
| 17 |
| Resolution | 640 px (max dim) | `--size 640` |
|
| 18 |
| Layers | 4 | `--num-layers 4` |
|
| 19 |
|
| 20 |
+
**Note:** with using a high resolution or lower steps or not heun will garble the results.
|
|
|
|
|
|
|
| 21 |
|
| 22 |
---
|
| 23 |
|
|
|
|
| 38 |
The base model is pulled from HuggingFace automatically
|
| 39 |
(`Qwen/Qwen-Image-Layered`). You supply the LoRA adapter:
|
| 40 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 41 |
---
|
| 42 |
|
| 43 |
## Usage
|