Fix photos by telling them what’s wrong
It lets you repair degraded images by writing plain-English instructions to a single all-in-one model.

What it does
InstructIR is an all-in-one image restoration model that takes a degraded photo and a human-written instruction, then attempts to fix it. It handles denoising, deraining, deblurring, dehazing, and low-light enhancement without requiring separate task-specific models. The authors claim it beats prior all-in-one approaches by roughly +1 dB on standard benchmarks.
The interesting bit
Instead of relying on technical degradation labels or hidden metadata, the model parses free-form natural language prompts—anything from “remove the raindrops” to “make it look stunning.” The authors deliberately skipped diffusion models to keep the pipeline simple and efficiency-focused, targeting high-fidelity output over generative flair.
Key highlights
- Single model handles five restoration tasks guided by text prompts.
- Authors report state-of-the-art results on several benchmarks and a +1 dB improvement over previous all-in-one methods.
- Not diffusion-based; optimized for fidelity and speed rather than generative variety.
- Includes a Hugging Face demo, Colab notebook, and pre-trained weights for immediate experimentation.
- Serves as a benchmark dataset and baseline for text-guided image restoration research.
Caveats
- The FAQ explicitly warns that the model struggles to generalize to real-world images, so expect benchmark-happy behavior that may falter on your vacation snapshots.
- Weights for the 3D and 5D variants mentioned in the README are still listed as TODO and not yet uploaded.
Verdict
Worth a look if you research computational photography or need a unified restoration baseline. Skip it if you need a production-grade tool for arbitrary real-world photos today.
Frequently asked
- What is mv-lab/InstructIR?
- It lets you repair degraded images by writing plain-English instructions to a single all-in-one model.
- Is InstructIR open source?
- Yes — mv-lab/InstructIR is open source, released under the MIT license.
- What language is InstructIR written in?
- mv-lab/InstructIR is primarily written in Jupyter Notebook.
- How popular is InstructIR?
- mv-lab/InstructIR has 743 stars on GitHub.
- Where can I find InstructIR?
- mv-lab/InstructIR is on GitHub at https://github.com/mv-lab/InstructIR.