Skip to main content

Image Processing

Split grid images, remove backgrounds, and enhance image quality — all powered by AI. A fal.ai API key is prompted on first use if not already configured.

image-split

Splits a grid image into individual tiles.

kappmaker image-split grid.png --rows 4 --cols 4 --zoom 1.1 --gap 3
kappmaker image-split grid.png --keep 1,5 # Keep only tiles 1 and 5

Options

FlagDescriptionDefault
--rows <n>Number of rows4
--cols <n>Number of columns4
--zoom <factor>Zoom factor to crop edges1.07
--gap <pixels>Gap pixels at each tile edge0
--width <pixels>Output tile width512
--height <pixels>Output tile height512
--output-dir <path>Directory to save tiles.
--keep <indices>Comma-separated tile indices to keepAll

image-remove-bg

Removes background using fal.ai bria model. Outputs PNG with transparency.

kappmaker image-remove-bg logo.png
kappmaker image-remove-bg photo.jpg --output clean.png

Options

FlagDescriptionDefault
--output <path>Custom output path<filename>_no_bg.png

image-enhance

Upscales and improves image quality using fal.ai nano-banana-2 edit model.

kappmaker image-enhance logo.png
kappmaker image-enhance photo.jpg --output improved.png

Options

FlagDescriptionDefault
--output <path>Custom output path<filename>_enhanced.png