LibreAI / Image / Real-ESRGAN
// image · xinntao/Real-ESRGAN

Real-ESRGAN

Real-ESRGAN — practical blind super-resolution for real-world photos and video: restores and upscales degraded images with models trained on pure synthetic data, BSD-3-Clause

★ 37.1k stars⑂ 4.5k forksBSD-3-Clauseupdated 2024-08
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

Real-ESRGAN is an open-source image project by xinntao (xinntao/Real-ESRGAN on GitHub). It has 37,147 GitHub stars and 4,495 forks, is released under the BSD-3-Clause license, and was last updated on GitHub on 6 August 2024.

GitHub stars
37,147
Forks
4,495
License
BSD-3-Clause
Last updated on GitHub
6 August 2024
Category
Image
Listing
Full install guide
// how it works

How it works

  1. Install it

    Clone the repo and install the requirements, or install the realesrgan package from PyPI (with basicsr, facexlib and gfpgan) per the README dependencies section.

  2. Download a model

    Fetch the pretrained weights for your job — RealESRGAN_x4plus for general photos, the anime_6B model for illustrations, or the general-x4v3 model when you want denoising control with -dn.

  3. Run inference

    Run inference_realesrgan.py with your input folder and chosen model; use --outscale for an arbitrary final scale and --face_enhance to chain GFPGAN face restoration.

// features

Why people love it

Blind real-world restoration

Trained on synthetic degradations that mimic real damage, so it restores photos — not just clean downscales — convincingly.

A model for each job

General x4plus, a compact anime model, anime-video models and the denoise-tunable realesr-general-x4v3, all in the model zoo.

Face enhancement built in

Integrates GFPGAN so portraits get face-aware restoration in the same pass with --face_enhance.

No-install portable builds

Official ncnn-vulkan executables for Windows, Linux and macOS run upscaling without any Python environment.

Advertisement
// run it

Run it yourself

  1. Install from PyPI

    The package route from the README ecosystem.

    pip install basicsr facexlib gfpgan
    pip install realesrgan
  2. Clone and run inference

    The repo route: install requirements, then run the inference script on a folder of images.

    git clone https://github.com/xinntao/Real-ESRGAN.git
    cd Real-ESRGAN
    pip install -r requirements.txt
    python inference_realesrgan.py -n RealESRGAN_x4plus -i inputs -o results
  3. Portable executable

    Download realesrgan-ncnn-vulkan for your OS from the v0.2.5.0 release and run it directly — no Python needed.

    https://github.com/xinntao/Real-ESRGAN/releases
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who makes Real-ESRGAN?

Xintao Wang and co-authors at Tencent ARC Lab and the Shenzhen Institutes of Advanced Technology (xinntao/Real-ESRGAN on GitHub); the paper is arXiv 2107.10833.

Is Real-ESRGAN free?

Yes — BSD-3-Clause licensed, including for commercial use, subject to the licence terms. Check the licences of any model weights you add.

Is it still maintained?

Honestly: it is a mature, stable codebase — its last push was 2024-08-06 — rather than an actively evolving one. It remains the reference implementation and is embedded in many other tools.

How does it compare to a well-known alternative?

Against GFPGAN from the same lab family, Real-ESRGAN is the general image/video restorer and GFPGAN is the face specialist — they are designed to chain together. Against newer diffusion upscalers, Real-ESRGAN is far faster and more predictable, with less invented detail.

How do I get started?

pip install realesrgan (plus basicsr, facexlib, gfpgan), download the x4plus weights, and run inference_realesrgan.py on a test folder — or grab the portable ncnn build if you want zero setup.

// keep exploring

Similar tools

Image

nextgenUp

Free local upscaler — 8K photos and 4K video with Real-ESRGAN, no cloud

★ 65 starsMIT
View guide →
Image

RealScaler

Real-ESRGAN image and video upscaler app with GPU acceleration

★ 428 starsMIT
View guide →
Image

ImageUpscaler

Simple Flask web app that upscales low-res images with AI

★ 129 starsMIT
View guide →
Image

Janus

DeepSeek's Janus series - unified multimodal models that both understand and generate images

★ 17.8k starsMIT
View guide →
Image

awesome-nano-banana-pro-prompts

🍌 World's largest Nano Banana Pro prompt library — 10,000+ curated prompts with preview images, 16 languages. Google Gemini AI image generation. Free & open …

★ 13.5k starsUnknown
View guide →
Image

SimpleTuner

A general fine-tuning kit geared toward image/video/audio diffusion models.

★ 2.9k starsAGPL-3.0
View guide →
// alternatives

Alternatives in Image

The most-starred other Image projects in the LibreAI catalogue — the realistic shortlist if Real-ESRGAN is not the right fit.

Get Real-ESRGAN

Free and open — grab the source, star the repo, and start creating.