Image & Design
GIMP CLI
Batch image processing, filters, watermarks & format conversion
✓ 107 tests passed
Install
$ pip install cli-anything-gimp
About
Full programmatic control over GIMP via Python-Fu and Pillow. Batch crop, resize, apply filters, add watermarks, convert between formats — all from the command line with structured JSON output for AI agents.
Requirements
GIMP (optional, falls back to Pillow)
Command Reference
| Command | Arguments | Description |
|---|---|---|
detect |
Check GIMP / Pillow availability | |
version |
Show backend versions | |
info |
IMAGE |
Get image metadata (size, mode, EXIF) |
resize |
IMAGE --width W --height H --output OUT |
Resize image |
crop |
IMAGE --x X --y Y --w W --h H --output OUT |
Crop image |
convert |
IMAGE --format png|jpg|webp|... --output OUT |
Convert format |
watermark |
IMAGE --text TEXT --output OUT |
Add text watermark |
filter |
IMAGE --type blur|sharpen|grayscale|... --output OUT |
Apply filter |
batch |
DIR --op resize|convert|... --output-dir OUT |
Batch process folder |
Usage Examples
# Install
$ pip install cli-anything-gimp
# Health check
$ gimp-cli detect
# Get capabilities schema (Agent-ready, no token needed)
$ gimp-cli schema
# Run with JSON output (for AI Agent integration)
$ gimp-cli --json detect
# Example JSON response:
{"width":1920,"height":1080,"mode":"RGB","format":"JPEG","size_bytes":245760}Agent Integration
# Python — call from AI Agent
import subprocess, json
result = subprocess.run(
["gimp-cli", "--json", "detect"],
capture_output=True, text=True
)
data = json.loads(result.stdout)
print(data)
# Discover all commands without credentials:
schema = subprocess.run(
["gimp-cli", "schema"],
capture_output=True, text=True
)
capabilities = json.loads(schema.stdout)