Skip to content

Latest commit

 

History

History
62 lines (47 loc) · 2.21 KB

README.md

File metadata and controls

62 lines (47 loc) · 2.21 KB

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

Rust-Linux Worklflow

image

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
  1. Access the server from port 8000 in localhost.
  2. 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