RealRestorer  by yfyang007

Generalizable image restoration for real-world degradations

Created 2 months ago
279 stars

Top 93.0% on SourcePulse

GitHubView on GitHub
Project Summary

RealRestorer addresses the challenge of generalizable image restoration for diverse real-world degradations, targeting researchers and practitioners. It leverages large-scale image editing models to provide robust restoration capabilities for common issues like blur, compression artifacts, and low light, aiming for improved real-world applicability.

How It Works

The project employs large-scale image editing models for restoration tasks. A key component is its synthetic degradation pipeline, which generates realistic image degradations (blur, haze, noise, rain, moiré, reflection) for training and evaluation. This approach enables the model to generalize better across various real-world image quality issues.

Quick Start & Requirements

  • Installation: Requires Python 3.12. Installation involves setting up a patched diffusers library, followed by project dependencies.
  • Prerequisites: CUDA-enabled GPU, bfloat16 torch dtype support. Recommended input image size is around 1024x1024.
  • Resource Footprint: Peak GPU memory usage is approximately 34 GB with recommended settings.
  • Links: Hugging Face demo, RealIR-Bench, data pipeline, model weights, ComfyUI implementation.

Highlighted Details

  • Released a Hugging Face demo and model weights in March 2026.
  • Introduced RealIR-Bench, a novel benchmark for evaluating real-world image restoration.
  • Provides a degradation pipeline for synthesizing realistic image corruptions.
  • A community implementation for ComfyUI is available.

Maintenance & Community

Community contributions are acknowledged, notably a ComfyUI integration. No specific community channels (e.g., Discord, Slack) or a public roadmap are detailed in the README.

Licensing & Compatibility

The project's license is not specified in the README, posing a significant adoption blocker for commercial or sensitive use cases.

Limitations & Caveats

The Qwen-Image-Edit-2511 version of the model is not yet open-sourced. The "TODO" list indicates ongoing development and potential feature gaps. Performance and memory usage are optimized for 1024x1024 inputs, implying potential trade-offs for other resolutions.

Health Check
Last Commit

2 weeks ago

Responsiveness

Inactive

Pull Requests (30d)
2
Issues (30d)
2
Star History
23 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.