Imaginary is a self-hosted HTTP server for image processing that applies transformations like resizing, cropping, rotating, and format conversion through URL parameters. It operates as a stateless request-response pipeline, processing images fetched from remote URLs or served from a local directory without requiring client-side dependencies.
The server distinguishes itself through its security and access control capabilities, offering optional API key validation, HMAC-signed URL verification, and remote origin whitelisting to restrict which image sources are permitted. It also provides a health and metrics endpoint for monitoring server statistics, and supports chaining multiple operations in a single request by encoding transformations as sequential URL parameters.
Beyond core transformations, the service includes watermark overlay with text or remote images, smart cropping, blur effects, metadata extraction, and placeholder image serving on error. It supports CORS configuration for browser-based access and request concurrency throttling to manage server load.
