Nuggan

Image optimizer HTTP micro-service & utilities based on libvips.

Motivation

Nuggan provides a lightweight image proxy for on-the-fly cropping and resizing. Unlike many alternatives, it works with any existing web-hosted images without requiring additional infrastructure or DNS control.

Quick Start

Run as a standalone HTTP service:

./nuggan -server ':8080' -server-config server.conf

Documentation

• Usage Guide — How to run (standalone, Docker, configuration)
• API Reference — Request format, parameters, and examples
• Build & Development — Building from source, testing, SSE control
• Deployment — Production deployment options (standalone, serverless, AWS Lambda)
• Dependencies — Dependency management with Dependabot

For a complete overview, see docs/index.md.

Build Locally

Prerequisites: libvips (macOS: port install vips)

go build
go test -v nuggan

See Build & Development for full build instructions including SSE control for Apple Silicon.

License

See LICENSE file.