---
tags:
- flux
- overlay
- image-overlay
- lora
- fal
- diffusers
- ilkerzgi
- gokaygokay
language: en
base_model: black-forest-labs/FLUX.1-Kontext-dev
instance_prompt: place it
license_name: flux1-dev-non-commercial-license
license_link: >-
  https://huggingface.co/black-forest-labs/FLUX.1-Kontext-dev/blob/main/LICENSE.md
license: other
widget:
- text: Place it
  output:
    url: out1.png
- src: in1.png
  prompt: Place it
  output:
    url: out1.png
- text: Place it
  output:
    url: out2.png
- src: in2.png
  prompt: Place it
  output:
    url: out2.png
- text: Place it
  output:
    url: out3.png
- src: ins3.jpg
  prompt: Place it
  output:
    url: out3.png
pipeline_tag: image-to-image
---

# Kontext Dev LoRA - Image Overlay

<Gallery />

This is a LoRA (Low-Rank Adaptation) model that has been trained for image overlay tasks, allowing you to seamlessly blend and place elements into existing images.

## Table of Contents
- [Model Details](#model-details)
- [Uses](#uses)
- [Training](#training)
- [Usage Tips](#usage-tips)
- [Academic Use and Citation](#academic-use-and-citation)

## Model Details

**Model Description:** This model is a LoRA fine-tune of `black-forest-labs/FLUX.1-Kontext-dev` specifically designed for image overlay workflows, enabling natural integration of new elements into existing scenes.

* **Trained by:** [ilkerzgi](https://huggingface.co/ilkerzgi) and [gokaygokay](https://huggingface.co/gokaygokay)
* **Model Type:** LoRA for Image Overlay
* **Language(s):** English
* **License:** [flux1-dev-non-commercial-license](https://huggingface.co/black-forest-labs/FLUX.1-Kontext-dev/blob/main/LICENSE.md)
* **Parent Model:** [black-forest-labs/FLUX.1-Kontext-dev](https://huggingface.co/black-forest-labs/FLUX.1-Kontext-dev)
* **Resources for more information:**
 * [Download the weights](https://huggingface.co/ilkerzgi/kontext-dev-overlay-lora/blob/main/WVVtJFD90b8SsU6EzeGkO_adapter_model_comfy_converted.safetensors)
 * [Try the model directly on fal.ai](https://infinite-kanvas.vercel.app)

## Uses

#### Direct Use
This model is designed for image overlay tasks, allowing you to naturally integrate new objects, elements, or modifications into existing images. The model excels at understanding context and placement, creating seamless compositions.

The model works best when using the trigger phrase: **"place it"**.

#### Recommended Settings
- **LoRA Scale:** 1.0 or 0.9 for optimal results
- **Image Format:** Square format images work best
- **Overlay Area:** Clear definition of where elements should be placed
- **Context Understanding:** Works well with natural scene composition

## Training

#### Training Procedure
Training was performed using the [FLUX Kontext Trainer on fal.ai](https://fal.ai/models/fal-ai/flux-kontext-trainer/playground).

The base model for training was `black-forest-labs/FLUX.1-Kontext-dev`, with specialized focus on image overlay scenarios and contextual element placement.

## Usage Tips

- Use **square format images** for best results
- Set **LoRA scale to 1.0 or 0.9** for optimal output quality
- Use the simple prompt **"place it"** as the trigger phrase
- Provide clear context about what you want to overlay and where
- The model understands spatial relationships and lighting conditions for natural integration
- Works well with both object placement and scene modifications

## Academic Use and Citation

This model is cited and evaluated as a baseline in:

- [*LayerComposer: Multi-Human Personalized Generation via Layered Canvas*](https://arxiv.org/abs/2510.20820) (2025 preprint)
- [*Canvas-to-Image: Compositional Image Generation with Multimodal Controls*](https://doi.org/10.1145/3799902.3811219) (ACM SIGGRAPH 2026)

If this model is useful in your research, please cite the model and the relevant paper:

```bibtex
@software{ilkerzgi_aydogan2025overlay_kontext,
  author = {{ilkerzgi} and Aydoğan, Gökay},
  title = {Overlay Kontext Dev LoRA},
  year = {2025},
  url = {https://huggingface.co/ilkerzgi/Overlay-Kontext-Dev-LoRA},
  note = {Hugging Face model}
}

@article{qian2025layercomposer,
  author = {Qian, Guocheng Gordon and Zhang, Ruihang and Chen, Tsai-Shien and Dalva, Yusuf and Goyal, Anujraaj Argo and Menapace, Willi and Skorokhodov, Ivan and Dong, Meng and Sahni, Arpit and Ostashev, Daniil and Hu, Ju and Tulyakov, Sergey and Wang, Kuan-Chieh Jackson},
  title = {LayerComposer: Multi-Human Personalized Generation via Layered Canvas},
  journal = {arXiv preprint arXiv:2510.20820},
  year = {2025},
  doi = {10.48550/arXiv.2510.20820}
}

@inproceedings{dalva2026canvas,
  author = {Dalva, Yusuf and Qian, Guocheng Gordon and Goldenberg, Maya and Chen, Tsai-Shien and Aberman, Kfir and Tulyakov, Sergey and Yanardag, Pinar and Wang, Kuan-Chieh Jackson},
  title = {Canvas-to-Image: Compositional Image Generation with Multimodal Controls},
  booktitle = {ACM SIGGRAPH 2026 Conference Papers},
  year = {2026},
  doi = {10.1145/3799902.3811219}
}
```

Co-trained by [ilkerzgi](https://huggingface.co/ilkerzgi) and [Gökay Aydoğan](https://orcid.org/0000-0002-2343-9433).

---