git404hub

what is supir fr?

fanghua-yu/supir — explained in plain English

Analysis updated 2026-06-26

5,529PythonAudience · researcherComplexity · 5/5Setup · hard

tl;dr

SUPIR is an academic AI tool that restores damaged, blurry, or low-resolution photos using large image and language models, producing sharper and more detailed results guided by a text description of the image.

vibe map

mindmap
  root((repo))
    What it does
      Photo restoration
      AI upscaling
      Noise removal
    Models
      Stable Diffusion XL
      LLaVA vision model
    Interfaces
      Command line
      Gradio browser UI
    Requirements
      Multi-GPU machine
      Large model downloads

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Upscale and restore old, low-resolution family photos to high-resolution sharp images.

VIBE 2

Denoise and sharpen blurry or noisy photos for professional-quality output.

VIBE 3

Batch-process a folder of damaged images through an AI restoration pipeline via command line or browser UI.

what's the stack?

PythonPyTorchStable Diffusion XLLLaVAGradio

how it stacks up fr

fanghua-yu/supirshawn-shan/fawkescog-creators/red-discordbot
Stars5,5295,5275,532
LanguagePythonPythonPython
Setup difficultyhardeasymoderate
Complexity5/52/53/5
Audienceresearchergeneralgeneral

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · hard time til it works · 1day+

Requires a multi-GPU machine with at least 12GB VRAM and several multi-gigabyte model files downloaded before first use.

in plain english

SUPIR is a research project from a group of academic institutions in China and Australia, published at the CVPR 2024 computer vision conference. It is a system for restoring damaged or low-quality photographs, meaning it can take a blurry, noisy, or low-resolution image and produce a sharper, cleaner, more detailed version of it. The underlying approach combines two technologies. One is a large image-generation model called Stable Diffusion XL, which provides a strong prior about what realistic images look like. The other is a visual understanding model called LLaVA, which analyzes the image and generates a text description that guides the restoration process. By using the text description as context, the system can produce restorations that are more consistent with the actual content of the original photo rather than inventing arbitrary details. Setting up SUPIR requires downloading several large model files, some of which are multiple gigabytes in size. The setup instructions assume familiarity with Python environments and command-line tools. Running the restoration process requires a machine with multiple graphics cards due to the memory demands of the models involved. The README describes a lower-memory configuration for machines with 12 to 16 gigabytes of GPU memory, but this mode is slower. There is also an online version of the tool at a website called SupPixel AI for people who want to try it without running the software locally. The project offers two pre-trained models. One is optimized for general image quality across a range of restoration challenges. The other is better suited for photos with light degradation, where the goal is to preserve as much original detail as possible rather than re-generate it from scratch. Users run restoration jobs by pointing the tool at a folder of input images and specifying an output folder, an upscaling factor, and various quality control parameters. A browser-based interface using a library called Gradio is also available as an alternative to the command-line workflow.

prompts (copy fr)

prompt 1
Show me how to run SUPIR on a folder of blurry JPEGs to upscale them 4x using the command-line tool.
prompt 2
How do I launch the SUPIR Gradio web interface and restore a single low-quality photo step by step?
prompt 3
What SUPIR parameters should I set to preserve original photo detail rather than letting the AI regenerate it from scratch?

Frequently asked questions

what is supir fr?

SUPIR is an academic AI tool that restores damaged, blurry, or low-resolution photos using large image and language models, producing sharper and more detailed results guided by a text description of the image.

What language is supir written in?

Mainly Python. The stack also includes Python, PyTorch, Stable Diffusion XL.

How hard is supir to set up?

Setup difficulty is rated hard, with roughly 1day+ to a first successful run.

Who is supir for?

Mainly researcher.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.