🖼️✂️AGSoft Image Crop

Every workflow eventually needs a crop that isn't "center, fixed size." Maybe you want the top-left 512px, maybe you want to shave 5% off the edges, maybe you want to crop around a subject that isn't in the middle. ✂️ AGSoft Image Crop is the pack's general-purpose crop node, and it covers all of those without forcing you to build the math yourself. The trick that makes it worth your time: it crops images and masks together, so your inpainting or compositing setup stays aligned.

What it does

At its simplest it's a center crop: width and height in, cropped_image out. But there are three layers on top of that.

Positions. position has 9 presets - center, all four corners, and the four edges. No manual coordinate math for the common cases.

Percentages. Flip use_percentage on and width/height become percentages of the source. Crop 50% from the center, 25% from the top - the kind of thing that's a pain to express as raw pixels.

Inverse crop. inverse_crop_percent does the opposite: it removes a band from the edges. Set it to 5 and the node trims 5% off each side - handy for chopping scan borders or watermark strips without doing offset arithmetic.

There's also maintain_aspect_ratio (keeps the source proportions when you change one side), custom start_x/start_y when presets don't fit, a fill_color for the crop's leftovers, interpolation, and a device selector with CPU/GPU/Auto. use_cache (on by default) keeps repeated crops fast, which matters in batch-heavy loops.

The mask connection

Plug a mask in and you get cropped_mask out, cut with the exact same geometry. That's the feature that makes this node more than a toy: crop around a face or an object, and the mask that goes with it comes along for the ride, ready to feed an inpaint or composite step. For that classic "crop tight, generate big, stitch back" workflow, keeping image and mask in lockstep is half the battle.

Outputs: cropped_image, cropped_mask, plus cropped_width/cropped_height ints you can wire into downstream sizing.

Installing it

Standard pack install: ComfyUI Manager → search comfyui-AGSoft → install, restart. Or:

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

No models, no extra dependencies - pure PIL/torch, so a bare clone runs it.

Common issues

The usual trap is use_percentage left on from a previous workflow: suddenly your 512 width means "half of a 1024-wide image" and crops come out unexpected. Check that toggle before debugging anything else. Also, if you crop and then upscale the crop a lot, the result gets soft fast - this is a plain crop, not a super-resolution stage, so pair it with an upscaler or an inpaint pass when you need detail back. And as with any crop that feeds a dedicated inpainting model, the mask should match the crop exactly - which is precisely the case where this node earns its keep.