Imaginary

A fast, simple, and scalable HTTP microservice for high-level image processing powered by libvips. Process images on the fly via a clean RESTful API.

What You Can Do After Deployment

1. Resize images -- send an image URL or upload a file and get a resized version instantly
2. Crop and thumbnail -- generate thumbnails or crop images to specific dimensions
3. Apply effects -- blur, sharpen, rotate, flip, and adjust brightness or contrast
4. Convert formats -- transform between JPEG, PNG, WebP, TIFF, GIF, and more
5. Add watermarks -- overlay text or image watermarks on the fly

Key Features

• RESTful API supporting resize, crop, rotate, flip, zoom, thumbnail, and more
• Format conversion (JPEG, PNG, WebP, TIFF, GIF, PDF, SVG)
• Blur, sharpen, brightness, contrast, and gamma adjustments
• Image watermarking and pipeline operations
• Remote URL image fetching and processing
• Stateless and horizontally scalable -- no storage needed
• Health check endpoint at /health
• Built on libvips for high performance and low memory usage

License

MIT -- GitHub