# ImageFlow

> Self-hosted, open-source image management and delivery platform that converts to WebP/AVIF, serves device-aware images, and offers a random-image API with tag filters.

- **Category:** Image Management
- **Licence:** MIT
- **Latest version:** v3.0
- **Open source:** oss
- **Languages:** Typescript, Go
- **Platforms:** Docker Compose
- **Tags:** Redis, Photos, Tagging, Object Storage, Avif, Webp, Image Hosting, S3, Image management, Self Hosted, Image Optimization, Image api, Libvips, Random Image, CDN Alternative

## Description

ImageFlow is a full-stack image hosting and delivery platform for people running their own image service for websites and applications. Uploaded pictures are converted to WebP and AVIF by a libvips-powered Go backend, and each visit is served the best format the browser supports (AVIF first, then WebP, then the original). It can also pick a portrait or landscape variant depending on the device, which makes it handy as a random-wallpaper endpoint. A Next.js 14 web UI covers drag-and-drop batch uploads, tagging, browsing and deletion, while a public REST API endpoint (GET /api/random) serves images filtered by tags, orientation and format. Files live on the local filesystem or in any S3-compatible bucket, Redis stores metadata and tag indexes, and images can be given an expiry time after which they are deleted automatically. Management endpoints are guarded by an API key. Self-hosting is a three-container Docker Compose stack; the project is MIT-licensed with stable releases up to v3.0.

## Links

- [Homepage](https://github.com/Yuri-NagaSaki/ImageFlow)
- [Website](https://imageflowdoc.sakiko.de/)
- [Docker](soyorins/imageflow-backend)
- [ImageFlow docs (English overview)](https://imageflowdoc.sakiko.de/imageflow/en/overview)

---
Source: https://selfhost.directory/project/imageflow