File size: 29,404 Bytes

fa5b4fe

---
license: other
license_name: qwen-research
license_link: https://huggingface.co/Qwen/Qwen-Image-2.1/blob/main/LICENSE
base_model: Qwen/Qwen-Image-2.1
library_name: diffusers
pipeline_tag: image-to-image
tags:
  - qwen
  - qwen-image
  - image-editing
  - object-removal
  - inpainting
  - lora
  - distilled
  - few-step
  - pruna-ai
---
<!-- header start -->
<p align="center">
  <img src="assets/P-Q-Image-2.1-Remove-Object.png" width="800">
</p>
<!-- header end -->

<p align="center">
  <a href="https://github.com/PrunaAI/pruna">
    <img src="https://img.shields.io/badge/GitHub-PrunaAI-9334E9?style=plastic&logo=github&logoColor=white" alt="GitHub">
  </a>
  &nbsp;
  <a href="https://twitter.com/PrunaAI">
    <img src="https://img.shields.io/badge/Twitter%2FX-@PrunaAI-9334E9?style=plastic&logo=x&logoColor=white" alt="Twitter/X">
  </a>
  &nbsp;
  <a href="https://www.linkedin.com/company/pruna-ai">
    <img src="https://img.shields.io/badge/LinkedIn-PrunaAI-9334E9?style=plastic&logo=linkedin&logoColor=white" alt="LinkedIn">
  </a>
  &nbsp;
  <a href="https://discord.com/invite/JFQmtFKCjd">
    <img src="https://img.shields.io/badge/Discord-Join%20us-9334E9?style=plastic&logo=discord&logoColor=white" alt="Discord">
  </a>
  &nbsp;
  <a href="https://dashboard.pruna.ai/login?utm_source=huggingface&utm_medium=org_card&utm_campaign=hf_traffic">
    <img src="https://img.shields.io/badge/Performance%20Models-Try%20them%20now-9334E9?style=plastic&logo=data:image/svg%2bxml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSI0MTEiIGhlaWdodD0iNDc3IiBmaWxsPSJub25lIj48cGF0aCBmaWxsPSIjZmZmIiBkPSJNMjMuNzAzIDMwMC41MzJjLTEuODQyLS42NzQtNC4xNDItMS4wNTctNS43MDMtMi4wMjktMTIuNTU4LTcuODQ2LTguODM3LTI1LjE3MiA1LjI1NS0yOC4zNjFhLjY2LjY2IDAgMCAwIC4zNDgtLjIwMS42LjYgMCAwIDAgLjE1Ni0uMzZxNi40OS04MS45ODYgNjguNTc3LTEzNC42MjlhLjM0LjM0IDAgMCAwIC4wOTItLjEyNS4zMy4zMyAwIDAgMC0uMDI2LS4zLjMzLjMzIDAgMCAwLS4xMTItLjEwOGMtNC4xMTUtMi40OTctOC42NC00Ljc1LTEyLjM1My03LjQ0M2ExOTAgMTkwIDAgMCAxLTE4Ljc5NC0xNS41MjJjLTIuOTM2LTIuNzY4LTMuNzAzLTUuODkxLjU4LTcuNzdhLjUuNSAwIDAgMCAuMjgtLjYwOEM1MyA3NS45NSA0OC40MTcgNDguNTk5IDQ1LjUxOCAxOS42NXEtLjM5My0zLjg1Mi0uMjcxLTYuMzJhLjc1Ljc1IDAgMCAxIC4xMzQtLjQuNy43IDAgMCAxIC4zMjQtLjI1NXEyLjEwNC0uODQyIDUuODQ0LTEuNDMxYzU4LjExNC05LjEzNiAxMjcuMDA5IDguNDI1IDE0NC4zMDcgNzIuNjQ1cS4xMDMuMzY0LjE3OCAwIDUuMDk2LTI0LjA5NyA0LjYzOC00OC4xOTMtLjA0Ny0yLjc4NyAxLjg3OS00Ljc4OCAxMC40MDctMTAuOCAyNC43OTgtOC42ODdjNy40NzEgMS4wOTUgNy43NDIgNC42MzggNy4yMDkgMTEuMWEzMzQgMzM0IDAgMCAxLTExLjg4NCA2NC43MDYuMzg4LjM4OCAwIDAgMCAuMTgyLjQ0NC40LjQgMCAwIDAgLjE2NC4wNTFjOTIuNDIxIDguNDUzIDE1OC44NzUgNzkuNDg5IDE2NS4wODQgMTcxLjI3NGExIDEgMCAwIDAgLjEyOS40MjQuODMuODMgMCAwIDAgLjI5MS4yOTZjMy43NSAyLjE3IDYuMiAyLjIxNiA4Ljg1NSA2LjU5MiA1LjA2OCA4LjMzMiAxLjQ1IDIwLjQzMS04LjU5MyAyMi40N2ExLjcxIDEuNzEgMCAwIDAtMS4zNjUgMS40NjhxLTkuMTczIDc1LjM4My02NC43NjIgMTIzLjM3MWMtMjguNjIyIDI0LjcwNC02NS43NDQgMzkuNzQ5LTEwMy40NjQgNDIuMzMtMTAwLjM1OSA2Ljg2My0xODQuNDg2LTY1LjYyMi0xOTUuMDA1LTE2NS41N2EuOC44IDAgMCAwLS4xNTQtLjM5NS43NC43NCAwIDAgMC0uMzMzLS4yNU0xNTEuMzM4IDk3LjY0M2wxOS4wNjYgMTkuMzc1YS41LjUgMCAwIDAgLjE1LjEuNS41IDAgMCAwIC4xNzYuMDMxLjQzLjQzIDAgMCAwIC4zMTktLjE1cTEwLjg0Ny0xMi40NjUgNy40NDMtMjguMTU1Yy00LjUzNS0yMC44Ni0xOC41OTgtMzcuNjY0LTM3LjI3MS00OC4zODktMjEuMDY3LTEyLjY4OS00Ny44NjUtMTUuOTA1LTcyLjI4LTE0Ljg0cS0uNjE3LjAzLS4xNC40MjJsNjMuNDcyIDUzLjMyNmEuNC40IDAgMCAwIC4xNDQuMDcyLjM0LjM0IDAgMCAwIC4zMDEtLjA2OC4zLjMgMCAwIDAgLjA4OC0uMTI2IDQ3IDQ3IDAgMCAwIDMuMjgyLTEzLjA4MXEuMDIzLS4yMzMuMTI0LS40MzN0LjI2OC0uMzM0YzIuOTU1LTIuNDc4IDQuMTE1LjQ1OCA0LjY5NCAyLjg1MnEyLjMyIDkuNTM3LjE4NyAxOS4yNDRhMS40OCAxLjQ4IDAgMCAwIC40NCAxLjQwM3ptLTYuNTI2IDkuMjk1LTkuMDI0LTEwLjI3NmEuNy43IDAgMCAwLS4zNDMtLjIwNy44Ni44NiAwIDAgMC0uNDMzIDBxLTExLjY4IDMuMDIxLTIzLjExNC0uODIyYy01LjgxNi0zLjg1Mi0uNzU4LTUuNTE3IDIuNTktNS44MTZxNS45MTgtLjUzMyAxMS43MzUtMi41MDZhLjMuMyAwIDAgMCAuMTI3LS4wOC4zLjMgMCAwIDAgLjA3My0uMTMzLjM0LjM0IDAgMCAwIC4wMDEtLjE1NC4zNC4zNCAwIDAgMC0uMDctLjEzOGMtMTkuNDU5LTIxLjE1LTQwLjc2LTQwLjI0NS02Mi4yNzUtNTkuMjY0cS0uMzU2LS4zMTgtLjMxOC4xNWEzMDggMzA4IDAgMCAwIDguMzg3IDUxLjgwMmM0LjU5MiAxOC4zMDggMTMuNzU1IDM0LjE1NyAzMS44NDggNDEuODcycTI2LjI0NyAxMS4xODIgNTMuNzI5IDIuODMzYS41ODMuNTgzIDAgMCAwIC4yOTktLjg4OCAyMzUgMjM1IDAgMCAwLTEzLjIxMi0xNi4zNzNtNDUuMTI1IDQ5Ljc0NXEtMTIuNTk1IDEuMzE4LTIzLjQ0MS01LjU4M2MtMy4wNzctNC44OTkgMi4wNjYtOC41OTMgNS40NDItMTEuMTgzYS41ODQuNTg0IDAgMCAwIC4xODctLjcwMSA4LjQ2IDguNDYgMCAwIDAtMy40ODgtMy44NjIuODEuODEgMCAwIDAtLjgyMy4wMDljLTE2LjY5MSA5Ljk3Ny0zNC40ODUgMTAuNzgyLTUzLjE4NiA2Ljk2N3EtMS41Ny0uMzItMi44NTIuNjQ1LTYxLjQ1MSA0Ni4zNy02OS42NyAxMjMuOTEzLS42ODMgNi40MzMtMS44MDYgOC44MjdjLTIuOTQ1IDYuMzAyLTcuNzcgNy44NDUtMTQuMjIyIDkuNDcycS0uNDQ5LjExMyAwIC4yMzRjOS4yNzYgMi4zMSAxNC42OCA2LjE0MyAxNi4wNzQgMTYuNDAxIDguNDYyIDYyLjQ5IDQ4Ljk0IDExNy44NjQgMTEwLjM4MyAxMzguMzQxYTEwNCAxMDQgMCAwIDAgMTEuMDA2IDMuNTA3YzkyLjY0NSAyMy45MDkgMTgxLjIzMi0zMy42NjIgMjAyLjgwNC0xMjUuMDU0cTEuNjA5LTYuNzkgMy40NS0xOS4wODVjMS4xMDQtNy4zOTYgNS42OTUtMTIuMTE4IDEzLjE0Ny0xMy41NjguNDEyLS4wODQgMS45MDgtLjc1Ny4yODEtLjk5MS04LjA1MS0xLjE0MS0xMi4yNC02LjM4Ni0xMi45ODgtMTQuMTI4cS0xLjA3NS0xMS4yNS0yLjUxNi0xOS4wMzhjLTExLjc3Mi02My44OTItNTYuMzgzLTExNC41NzItMTE5LjI4NS0xMzEuNDZxLTE1LjEyLTMuODgtMzAuOTg3LTUuMjQ1YS4zODYuMzg2IDAgMCAwLS40MDIuMjUyIDE2OC42IDE2OC42IDAgMCAxLTExLjM1MiAyNC44NTRjLTQuMTMzIDcuNDA2LTguMTYzIDE1LjQ5NC0xNS43NTYgMTYuNDc2Ii8+PGNpcmNsZSBjeD0iMTQwLjA2NSIgY3k9IjI3My4wMyIgcj0iNTAuNjE4IiBzdHJva2U9IiNmZmYiIHN0cm9rZS13aWR0aD0iOS4yMDMiLz48cGF0aCBmaWxsPSIjZmZmIiBkPSJNMTQ2Ljk2NyAyNDIuMDkyYzE1LjY3MiAwIDI4LjM3NiAxMy45NjMgMjguMzc2IDMxLjE4OHMtMTIuNzA0IDMxLjE4OS0yOC4zNzYgMzEuMTg5LTI4LjM3Ny0xMy45NjQtMjguMzc3LTMxLjE4OWMwLTIuNjI1LjI5Ny01LjE3NC44NTItNy42MSAxLjYwNyAzLjcyNyA1LjMxMyA2LjMzOCA5LjYyOSA2LjMzOCA1Ljc4OSAwIDEwLjQ4MS00LjY5MyAxMC40ODItMTAuNDgycy00LjY5My0xMC40ODEtMTAuNDgyLTEwLjQ4MWMtLjc2MSAwLTEuNTA0LjA4My0yLjIxOS4yMzcgNS4xMzktNS42NzYgMTIuMjUzLTkuMTkgMjAuMTE1LTkuMTkiLz48Y2lyY2xlIGN4PSIyNjkuOTMyIiBjeT0iMjczLjAzIiByPSI1MC42MTgiIHN0cm9rZT0iI2ZmZiIgc3Ryb2tlLXdpZHRoPSI5LjIwMyIvPjxwYXRoIGZpbGw9IiNmZmYiIGQ9Ik0yNzYuODM0IDI0Mi4wOTJjMTUuNjcyIDAgMjguMzc2IDEzLjk2MyAyOC4zNzYgMzEuMTg4cy0xMi43MDQgMzEuMTg5LTI4LjM3NiAzMS4xODktMjguMzc3LTEzLjk2NC0yOC4zNzctMzEuMTg5YzAtMi42MjUuMjk3LTUuMTc0Ljg1My03LjYxIDEuNjA2IDMuNzI3IDUuMzEyIDYuMzM4IDkuNjI4IDYuMzM4IDUuNzg5IDAgMTAuNDgyLTQuNjkzIDEwLjQ4Mi0xMC40ODJzLTQuNjkzLTEwLjQ4MS0xMC40ODItMTAuNDgxYy0uNzYxIDAtMS41MDQuMDgzLTIuMjE5LjIzNyA1LjEzOS01LjY3NiAxMi4yNTQtOS4xOSAyMC4xMTUtOS4xOSIvPjxwYXRoIHN0cm9rZT0iI2ZmZiIgc3Ryb2tlLXdpZHRoPSI5LjIwMyIgZD0iTTE3Ny4xMzUgMzQ1LjMyOGMuODk5LS4yNCAyLjgwMS0uMTk3IDYuMzA0LjQ2NCA2LjMxMSAxLjE5IDE2LjU4NSA0LjIyMSAyNi4xMjIgNC4yMjEgOS40NTIgMCAxNy4xMTgtMS45MjYgMjEuMzgzLTIuNjAzLjc3LS4xMjMgMS4zODUtLjE5OSAxLjg3OC0uMjM3LS4zNCAxMy44NDMtMTIuODkzIDI3LjcxLTI3Ljg2OCAyNy43MS0xNS4xNzIgMC0yNy44NzYtMTMuODM1LTI3Ljg3Ni0yOC44MTEgMC0uMzU3LjAyOS0uNTk2LjA1Ny0uNzQ0WiIvPjwvc3ZnPg==" alt="Performance Models">
  </a>
