lightflow-flux-inpaint

name	LightFlow FLUX Inpaint
description	Use this skill when working with the lightflow.flux_inpaint workflow, masks, local repainting, or FLUX inpaint model sync.
version	0.1.0

LightFlow FLUX Inpaint

Use lightflow.flux_inpaint for masked local repainting with a PNG mask.

The source definition now uses the canonical workflow! { name, description, ... } form. This source-only DSL migration does not change execution behavior or the input/output contract below.

Workflow

• Workflow id: lightflow.flux_inpaint
• Inputs: image_path, mask_path, prompt, negative, strength, feather_px, dilate_px, invert_mask, seed, count, steps, guidance, output_path, output_template, model.
• Outputs: image, image_path, images, image_paths.
• Runtime capability: lightflow.image.inpaint.
• Runtime engine: runner.v1.
• Model requirements: flux_model, llm_model, and vae_model.
• Node Schema: image_path is an image artifact input, mask_path is a mask artifact input, image outputs are image artifacts, and sampling/mask controls expose editor ranges.

Mask Contract

White mask pixels are repainted, black pixels are preserved, and gray values are soft weights. Set invert_mask=true to flip that convention.

feather_px and dilate_px are preprocessing hints. Keep mask_path in the same coordinate space as image_path; resizing or composing masks should be done by upstream mask nodes.

Runtime

Run lfw sync lightflow.flux_inpaint --auto-model --apply before a real inpaint run. The workflow package owns request validation, backend invocation, PNG verification, artifacts, and replay identity. Configure LIGHTFLOW_FLUX_RUNNER and the three LIGHTFLOW_FLUX_*_MODEL_PATH variables; without them execution fails closed.

Usage

lfw sync lightflow.flux_inpaint --auto-model --apply
lfw run lightflow.flux_inpaint \
  -i image_path='"input.png"' \
  -i mask_path='"mask.png"' \
  -i prompt='"repair the scratched area"' \
  -i output_path='"out/inpaint.png"'

Validation

lfw node test lightflow.flux_inpaint

API Usage

Start lfw serve, then call the workflow through the shared HTTP run contract. Adjust inputs to match the workflow contract above.

curl -sS -X POST http://127.0.0.1:5174/workflows/lightflow.flux_inpaint/run \
  -H 'content-type: application/json' \
  -d '{"inputs":{}}'