Universally applicable inpainting ability for every model. LanPaint sampler lets the model "think" through multiple iterations before denoising, enabling you to invest more computation time for superior inpainting quality.

What LanPaint Enables

• Training-free image inpainting
• Outpainting and generative fill
• Mask-constrained local image editing
• Object / region replacement with text guidance
• Character-consistent local generation
• Video inpainting and local video editing
• Video + audio masked generation

Research & Benchmark

LanPaint is a training-free partial conditional sampler that enables mask-constrained inpainting and local editing with pretrained diffusion and rectified-flow models, without fine-tuning or backpropagation.

• 📄 Paper: LanPaint: Training-Free Diffusion Inpainting with Asymptotically Exact and Fast Conditional Sampling — TMLR 2025
• 🧩 ComfyUI Implementation: This repository
• 🐍 Diffusers Implementation: LanPaint-Diffusers by @charrywhite
• 🧪 Benchmark & Reproduction: LanPaintBench
• 🌐 Project Website: LanPaint Page

Citation

@article{
zheng2025lanpaint,
title={LanPaint: Training-Free Diffusion Inpainting with Asymptotically Exact and Fast Conditional Sampling},
author={Candi Zheng and Yuan Lan and Yang Wang},
journal={Transactions on Machine Learning Research},
issn={2835-8856},
year={2025},
url={https://openreview.net/forum?id=JPC8JyOUSW}
}

Check Mased Qwen Edit Workflow. You need to follow the ComfyUI version of Qwen Image Edit workflow to download and install the model.

Also check Qwen Inpaint Workflow and Qwen Outpaint Workflow. You need to follow the ComfyUI version of Qwen Image workflow to download and install the model.

Table of Contents

• Features
• Quickstart
• How to Use Examples
• Examples
  • Qwen Image
  • HiDream
  • SD 3.5
  • Flux
  • SDXL Examples
• Usage
  • Basic Sampler
  • Advanced Sampler
  • Tuning Guide
• Community Showcase
• Updates
• ToDo
• Citation

Features

• Universal Compatibility – Works instantly with almost any model (SD 1.5, XL, 3.5, Flux, HiDream, Qwen-Image or custom LoRAs) and ControlNet.
  
• No Training Needed – Works out of the box with your existing model.
• Easy to Use – Same workflow as standard ComfyUI KSampler.
• Flexible Masking – Supports any mask shape, size, or position for inpainting/outpainting.
• No Workarounds – Generates 100% new content (no blending or smoothing) without relying on partial denoising.
• Beyond Inpainting – You can even use it as a simple way to generate consistent characters.

Warning: LanPaint has degraded performance on distillation models, such as Flux.dev, due to a similar issue with LORA training. Please use low flux guidance (1.0-2.0) to mitigate this issue.

Quickstart

1. Install ComfyUI: Follow the official ComfyUI installation guide to set up ComfyUI on your system. Or ensure your ComfyUI version > 0.3.11.
2. Install ComfyUI-Manager: Add the ComfyUI-Manager for easy extension management.
3. Install LanPaint Nodes:
   • Via ComfyUI-Manager: Search for "LanPaint" in the manager and install it directly.
   • Manually: Click "Install via Git URL" in ComfyUI-Manager and input the GitHub repository link:

     https://github.com/scraed/LanPaint.git
     

     Alternatively, clone this repository into the ComfyUI/custom_nodes folder.
4. Restart ComfyUI: Restart ComfyUI to load the LanPaint nodes.

Once installed, you'll find the LanPaint nodes under the "sampling" category in ComfyUI. Use them just like the default KSampler for high-quality inpainting!

How to Use Examples:

1. Navigate to the example folder (i.e example_1), download all pictures.
2. Drag InPainted_Drag_Me_to_ComfyUI.png into ComfyUI to load the workflow.
3. Download the required model (i.e clicking Model Used in This Example).
4. Load the model in ComfyUI.
5. Upload Masked_Load_Me_in_Loader.png to the "Load image" node in the "Mask image for inpainting" group (second from left), or the Prepare Image node.
6. Queue the task, you will get inpainted results from LanPaint. Some example also gives you inpainted results from the following methods for comparison:
   • VAE Encode for Inpainting
   • Set Latent Noise Mask

Examples

Example Qwen Image: InPaint(LanPaint K Sampler, 5 steps of thinking)

We are excited to announce that LanPaint now supports Qwen Image, providing powerful inpainting capabilities for image editing.

View Workflow & Masks

You need to follow the ComfyUI version of Qwen Image workflow to download and install the model.

The following examples utilize a random seed of 0 to generate a batch of 4 images for variance demonstration and fair comparison. (Note: Generating 4 images may exceed your GPU memory; please adjust the batch size as necessary.)

Example HiDream: InPaint (LanPaint K Sampler, 5 steps of thinking)

View Workflow & Masks

You need to follow the ComfyUI version of HiDream workflow to download and install the model.

Example HiDream: OutPaint(LanPaint K Sampler, 5 steps of thinking)

View Workflow & Masks

You need to follow the ComfyUI version of HiDream workflow to download and install the model. Thanks Amazon90 for providing this example.

Example SD 3.5: InPaint(LanPaint K Sampler, 5 steps of thinking)

View Workflow & Masks

You need to follow the ComfyUI version of SD 3.5 workflow to download and install the model.

Example Flux: InPaint(LanPaint K Sampler, 5 steps of thinking)

View Workflow & Masks Model Used in This Example (Note: Prompt First mode is disabled on Flux. As it does not use CFG guidance.)

Example SDXL 0: Character Consistency (Side View Generation) (LanPaint K Sampler, 5 steps of thinking)

View Workflow & Masks Model Used in This Example

(Tricks 1: You can emphasize the character by copy it's image multiple times with Photoshop. Here I have made one extra copy.)

(Tricks 2: Use prompts like multiple views, multiple angles, clone, turnaround. Use LanPaint's Prompt first mode (does not support Flux))

(Tricks 3: Remeber LanPaint can in-paint: Mask non-consistent regions and try again!)

Example SDXL 1: Basket to Basket Ball (LanPaint K Sampler, 2 steps of thinking).

View Workflow & Masks Model Used in This Example

Example SDXL 2: White Shirt to Blue Shirt (LanPaint K Sampler, 5 steps of thinking)

View Workflow & Masks Model Used in This Example

Example SDXL 3: Smile to Sad (LanPaint K Sampler, 5 steps of thinking)

View Workflow & Masks Model Used in This Example

Example SDXL 4: Damage Restoration (LanPaint K Sampler, 5 steps of thinking)

View Workflow & Masks Model Used in This Example

Example SDXL 5: Huge Damage Restoration (LanPaint K Sampler, 20 steps of thinking)

View Workflow & Masks Model Used in This Example

Check more for use cases like inpaint on fine tuned models and face swapping, thanks to Amazon90.

Usage

Workflow Setup
Same as default ComfyUI KSampler - simply replace with LanPaint KSampler nodes. The inpainting workflow is the same as the SetLatentNoiseMask inpainting workflow.

Note

• LanPaint requires binary masks (values of 0 or 1) without opacity or smoothing. To ensure compatibility, set the mask's opacity and hardness to maximum in your mask editor. During inpainting, any mask with smoothing or gradients will automatically be converted to a binary mask.
• LanPaint relies heavily on your text prompts to guide inpainting - explicitly describe the content you want generated in the masked area. If results show artifacts or mismatched elements, counteract them with targeted negative prompts.

Basic Sampler

• LanPaint KSampler: The most basic and easy to use sampler for inpainting.
• LanPaint KSampler (Advanced): Full control of all parameters.

LanPaint KSampler

Simplified interface with recommended defaults:

• Steps: 20 - 50. More steps will give more "thinking" and better results.
• LanPaint NumSteps: The turns of thinking before denoising. Recommend 5 for most of tasks ( which means 5 times slower than sampling without thinking). Use 10 for more challenging tasks.
• LanPaint Prompt mode: Image First mode and Prompt First mode. Image First mode focuses on the image, inpaint based on image context (maybe ignore prompt), while Prompt First mode focuses more on the prompt. Use Prompt First mode for tasks like character consistency. (Technically, it Prompt First mode change CFG scale to negative value in the BIG score to emphasis prompt, which will costs image quality.)

LanPaint KSampler (Advanced)

Full parameter control: Key Parameters

For detailed descriptions of each parameter, simply hover your mouse over the corresponding input field to view tooltips with additional information.

LanPaint Mask Blend

This node blends the original image with the inpainted image based on the mask. It is useful if you want the unmasked region to match the original image pixel perfectly.

LanPaint KSampler (Advanced) Tuning Guide

For challenging inpainting tasks:

1️⃣ Boost Quality Increase total number of sampling steps (very important!), LanPaint_NumSteps (thinking iterations) or LanPaint_Lambda if the inpainted result does not meet your expectations.

2️⃣ Boost Speed Decrease LanPaint_NumSteps to accelerate generation! If you want better results but still need fewer steps, consider: - Increasing LanPaint_StepSize to speed up the thinking process. - Decreasing LanPaint_Friction to make the Langevin dynamics converges more faster.

3️⃣ Fix Unstability:
If you find the results have wired texture, try

• Reduce LanPaint_Friction to make the Langevin dynamics more stable.
• Reduce LanPaint_StepSize to use smaller step size.
• Reduce LanPaint_Beta if you are using a high lambda value.

⚠️ Notes:

• For effective tuning, fix the seed and adjust parameters incrementally while observing the results. This helps isolate the impact of each setting. Better to do it with a batche of images to avoid overfitting on a single image.

Community Showcase

Discover how the community is using LanPaint! Here are some user-created tutorials:

• Ai绘画进阶148-三大王炸！庆祝高允贞出道6周年！T8即将直播？当AI绘画学会深度思考？！万能修复神器LanPaint，万物皆可修！-T8 Comfyui教程
• Ai绘画进阶151-真相了！T8竟是个AI？！LanPaint进阶（二），人物一致性，多视角实验性测试，新参数讲解，工作流分享-T8 Comfyui教程
• 重绘和三视图角色一致性解决新方案！LanPaint节点尝试
• ComfyUI: HiDream with Perturbation Upscale, LanPaint Inpainting (Workflow Tutorial)
• ComfyUI必备LanPaint插件超详细使用教程

Submit a PR to add your tutorial/video here, or open an Issue with details!

Updates

• 2025/08/08
  • Add Qwen image support
• 2025/06/21
  • Update the algorithm with enhanced stability and outpaint performance.
  • Add outpaint example
  • Supports Sampler Custom (Thanks to MINENEMA)
• 2025/06/04
  • Add more sampler support.
  • Add early stopping to advanced sampler.
• 2025/05/28
  • Major update on the Langevin solver. It is now much faster and more stable.
  • Greatly simplified the parameters for advanced sampler.
  • Fix performance issue on Flux and SD 3.5
• 2025/04/16
  • Added Primary HiDream support
• 2025/03/22
  • Added Primary Flux support
  • Added Tease Mode
• 2025/03/10
  • LanPaint has received a major update! All examples now use the LanPaint K Sampler, offering a simplified interface with enhanced performance and stability.
• 2025/03/06:
  • Bug Fix for str not callable error and unpack error. Big thanks to jamesWalker55 and EricBCoding.

ToDo

• Try Implement Detailer
• Provide inference code on without GUI. Check our local Python benchmark code LanPaintBench.

Citation

@article{zheng2025lanpaint,
  title={LanPaint: Training-Free Diffusion Inpainting with Asymptotically Exact and Fast Conditional Sampling},
  author={Candi Zheng and Yuan Lan and Yang Wang},
  journal={Transactions on Machine Learning Research},
  issn={2835-8856},
  year={2025},
  url={https://openreview.net/forum?id=JPC8JyOUSW}
}