https://github.com/cchantep/nuggan
:paperclip: Image optimizer HTTP micro-service & utilities based on libvips (or Discworld god of paperclip)
https://github.com/cchantep/nuggan
golang imaging libvips
Last synced: 13 days ago
JSON representation
:paperclip: Image optimizer HTTP micro-service & utilities based on libvips (or Discworld god of paperclip)
- Host: GitHub
- URL: https://github.com/cchantep/nuggan
- Owner: cchantep
- License: mit
- Created: 2020-01-12T12:55:28.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2026-03-18T20:27:12.000Z (3 months ago)
- Last Synced: 2026-03-19T05:55:05.586Z (3 months ago)
- Topics: golang, imaging, libvips
- Language: Go
- Homepage: https://cchantep.github.io/nuggan/
- Size: 26.1 MB
- Stars: 2
- Watchers: 1
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Nuggan
[](https://circleci.com/gh/cchantep/nuggan)
Image optimizer HTTP micro-service & utilities based on [libvips](https://libvips.github.io/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:
```sh
./nuggan -server ':8080' -server-config server.conf
```
## Documentation
- **[Usage Guide](./docs/usage.md)** — How to run (standalone, Docker, configuration)
- **[API Reference](./docs/api.md)** — Request format, parameters, and examples
- **[Build & Development](./docs/build.md)** — Building from source, testing, SSE control
- **[Deployment](./docs/deployment.md)** — Production deployment options (standalone, serverless, AWS Lambda)
- **[Dependencies](./docs/dependencies.md)** — Dependency management with Dependabot
For a complete overview, see [docs/index.md](./docs/index.md).
## Build Locally
Prerequisites: [libvips](https://libvips.github.io/libvips/install.html) (macOS: `port install vips`)
```sh
go build
go test -v nuggan
```
See [Build & Development](./docs/build.md) for full build instructions including SSE control for Apple Silicon.
## License
See [LICENSE](LICENSE) file.