README.md

metadata

title: Real-ESRGAN Dual-Mode Image Upscaler
emoji: 🖼️
colorFrom: blue
colorTo: green
sdk: gradio
sdk_version: 5.31.0
app_file: app.py
pinned: false
license: mit

🖼️ SpectraGAN Dual-Mode Image Upscaler

A lightweight Gradio web app to upscale any image using the Real-ESRGAN model. Simply upload your photo, choose either Standard Upscale (×4) or Premium Upscale (×8), and download the upscaled image.

---

📑 Table of Contents

1. Features
2. Project Structure
3. Prerequisites
4. Installation
5. Running Locally
6. Usage
7. Contributing
8. License
9. Author & Credits

---

✨ Features

• Standard Upscale (×4)
  Enhance image resolution by 4x for clearer and larger images.

• Premium Upscale (×8)
  Upscales first to 4x and then resizes using bicubic interpolation for even higher resolution (8x).

• Live Preview
  See your original and upscaled images side by side before downloading.

• Instant Download
  Export the upscaled image as a PNG and use it immediately.

---

📁 Project Structure

upscale-project/
├── model/
│ └── Real-ESRGAN-x4plus.onnx # ONNX model for upscaling
├── app.py # Main application file
├── requirements.txt # List of Python dependencies
├── .gitignore # Git ignore file to exclude unnecessary files
├── LICENSE # License file for the project
└── README.md # Project documentation

---

---

⚙️ Prerequisites

• Python 3.10 or higher
• git
• A terminal / command prompt

---

🔧 Installation

1. Clone this repository:

   git clone https://github.com/salmanalfarisi11/Upscaler_images.git
   cd Upscaler_images
   

2. Create and activate a virtual environment:

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

3. Install dependencies:

   pip install -r requirements.txt
   

🚀 Running Locally

Launch the app on your machine:

python app.py

By default, it will start on http://127.0.0.1:7860/. Open that URL in your browser to access the interface.

🎯 Usage

1. Upload Photo via the left panel.
2. Choose a Mode:
   • Click Standard Upscale (×4) for a 4x resolution increase.
   • Click Premium Upscale (×8) for an 8x resolution increase.
3. Preview your result on the right side.
4. Click Download PNG to save the upscaled image.

Acknowledgements

This project uses the Real-ESRGAN model developed by Xintao Wang. The model is available under the BSD 3-Clause License.