README.md

April 9, 2026 · View on GitHub

StarIR: Convolutional Image Restoration with Spatial-Frequency Fusion

:star: If StarIR is helpful for you, please help star this repo. Thanks! :hugs:

:new: News

  • 2026.04.09: :fire: This repo is released

⚙️ Setup

See INSTALL.md for the installation of dependencies required to run StarIR.

:wrench: Training and Evaluation

Training and Testing instructions for Deraining, Dehazing, Desnowing, Motion deblurring, Defocus deblurring, Low-light enhancement, Low-light deblurring, and all-in-one tasks are provided in their respective directories. Here is a summary table containing hyperlinkes for easy navigation.

TaskInstructionsStarIR's Visual ResultsPre-trained ModelsDatasets
Deraining
Link
Google Drive, 百度网盘
Google Drive, 百度网盘
Google Drive, 百度网盘
Dehazing
Link
Google Drive, 百度网盘
Google Drive, 百度网盘
Google Drive, 百度网盘
Desnowing
Link
Google Drive, 百度网盘
Google Drive, 百度网盘
Google Drive, 百度网盘
Motion deblurring
Link
Google Drive, 百度网盘
Google Drive, 百度网盘
Google Drive, 百度网盘
Defocus deblurring
Link
Google Drive, 百度网盘
Google Drive, 百度网盘
Google Drive, 百度网盘
Low-light enhancement
Link
Google Drive, 百度网盘
Google Drive, 百度网盘
Google Drive, 百度网盘
Low-light deblurring
Link
Google Drive, 百度网盘
Google Drive, 百度网盘
Google Drive, 百度网盘
All-in-one
Link
Google Drive, 百度网盘
Google Drive, 百度网盘
All_in_One, 百度网盘
UHD
[Link]
[Google Drive], 百度网盘
Google Drive, 百度网盘
CDD
[Link]
[Google Drive], 百度网盘
Google Drive, 百度网盘

💫 Demo

To test the pre-trained StarIR models of Single_Image_Defocus_Deblurring, Dehazing, Deraining, Desnowing, Low_Light_Deblurring, Low_Light_Enhancement, and Motion_Deblurring on your own images, you can download the models, place them in the /pretrained_models/ of the corresponding tasks (e.g., ./Motion_Deblurring/pretrained_models/StarIR-GOPRO.pth), then run

python demo.py --task Task_Name --input_dir path_to_images --result_dir save_images_here

Example usage to perform Defocus Deblurring on a directory of images:

python demo.py --task Single_Image_Defocus_Deblurring --input_dir './demo/degraded/' --result_dir './demo/restored/'

Example usage to perform Defocus Deblurring on an image directly:

python demo.py --task Single_Image_Defocus_Deblurring --input_dir './demo/degraded/portrait.jpg' --result_dir './demo/restored/'

For all-in-one demo, please refer to All_in_One

:notebook: Citation

Please cite us if our work is useful for your research.

@article{cui2026starir,
  title={StarIR: Convolutional Image Restoration With Spatial-Frequency Fusion},
  author={Cui, Yuning and Zamir, Syed Waqas and Yang, Ming-Hsuan and Knoll, Alois and Khan, Fahad Shahbaz and Khan, Salman},
  journal={IEEE Transactions on Pattern Analysis and Machine Intelligence},
  year={2026}
}

:envelope: Contact

Should you have any question, please contact yuning.cui@in.tum.de