Skip to content

Image Toolkit v0.1.0

Latest

Choose a tag to compare

@glitter-gim glitter-gim released this 17 Nov 14:58

Image Toolkit is a lightweight, self-hosted image conversion and editing application built with Python, FastAPI, Uvicorn, and Pillow.

This initial release focuses on providing a practical image-processing environment that can run locally on Windows, Linux, and macOS without requiring an external image conversion service.

Features

Image Conversion

  • Convert images between supported formats, including JPEG, PNG, WebP, and AVIF.
  • HEIC/HEIF support when the required codec is available.
  • Adjust image dimensions and output quality.
  • Process multiple images in a single batch.

Image Editing

  • Resize and crop images.
  • Apply image adjustments.
  • Add watermarks.
  • Handle image orientation using EXIF metadata.

Batch Processing

  • Process multiple images through background jobs.
  • Monitor job progress and status.
  • Download processed images and ZIP archives.
  • Manage temporary job files with automatic cleanup.

Web Interface

  • Responsive browser-based interface.
  • Light and dark themes.
  • Multilingual interface.
  • Image selection, editing, output, and job history workspaces.

API

  • REST API powered by FastAPI.
  • Interactive OpenAPI documentation.
  • SQLite-based job metadata storage.

Self-Hosting

Image Toolkit is designed for local self-hosting.

  • Backend: Python + FastAPI + Uvicorn
  • Image Processing: Pillow
  • Database: SQLite
  • Frontend: HTML, CSS, and JavaScript
  • Deployment: Windows, Linux, and macOS

The same application stack can be used across development and deployment environments.

Quick Start

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
uvicorn app.main:app --host 127.0.0.1 --port 9781

On Windows, activate the virtual environment with:

.venv\Scripts\Activate.ps1

Then open:

http://127.0.0.1:9781

For detailed installation and configuration instructions, see [README.md](https://github.com/glitter-node/image-toolkit/blob/main/README.md).

Windows Auto-Start

A PowerShell startup script and Windows Task Scheduler guide are included for users who want to start Image Toolkit automatically after signing in.

See [Windows Auto-Start Guide](https://github.com/glitter-node/image-toolkit/blob/main/docs/WINDOWS_AUTOSTART.md).

Live Demo

Web interface:

https://image-toolkit.glitter.kr/

API documentation:

https://image-toolkit.glitter.kr/docs

The live demo is provided as a reference deployment. Image Toolkit is primarily intended for self-hosted use.

Notes

  • Supported image formats depend on the installed Pillow build and available codecs.
  • Image processing uses server-side resources.
  • Job metadata is stored in SQLite, while job files are managed separately.
  • Temporary job files are subject to automatic cleanup.
  • Windows and macOS installation behavior may vary by environment.

Release Information


Image Toolkit v0.1.0 marks the first public release of the project, providing a foundation for local, self-hosted image conversion and editing.