cyberneticransomware/python-image-processing repository overview

⁠Python Image Processing Base (Alpine)

This is the Python Image Processing Base Docker image, built on top of Python 3.13.6 (Alpine).
It provides a preconfigured, lightweight container environment with essential native libraries for advanced image and multimedia processing in Python.
It is designed to be used as a base image for other projects that require consistent and optimized dependencies for tasks such as computer vision, format conversion, and image manipulation.

This Docker image is maintained by Cybernetic-Ransomware⁠.

Updated: 2025-08-13

Image version 1.0.0 includes a full set of Alpine system libraries for JPEG, PNG, WebP, AVIF, TIFF, OpenJPEG, OpenBLAS, GTK+3, libvips, FFTW, GIF, SVG (librsvg), and ORC, along with the uv package manager and the latest pip.

⁠Source Code

The source code for building this Docker image can be found at:
https://github.com/Cybernetic-Ransomware/python-image-processing-base⁠

⁠Requirements

• Docker or Docker Desktop

⁠How to Run the Container (Windows / Linux / macOS)

Pull the image and run it interactively in a container shell:

docker pull cyberneticransomware/python-image-processing:1.0.0
docker run -it --rm cyberneticransomware/python-image-processing:1.0.0 sh

This opens a minimal Alpine shell with Python 3.13.6 and all required libraries preinstalled.

⁠Using as a Base Image in Your Project

In your Dockerfile, use the image as the starting point:

FROM cyberneticransomware/python-image-processing:1.0.0 AS builder

WORKDIR /src
COPY pyproject.toml uv.lock ./
RUN uv sync --no-cache --no-group dev

COPY src .

CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8080"]

⁠Included Libraries and Tools

• Build tools: build-base, cmake, ninja
• Image processing libs: libjpeg-turbo, libpng, libwebp, libavif, tiff, openjpeg, giflib, librsvg, vips
• Math / processing: openblas, fftw, orc
• Other: gtk+3.0
• Python tooling: latest pip and uv