✨ Image Upscaler Pro

Image Upscaler Pro Application

Interactive Desktop Application featuring Catppuccin Mocha theme, side-by-side / split slider before-and-after view, quality presets, and clarity metrics.

Upscaling low-resolution macro photography (300 ×ばつ 300 px ➔ 1200 ×ばつ 1200 px 4x HD). Restores specular highlight water droplets, seed texture crispness, and vibrant red tone.

Strawberry Macro Comparison

Upscaling low-resolution digital illustration (300 ×ばつ 300 px ➔ 1200 ×ばつ 1200 px 4x HD). Cleans color banding noise, sharpens linework edges, and boosts glowing vibrance.

Anime Art Comparison

• 🚀 Multi-Scale Resolution Multiplier: Upscale by 2x, 4x, 8x, or custom dimensions using Lanczos4 high-fidelity resampling.
• 🔬 Micro-Detail Synthesizer: Recovers subtle surface textures, skin pores, water droplets, hair strands, fabric patterns, and line art crispness without halo artifacts.
• 🪄 One-Click Auto-Optimizer: Automatically analyzes input blurriness and noise variance to set optimal sharpening, contrast, and denoise values.
• 📊 Real-Time Clarity Score Metric: Calculates Laplacian variance before and after upscaling to display exact percentage gains in sharpness (e.g. +25% to +377% Clarity Boost).
• ↔ 60FPS Silky-Smooth Split Viewer: Interactive comparison view that allows instant side-by-side or split slider inspection.
• 🎨 CLAHE Adaptive Contrast: Restores hidden details in dark shadows and bright highlights in LAB color space.
• 🛡️ Bilateral Noise Reduction: Eliminates JPEG compression grain and digital sensor noise pre-upscaling.
• 📁 Directory Batch Processor: Upscale hundreds of photos automatically with one click.
• 💻 Cross-Platform Scriptable CLI: Full command-line interface for batch scripting and server integration.

# Clone the repository
git clone https://github.com/blazecodeprakhar/image-enhancer.git
cd image-enhancer
# Install required packages
pip install -r requirements.txt

Run main.py without arguments:

python main.py

1. Open Image: Click 📁 Choose Image File... or drag an image into the application.
2. Select Scale: Choose 2x Scale, 4x Scale, or 8x Scale.
3. Select Preset: Pick a profile (Ultra Photo Enhancer, Anime & Illustration, Text & Documents, Balanced) or click 🪄 Auto-Optimize Quality.
4. Enhance & Inspect: Click ✨ UPSCALE & ENHANCE. Drag the split slider left/right to compare Before vs After.
5. Save Output: Click 💾 Save Image... to export PNG, JPEG, or WebP.

Run single image or directory upscaling headlessly using cli.py:

# Single image 2x upscale
python cli.py -i input.png -o output_hd.png -s 2.0
# 4x scale with Ultra Photo profile
python cli.py -i photo.jpg -o photo_4k.png -s 4.0 -p "Ultra Photo Enhancer"
# Batch folder processing
python cli.py -i ./input_photos -o ./upscaled_photos -s 2.0 -p "Balanced (Default)"

├── main.py # Main application launcher (GUI / CLI router)
├── gui.py # Desktop GUI with 60FPS split comparison canvas
├── cli.py # Command-line interface for automation & batching
├── upscaler_engine.py # Core processing engine (Micro-detail, CLAHE, Denoise)
├── assets/ # App screenshot & test comparison visuals
├── requirements.txt # Python dependencies (Pillow, OpenCV, NumPy)
├── LICENSE # MIT Open Source License
└── README.md # Repository documentation

Distributed under the MIT License. See LICENSE for details.