True Image Upscaler

Overview

The True Image Upscaler is a desktop application built with Python and Tkinter, designed to enhance image resolution using AI-powered Real-ESRGAN models. It provides a user-friendly interface for upscaling images, with options for different models tailored for photos and anime-style art.

Features

• AI-Powered Upscaling: Utilizes Real-ESRGAN models for high-quality image enlargement.
• Photo and Anime Modes: Choose between models optimized for photographic content or anime/cartoon art.
• Drag-and-Drop Interface: Easily load images by dragging them onto the application window.
• Image Preview: View a thumbnail preview of your image before and after upscaling.
• Standalone Executable: Distributed as a single executable for Windows, requiring no Python installation.

Installation (Windows)

1. Download the latest release: Visit the GitHub Releases page to download the latest version.
2. Choose your download:
   • Installer (TrueImageUpscaler_Setup.exe): Recommended for most users. Run the installer and follow the on-screen instructions.
   • Portable Executable (true_image_upscaler.exe): Download the executable directly. No installation required; simply run the .exe file.

Usage

1. Load Image: Drag and drop an image file (JPG, PNG, etc.) onto the designated area in the application window.
2. Select Model: Choose between "Photo" (for general images) or "Anime" (for anime/cartoon art) from the dropdown menu.
3. Select Scale: Currently, only "4x" upscaling is supported for stability.
4. Upscale: Click the "Upscale Image" button. The processed image will be saved in the same directory as the input file, with _x4.png appended to its name.

Building from Source (for Developers)

Prerequisites

• Python 3.8+
• pip (Python package installer)
• git (for cloning the repository)

Setup

1. Clone the repository:

   git clone https://github.com/AjarnSpencer/True-Image-Upscaler.git
   cd True-Image-Upscaler

2. Create a virtual environment (recommended):

   python -m venv venv
   .\venv\Scripts\activate # On Windows
   # source venv/bin/activate # On Linux/macOS

3. Install dependencies:

   pip install -r requirements.txt

   (Note: A requirements.txt file will be generated and committed in a future update.)

Running the application

python true_image_upscaler.py

Building the executable with PyInstaller

pip install pyinstaller
pyinstaller true_image_upscaler.spec

The executable will be found in the dist folder.

Contributing

Contributions are welcome! Please feel free to open issues or submit pull requests.

Authorship

• Main Developer: Ajarn Spencer Littlewood (www.ajarnspencer.com)
• Co-authored by: Gemini CLI Unleashed

License

This project is licensed under the Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) License.