---
title: RealRestorer Demo
emoji: 🖼️
colorFrom: blue
colorTo: yellow
sdk: gradio
app_file: app.py
pinned: false
python_version: 3.10
---

# RealRestorer Hugging Face Space

This Space runs the public `RealRestorer/RealRestorer` model with a Gradio interface for single-image restoration.

It is designed as a lightweight Space repo:

- the model weights are loaded from Hugging Face
- the custom RealRestorer-enabled `diffusers` build is installed from the main GitHub repo
- the UI layout follows the existing internal Gradio demo, but is simplified for Spaces deployment

## Notes

- A GPU Space is strongly recommended. The released model is not practical on CPU.
- The default model repo is `RealRestorer/RealRestorer`.
- You can override the model repo with the `REALRESTORER_MODEL_REPO` Space environment variable.

## Local Run

```bash
python -m pip install -r requirements.txt
python app.py
```

## Space Variables

- `REALRESTORER_MODEL_REPO`: optional model repo id, default `RealRestorer/RealRestorer`
- `HF_TOKEN`: optional token if you want to load a private model repo