Mage

Warning

This project was developed mostly with AI agents. It is for learning and experimentation, and is not recommended for production use.

Go image processing service powered by libvips.

Mage generates thumbnails on-the-fly, supports local/S3 storage backends, and includes multi-layer caching for performance.

Highlights

• Thumbnail generation via URL-based API
• Local filesystem and S3/S3-compatible storage support
• Optional HMAC request signature validation
• Memory + disk caching with async disk writes
• Docker and docker-compose support

Quick Start

git clone https://github.com/sashko-guz/mage.git
cd mage
cp .env.example .env
cp storage.local.example.json storage.json
go run ./cmd/server

You can configure runtime settings from .env (for example LOG_LEVEL=error).

Documentation

• Getting Started
• Configuration
• URL API and Filters
• Signature Generation
• Caching
• S3 HTTP Client Optimization
• Project Structure

Inspiration & Thanks

• cshum/vipsgen
• cshum/imagor

License

Project is created for learning purposes and is NOT RECOMMENDED FOR PRODUCTION usage