Warning

Project under active rewrite for Linux and caching optimizations
V0.6.0-beta will be Linux-only | Not production-ready | ⭐ Star for updates

Nano Image Server

---

---

Note

V0.6.0-beta Release date: 02/03/2025
v0.7.0-beta Release date: 09/03/2025
Due to undergoing rewrite the documentation can be outdated.

| Docs | Usage | References |

Nano Image Server is a tiny, blazingly fast service to serve images with support for image operation on fly.

It is truly asynchronous, Memory safe and thread safe. Built upon axum and tokio runtime. The image processing, encoding and decoding are done by the image crate. GPU support and caching are planned before the stable release.

Available Features

1. Low latency Image delivery
2. Caching and Instant Retrieval
3. Basic image operations on fly via url queries

Usage

1. Place Images you need in images folder next to the executable
2. Start the server

./nano_image_server #Linux

3. Access the server from port 8000 in localhost.
4. To get image go to /<imagename>.<format>

---

Image operations

Warning

A plugin based system for image operations is being developed. The provided API can change drastically until stable release.

Availible image operations

Operation	Query	Examples
Resize	resfilter=nearest/triangle/lanczos	resfilter=nearest
Filter	filter=blur/bw/brighten/contrast	filter=blur&f_param=1.0
Transform	transform=fliph/flipv/rotate	transform=rotate&t_param=90
Convert	to=format	to=webp

Supported Formats

Format	Support Level
AVIF	Decode: Yes*, Encode: Lossy
BMP, GIF, ICO, JPEG, PNG	Full Support
WebP	Decode: Yes, Encode: Lossless
TIFF, TGA, PNM, QOI, HDR, EXR	Full Support