</p>
<div align="center">

<h1 style="color: #9334E9;">⚡ P-Q-Image-2.1-Remove-Object</h1>

<h2>Object removal LoRAs for Qwen-Image-2.1 that leave the rest of the image untouched</h2>

<h3>
  <span style="color: #9334E9;">6 or 8 steps</span>
  &nbsp;·&nbsp;
  <span style="color: #9334E9;">No CFG</span>
  &nbsp;·&nbsp;
  <span style="color: #9334E9;">Rough masks</span>
  &nbsp;·&nbsp;
  Shadows and reflections go too
</h3>

</div>

**P-Q-Image-2.1-Remove-Object** is a set of LoRA adapters for
[`Qwen/Qwen-Image-2.1`](https://huggingface.co/Qwen/Qwen-Image-2.1) that **remove the object you point
at, and change nothing else**. Mark the object with a rough mask, drawn as a red outline on the photo,
and the LoRA replaces it with what would be behind it, along with its shadow or reflection. The rest of
the image stays as it was and lines up with the input, so the result can be used as is.

The few-step variants run on top of PrunaAI's distillation LoRA,
[PrunaAI/P-Q-Image-2.1](https://huggingface.co/PrunaAI/P-Q-Image-2.1), in 6 or 8 steps without CFG.
A base-model variant runs at the usual 40 steps.

<table>
  <tr>
    <th>Photo</th>
    <th>Input (outline)</th>
    <th>Result</th>
  </tr>
  <tr>
    <td width="33%"><img src="examples/R1_photo.jpg" width="100%"></td>
    <td width="33%"><img src="examples/R1_outlined.jpg" width="100%"></td>
    <td width="33%"><img src="examples/R1_result.jpg" width="100%"></td>
  </tr>
</table>

*"Remove the person with the umbrella walking across the plaza."* The outline covers only the person;
their long reflection on the wet plaza, outside it, goes too, and the paving carries on through the gap.
6-step variant, ~2 MP. Photo: Hooman R.,
[Unsplash](https://unsplash.com/photos/a-person-walking-in-the-rain-with-an-umbrella-OzRnoE7qF7A).

| | |
|---|---|
| **Task** | Object removal from a single photo |
| **Input** | Photo + instruction, with the object marked by a red outline (recommended) or by the instruction alone |
| **Sampling** | 6 or 8 steps on PrunaAI/P-Q-Image-2.1, or 40 steps on the base model; no CFG |
| **Resolution** | Generates at the photo's own area; examples shown at ~2 MP |
| **Weights** | LoRA rank 32, three files, one per variant |
| **Base model** | [Qwen/Qwen-Image-2.1](https://huggingface.co/Qwen/Qwen-Image-2.1) with `QwenImage21Pipeline` |

## Variants

Pick **6-step** as the default (recommended), or **base** to avoid the few-step model's drift.

| Variant | File | Runs on | Distillation LoRA (PrunaAI/P-Q-Image-2.1) | Steps | Sigmas | Strength |
|---|---|---|---|:---:|---|:---:|
| `6-step` | `p_q_image_2.1_remove_object_6_steps_v0.1.safetensors` | distilled model | `p_q_image_2.1_6_steps_v0.2.safetensors` | 6 | shifted by image size | **0.7** |
| `8-step` | `p_q_image_2.1_remove_object_8_steps_v0.1.safetensors` | distilled model | `p_q_image_2.1_8_steps_v0.1.safetensors` | 8 | used as given | **0.7** |
| `base` | `p_q_image_2.1_remove_object_base_v0.1.safetensors` | base model | none | 40 | the pipeline's default | 1.0 |

"Strength" is the adapter weight of this LoRA. The distillation LoRA always runs at 1.0.

- **6-step** and **8-step** do in 6 or 8 steps what the base-model variant does in 40. Both run at a
  reduced strength of 0.7.
- **base** runs on the base model alone. Slower, but without the few-step model's drift.

The few-step variants are made to run on top of the matching distillation LoRA. Use each with its own
distillation LoRA, step count and sigma schedule. They are not meant for the base model's 40-step
sampling.

## Quickstart

Needs a **CUDA GPU**.

```bash
pip install 'torch>=2.4.0' 'transformers>=5.17' accelerate peft pillow numpy opencv-python-headless
pip install git+https://github.com/huggingface/diffusers@6256aa7666cedd47443adc8f82da9a10e110b09c
```

`draw_outline.py` (in this repo) draws the outline exactly as expected by the model.

```python
import torch
from PIL import Image
from diffusers import FlowMatchEulerDiscreteScheduler, QwenImage21Pipeline
from draw_outline import draw_outline, outline_prompt

VARIANT = "6-step"  # "6-step", "8-step" or "base"
DISTILL, LORA, SIGMAS, DYNAMIC_SHIFT, STRENGTH = {
    # Unshifted sigmas: the scheduler shifts them by image size.
    "6-step": ("p_q_image_2.1_6_steps_v0.2.safetensors", "p_q_image_2.1_remove_object_6_steps_v0.1.safetensors",
               [1.0, 0.925, 0.85, 0.625, 0.375, 0.125], True, 0.7),
    # Sigmas used exactly as given.
    "8-step": ("p_q_image_2.1_8_steps_v0.1.safetensors", "p_q_image_2.1_remove_object_8_steps_v0.1.safetensors",
               [1.0, 14 / 15, 6 / 7, 10 / 13, 2 / 3, 6 / 11, 0.4, 2 / 9], False, 0.7),
    # Base model alone: 40 steps, the pipeline's own scheduler.
    "base": (None, "p_q_image_2.1_remove_object_base_v0.1.safetensors", None, None, 1.0),
}[VARIANT]

pipe = QwenImage21Pipeline.from_pretrained("Qwen/Qwen-Image-2.1", torch_dtype=torch.bfloat16).to("cuda")
pipe.load_lora_weights("PrunaAI/P-Q-Image-2.1-Remove-Object", weight_name=LORA, adapter_name="removal")
if DISTILL:
    # PrunaAI's distillation LoRA at 1.0 under this one, at its own strength.
    pipe.load_lora_weights("PrunaAI/P-Q-Image-2.1", weight_name=DISTILL, adapter_name="distill")
    pipe.set_adapters(["distill", "removal"], adapter_weights=[1.0, STRENGTH])
    pipe.scheduler = FlowMatchEulerDiscreteScheduler.from_config(
        pipe.scheduler.config, use_dynamic_shifting=DYNAMIC_SHIFT, shift=1.0, shift_terminal=None)
else:
    pipe.set_adapters(["removal"], adapter_weights=[STRENGTH])

photo = Image.open("photo.jpg").convert("RGB")
mask = Image.open("mask.png")  # white = the object to remove

edited = pipe(
    prompt=outline_prompt("Remove the red car on the left."),
    image=[draw_outline(photo, mask)],
    sigmas=SIGMAS,
    num_inference_steps=len(SIGMAS) if SIGMAS else 40,
    true_cfg_scale=1.0,
    # Generate at the photo's own area (the pipeline rounds the size to multiples of 32).
    output_resolution=round((photo.width * photo.height) ** 0.5),
    generator=torch.Generator("cuda").manual_seed(0),
).images[0].resize(photo.size, Image.LANCZOS)
edited.save("edited.png")
```

The pipeline needs sides that are multiples of 32, so the photo is generated at the nearest such size
with the same area and resized back. This does not shift or stretch the result measurably.

## Marking the object

The LoRA accepts two kinds of input.

| Input | Example | Supported |
|---|---|---|
| A rough mask, drawn as an outline | an outline around the goat; the model infers that its shadow goes too | **yes, recommended** |
| The instruction only | "remove the middle goat" | yes |

**Drawing the outline.** Use `draw_outline.py` (in this repo): `draw_outline` draws the outline exactly as
expected by the model, and `outline_prompt` adds the sentence that goes with it. In plain words: a pure
red ring, `#FF0000` (255, 0, 0), that starts 2 px outside the mask and is 3 px wide (4 px when the
photo's short side is over 900 px), drawn on the photo at its own size, and the sentence *"The area to
edit is outlined in red. Remove the red outline as well."* after the instruction. Keep the outlined
image lossless (PNG), since JPEG shifts the red.

### Recommended settings

- **Outline and prompt go together.** With an outlined photo, end the instruction with the outline
  sentence (`outline_prompt` adds it).
- **The mask does not need to be exact.** It works with rough, generous outlines. Include
  the object's shadow or reflection in the mask if they should go too, but keep it off anything that
  should stay (see [Limitations](#limitations)).
- **Name the object as it appears**, and say which one when there are several similar ones (*"the man
  on the right"*, *"the second cup from the left"*).
- **Without a mask**, pass the plain photo and the instruction alone. The outline remains the
  recommended way, since it says exactly which object to remove, but if the outline makes the model
  remove too much, the prompt alone can do better.
- **Keep the strength given in the [Variants](#variants) table**, `true_cfg_scale=1.0` and the
  distillation LoRA at 1.0. Lower strengths reduce texture artifacts and changes outside the mask, but at
  0.5 some removals fail (the object stays, recolored). Above ~1.25 the model also removes neighboring
  objects.

## Why this LoRA

An object removal edit has two jobs:

1. **A good edit where the object was.** The object goes, along with what it causes (its shadow, its
   reflection), and the gap is filled with a believable background.
2. **No change anywhere else.** The rest of the image stays exactly as it was, unless the removal
   affects it.

Models are usually trained for the first, and the second is often lacking. Qwen-Image-2.1 in particular
changes the rest of the image noticeably, and can even shift it so that the output no longer lines up
with the input. Both get worse with the few-step distilled model. This LoRA does both jobs: the object
and its effects go, and the rest of the image stays as it was, lined up with the input.

## Examples

18 photos from [Unsplash](https://unsplash.com), edited with the **6-step variant** at **~2 MP** in
outline mode.

### Highlights

| | Photo | Result |
|---|---|---|
| *Remove the person with the umbrella walking across the plaza.* | ![](examples/R1_photo.jpg) | ![](examples/R1_result.jpg) |
| *Remove the boathouse and the red canoes on the shore.* | ![](examples/L8_photo.jpg) | ![](examples/L8_result.jpg) |
| *Remove the woman in the pink dress.* | ![](examples/TL_photo.jpg) | ![](examples/TL_result.jpg) |
| *Remove the phone and the raised arm holding it.* | ![](examples/c9_photo.jpg) | ![](examples/c9_result.jpg) |

<details>
<summary><b>See all 18 examples, with the outlined inputs</b></summary>

<table>
  <tr>
    <th width="25%"></th>
    <th width="25%">Photo</th>
    <th width="25%">Input (outline)</th>
    <th width="25%">Result</th>
  </tr>
  <tr>
    <td width="25%"><em>Remove the person with the umbrella walking across the plaza.</em><br>Photo: Hooman R., <a href="https://unsplash.com/photos/a-person-walking-in-the-rain-with-an-umbrella-OzRnoE7qF7A">Unsplash</a></td>
    <td width="25%"><img src="examples/R1_photo.jpg" width="100%"></td>
    <td width="25%"><img src="examples/R1_outlined.jpg" width="100%"></td>
    <td width="25%"><img src="examples/R1_result.jpg" width="100%"></td>
  </tr>
  <tr>
    <td width="25%"><em>Remove the person with the umbrella walking on the sidewalk.</em><br>Photo: Sohan Shingade, <a href="https://unsplash.com/photos/a-person-walking-in-the-rain-with-an-umbrella-WWfiTIjy780">Unsplash</a></td>
    <td width="25%"><img src="examples/R3_photo.jpg" width="100%"></td>
    <td width="25%"><img src="examples/R3_outlined.jpg" width="100%"></td>
    <td width="25%"><img src="examples/R3_result.jpg" width="100%"></td>
  </tr>
  <tr>
    <td width="25%"><em>Remove the three construction cranes.</em><br>Photo: Cool Photos, <a href="https://unsplash.com/photos/city-skyline-and-construction-cranes-silhouetted-against-a-fiery-sunset-GGdgJepTFu8">Unsplash</a></td>
    <td width="25%"><img src="examples/Y4_photo.jpg" width="100%"></td>
    <td width="25%"><img src="examples/Y4_outlined.jpg" width="100%"></td>
    <td width="25%"><img src="examples/Y4_result.jpg" width="100%"></td>
  </tr>
  <tr>
    <td width="25%"><em>Remove the blue tent.</em><br>Photo: Hameen Reynolds, <a href="https://unsplash.com/photos/person-fishing-on-sandy-beach-0mawt19VQTU">Unsplash</a></td>
    <td width="25%"><img src="examples/A8_photo.jpg" width="100%"></td>
    <td width="25%"><img src="examples/A8_outlined.jpg" width="100%"></td>
    <td width="25%"><img src="examples/A8_result.jpg" width="100%"></td>
  </tr>
  <tr>
    <td width="25%"><em>Remove the woman in the pink dress.</em><br>Photo: The Now Time, <a href="https://unsplash.com/photos/a-woman-in-a-pink-dress-and-hat-standing-in-a-field-of-flowers--GXYzjeBiw8">Unsplash</a></td>
    <td width="25%"><img src="examples/TL_photo.jpg" width="100%"></td>
    <td width="25%"><img src="examples/TL_outlined.jpg" width="100%"></td>
    <td width="25%"><img src="examples/TL_result.jpg" width="100%"></td>
  </tr>
  <tr>
    <td width="25%"><em>Remove the woman walking on the path.</em><br>Photo: Krists Luhaers, <a href="https://unsplash.com/photos/women-walking-on-pathway-surrounded-by-dried-leaves-u5NqIxG41jU">Unsplash</a></td>
    <td width="25%"><img src="examples/A3_photo.jpg" width="100%"></td>
    <td width="25%"><img src="examples/A3_outlined.jpg" width="100%"></td>
    <td width="25%"><img src="examples/A3_result.jpg" width="100%"></td>
  </tr>
  <tr>
    <td width="25%"><em>Remove the person standing in the wheat field.</em><br>Photo: rashid khreiss, <a href="https://unsplash.com/photos/woman-standing-on-dried-whey-4NMRdyAjcAk">Unsplash</a></td>
    <td width="25%"><img src="examples/W7_photo.jpg" width="100%"></td>
    <td width="25%"><img src="examples/W7_outlined.jpg" width="100%"></td>
    <td width="25%"><img src="examples/W7_result.jpg" width="100%"></td>
  </tr>
  <tr>
    <td width="25%"><em>Remove the wooden chapel.</em><br>Photo: Christopher Politano, <a href="https://unsplash.com/photos/wooden-chapel-on-mountain-hill-nYH4jVuOiBE">Unsplash</a></td>
    <td width="25%"><img src="examples/C3_photo.jpg" width="100%"></td>
    <td width="25%"><img src="examples/C3_outlined.jpg" width="100%"></td>
    <td width="25%"><img src="examples/C3_result.jpg" width="100%"></td>
  </tr>
  <tr>
    <td width="25%"><em>Remove the white cottage.</em><br>Photo: Abby Shirey, <a href="https://unsplash.com/photos/remote-cottage-nestled-in-a-vast-mountainous-landscape-gusSvbighUM">Unsplash</a></td>
    <td width="25%"><img src="examples/H1_photo.jpg" width="100%"></td>
    <td width="25%"><img src="examples/H1_outlined.jpg" width="100%"></td>
    <td width="25%"><img src="examples/H1_result.jpg" width="100%"></td>
  </tr>
  <tr>
    <td width="25%"><em>Remove the boathouse and the red canoes on the shore.</em><br>Photo: Sam Dawson, <a href="https://unsplash.com/photos/black-mountain-covered-with-snow-7t5c1iDrApU">Unsplash</a></td>
    <td width="25%"><img src="examples/L8_photo.jpg" width="100%"></td>
    <td width="25%"><img src="examples/L8_outlined.jpg" width="100%"></td>
    <td width="25%"><img src="examples/L8_result.jpg" width="100%"></td>
  </tr>
  <tr>
    <td width="25%"><em>Remove the wooden ladder, the white stool and the potted plant.</em><br>Photo: Andrew Neel, <a href="https://unsplash.com/photos/ladder-stool-and-snake-plant-DLD5LvnFblU">Unsplash</a></td>
    <td width="25%"><img src="examples/E1_photo.jpg" width="100%"></td>
    <td width="25%"><img src="examples/E1_outlined.jpg" width="100%"></td>
    <td width="25%"><img src="examples/E1_result.jpg" width="100%"></td>
  </tr>
  <tr>
    <td width="25%"><em>Remove the phone.</em><br>Photo: micheile henderson, <a href="https://unsplash.com/photos/black-and-red-iphone-5-c-beside-white-ceramic-mug-with-red-and-white-liquid-KQlbxeWY1pQ">Unsplash</a></td>
    <td width="25%"><img src="examples/F4_photo.jpg" width="100%"></td>
    <td width="25%"><img src="examples/F4_outlined.jpg" width="100%"></td>
    <td width="25%"><img src="examples/F4_result.jpg" width="100%"></td>
  </tr>
  <tr>
    <td width="25%"><em>Remove the phone and the raised arm holding it.</em><br>Photo: Aliaksei Antropau, <a href="https://unsplash.com/photos/person-recording-concert-under-red-lights-n24LASzjRgs">Unsplash</a></td>
    <td width="25%"><img src="examples/c9_photo.jpg" width="100%"></td>
    <td width="25%"><img src="examples/c9_outlined.jpg" width="100%"></td>
    <td width="25%"><img src="examples/c9_result.jpg" width="100%"></td>
  </tr>
  <tr>
    <td width="25%"><em>Remove the phone held up on the right.</em><br>Photo: Юлия Журавлева, <a href="https://unsplash.com/photos/fireworks-explode-in-the-night-sky-for-a-crowd-tLAe7MUTggM">Unsplash</a></td>
    <td width="25%"><img src="examples/f3_photo.jpg" width="100%"></td>
    <td width="25%"><img src="examples/f3_outlined.jpg" width="100%"></td>
    <td width="25%"><img src="examples/f3_result.jpg" width="100%"></td>
  </tr>
  <tr>
    <td width="25%"><em>Remove the woman with her hands on her head in the middle of the crowd.</em><br>Photo: Lukas Bato, <a href="https://unsplash.com/photos/people-standing-in-front-of-stage-with-lights-C6ni9uAva5I">Unsplash</a></td>
    <td width="25%"><img src="examples/c7_photo.jpg" width="100%"></td>
    <td width="25%"><img src="examples/c7_outlined.jpg" width="100%"></td>
    <td width="25%"><img src="examples/c7_result.jpg" width="100%"></td>
  </tr>
  <tr>
    <td width="25%"><em>Remove the two light stands, with the LED light and the boom arm.</em><br>Photo: KOBU Agency, <a href="https://unsplash.com/photos/a-chair-sitting-in-front-of-a-pink-backdrop-uKKNmPBsaiI">Unsplash</a></td>
    <td width="25%"><img src="examples/t5_photo.jpg" width="100%"></td>
    <td width="25%"><img src="examples/t5_outlined.jpg" width="100%"></td>
    <td width="25%"><img src="examples/t5_result.jpg" width="100%"></td>
  </tr>
  <tr>
    <td width="25%"><em>Remove the two umbrella lights on their stands.</em><br>Photo: Arif DALKIRAN, <a href="https://unsplash.com/photos/a-lamp-is-set-up-for-a-studio-photoshoot-LYcuJG5LyU8">Unsplash</a></td>
    <td width="25%"><img src="examples/t8_photo.jpg" width="100%"></td>
    <td width="25%"><img src="examples/t8_outlined.jpg" width="100%"></td>
    <td width="25%"><img src="examples/t8_result.jpg" width="100%"></td>
  </tr>
  <tr>
    <td width="25%"><em>Remove the studio light in the foreground on the left and the softbox on the right.</em><br>Photo: Olga Serjantu, <a href="https://unsplash.com/photos/a-table-with-a-bunch-of-fruit-and-vegetables-on-it-qu2JENeCaE4">Unsplash</a></td>
    <td width="25%"><img src="examples/t6_photo.jpg" width="100%"></td>
    <td width="25%"><img src="examples/t6_outlined.jpg" width="100%"></td>
    <td width="25%"><img src="examples/t6_result.jpg" width="100%"></td>
  </tr>
</table>

</details>

## Limitations

- **It can remove more than the outlined object.** Not always, but it happens: the outline weighs more
  than the instruction, so
  when the mask also covers part of something that should stay, that can go too. With two people where
  one partly hides the other, a mask around one sometimes removes both, while the prompt alone removes
  only the right one. Keep the mask tight where other things overlap the object. Lowering the strength
  does not fix this.
- **Textures in the filled area can look off.** The fill can come out smoother and blurrier than its
  surroundings, miss the photo's grain, or show a regular grid pattern. It stands out more than one
  might expect, and can read as inconsistent focus. The few-step variants' reduced default
  strength (0.7) lessens it without removing it. The strength is a trade-off you can
  tune for your own images: lower gives cleaner textures but weaker removals (at 0.5 some fail, keeping
  or recoloring the object), higher gives firmer removals with more texture artifacts.
- **Only for removing objects.** Other edits (adding or replacing an object, changing colors or style)
  were never trained and are not expected to work better than with the base model alone.
- **Plausible, not accurate.** It fills in what should be behind the object, so heavily occluded or
  ambiguous backgrounds can come out plausible rather than accurate.

## What this is not

- Not a standalone model. It needs the `Qwen/Qwen-Image-2.1` base weights, and the few-step variants
  also need [PrunaAI/P-Q-Image-2.1](https://huggingface.co/PrunaAI/P-Q-Image-2.1).
- Not a general image editor. It is trained for object removal only.
- Not a finished release. Expect the weights to change in future versions.

## License

P-Q-Image-2.1-Remove-Object is a derivative of Qwen-Image-2.1 and follows the
[Qwen RESEARCH LICENSE AGREEMENT](https://huggingface.co/Qwen/Qwen-Image-2.1/blob/main/LICENSE). Review
its use restrictions before using or redistributing the adapters. The few-step variants also need
PrunaAI's distillation LoRA ([PrunaAI/P-Q-Image-2.1](https://huggingface.co/PrunaAI/P-Q-Image-2.1)),
whose own terms apply.

Qwen is licensed under the Qwen RESEARCH LICENSE AGREEMENT, Copyright (c) 2026 Hangzhou Tongyi
Laboratory Technology Co., Ltd. All Rights Reserved.

The example photos are from Unsplash, under the [Unsplash License](https://unsplash.com/license): free
to copy, modify and use, commercial use included, without asking or crediting the photographer (credits
are given anyway). Not allowed: selling a photo without significant modification, or compiling Unsplash
photos into a similar or competing service. Each photo's page was checked on 2026-11-04 and read "Free
to use under the Unsplash License", and again on 2026-11-10 for the final set.

> **The Unsplash License does not cover people or brands in a photo.** Per the
> [Unsplash Terms](https://unsplash.com/terms), trademarks, logos and brands, and recognizable people,
> may need the permission of their owner or of the person, depending on the use. People appear in
> several examples, from behind or as silhouettes, without a readable face. The night plaza photo shows
> a small lit shop sign ("NAILS & RESORT") in the background, an incidental business name. The chapel,
> cottage and boathouse photos show buildings that are likely identifiable (a Swiss chapel, a Glen Coe
> cottage, the Lake Louise boathouse), shot from public land and removed in the result. No other example
> shows a readable brand.
> This is a record of what the licenses say, not legal advice.

## What's next?

- **Use P-Q-Image-2.1-Remove-Object to remove objects from photos with Qwen-Image-2.1 in a few steps.**
- Compress your own models with [Pruna](https://github.com/PrunaAI/pruna) and give us a ⭐️ for more efficiency!
- Want to use our optimized image models right away? Check [P-Image-Ideogram](https://www.pruna.ai/p-image-ideogram) and [P-Image-Edit](https://www.pruna.ai/p-image-edit).

<style>
.model-button {
  display: inline-flex;
  flex-direction: row;
  justify-content: center;
  align-items: center;
  gap: 8px;

  padding: 8px 20px;
  border: none;
  border-radius: 8px;

  background: #9334e9;
  color: #ffffff;

  font-size: 14px;
  font-weight: 400;
  line-height: 1;
  text-decoration: none;
  white-space: nowrap;
  cursor: pointer;

  box-sizing: border-box;
  overflow: visible;
  opacity: 1;
}
</style>

<a href="https://dashboard.pruna.ai/login?utm_source=huggingface&utm_medium=model_card&utm_campaign=hf_traffic" class="model-button">Try our models</a>