peasy-image 0.1.0

Python image toolkit — resize, crop, rotate, convert, compress, blur, sharpen, watermark, and 12 more operations. Powered by Pillow.

peasy-image

Python image toolkit — resize, crop, rotate, compress, convert, blur, sharpen, watermark, and 12 more operations. Powered by Pillow.

Every function accepts bytes | Path | str and returns bytes — works with files, HTTP responses, and in-memory buffers.

Try the interactive tools at peasyimage.com

Install

pip install peasy-image          # Core (Pillow)
pip install "peasy-image[cli]"   # + CLI (typer, rich)
pip install "peasy-image[mcp]"   # + MCP server
pip install "peasy-image[all]"   # Everything

Quick Start

from peasy_image import resize, compress, info, convert

# Resize maintaining aspect ratio
resized = resize("photo.jpg", width=800)

# Compress to JPEG at quality 60
compressed = compress("photo.png", quality=60, fmt="jpeg")

# Convert to WebP
webp = convert("photo.jpg", fmt="webp")

# Get image info
meta = info("photo.jpg")
print(f"{meta.width}x{meta.height} {meta.format} ({meta.file_size / 1024:.0f} KB)")

Operations

Function	Description
resize	Resize with aspect ratio preservation
crop	Crop to bounding box (left, top, right, bottom)
rotate	Rotate by angle with optional canvas expansion
flip	Flip horizontal, vertical, or both
compress	Reduce file size via quality adjustment
convert	Convert between PNG, JPEG, WebP, GIF, BMP, TIFF
grayscale	Convert to grayscale
blur	Gaussian blur
sharpen	Sharpen with adjustable factor
brightness	Adjust brightness
contrast	Adjust contrast
invert	Invert colors
watermark	Add text watermark at any anchor position
thumbnail	Center-crop square thumbnail
strip_metadata	Remove all EXIF/metadata
info	Get dimensions, format, mode, EXIF presence
get_exif	Extract EXIF metadata fields
border	Add solid color border
round_corners	Apply rounded corners with transparency
pad	Pad to target dimensions with centering
overlay	Overlay one image on another

CLI

peasy-image resize photo.jpg --width 800
peasy-image compress photo.png --quality 60
peasy-image convert photo.bmp webp
peasy-image info photo.jpg
peasy-image watermark photo.jpg "© 2026"
peasy-image thumbnail photo.jpg --size 128

MCP Server

{
  "mcpServers": {
    "peasy-image": {
      "command": "uvx",
      "args": ["--from", "peasy-image[mcp]", "python", "-m", "peasy_image"]
    }
  }
}

License

MIT