AGSoft Inpaint Crop

The single best trick in masked inpainting is also the one that takes the most plumbing: crop a small region around your mask, render it at the model's native resolution, then paste the result back so the rest of the frame is bit-identical. AGSoft Inpaint Crop is the first half of that pipeline, and it's the half people usually hand-build with four or five separate nodes. It takes the image and mask, crops a box around the mask with padding, feathers the edges, aligns to model-friendly dimensions, and hands you - along with the crop - a stitcher object that remembers everything needed to put the result back.

It pairs with the pack's AGSoft Inpaint Stitch node, and together they make the crop-and-stitch workflow a two-node graph instead of a mini project.

How it works

The crop box is computed from your mask's bounds. Three settings shape it:

• padding (default 32) - extra pixels around the mask so the model has context, not just the masked sliver.
• force_square (default on) - makes the crop square (sized to the larger side), which most inpainting models want. The tooltip recommends keeping it on.
• multiple_of (default 64) - rounds the crop up to a multiple; drop to 8 for SD1.5 workflows.

feathering (default 16) blurs the mask edge in the original resolution, which is what makes the later stitch blend instead of showing a hard seam.

Then the optional part: upscale_mode. Inpainting models render best at their native resolution, and your crop may be small - so the node can upscale the cropped image (with target_width/target_height, scale_factor, or fit modes) before it goes to the sampler. The mask stays at original resolution, and the stitcher remembers the scale so Inpaint Stitch can shrink the result back down on paste. That's the whole "64px eye gets 1024px of generation budget" trick, automated.

The outputs

stitcher (a custom STITCHER object carrying original image, offset, and scale), cropped_image, cropped_mask, and width/height ints. The stitcher is the piece you must not lose - it's what lets Inpaint Stitch place the result back exactly.

Where it fits

Wire: AGSoft Inpaint Crop → your sampler (denoise ~1.0 in the masked region) → AGSoft Inpaint Stitch. If you're coming from the instruction-edit era and want bit-identical unmasked pixels - which no edit model gives you - this crop-stitch chain is the standard way to get them with a mask. It also plays fine with the older "dedicated inpainting model" approach.

Installing it

Pack standard: ComfyUI Manager → search comfyui-AGSoft → install, restart. Or:

cd ComfyUI/custom_nodes
git clone https://github.com/Art-xmaster/comfyui-AGSoft.git

No model downloads. One dependency note: the Stitch node offers Poisson blending, but only if opencv-python is installed - the pack's requirements.txt doesn't guarantee it, so if the fancier blend is greyed out, pip install opencv-python in your ComfyUI environment.

Common issues

• Cropped region too tight - that's padding; raise it before blaming the model.
• Hard seams after stitch - feathering too low, or the mask edge is sharp at full res. Bump feathering and re-run.
• Poisson blend missing - opencv not installed (above).
• Upscale drift - if you upscaled the crop and the stitch looks slightly off-position, check that the stitcher wire is intact; without it the node can't compute the original offset.