Repository navigation
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 9781On Windows, activate the virtual environment with:
.venv\Scripts\Activate.ps1Then 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
- Version: v0.1.0
- Release Type: Initial Public Release
- Repository: https://github.com/glitter-node/image-toolkit
- Git Tag:
v0.1.0
Image Toolkit v0.1.0 marks the first public release of the project, providing a foundation for local, self-hosted image conversion and editing.