← all repositories
mv-lab/InstructIR

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.

743 stars Jupyter Notebook Computer VisionImage · Video · Audio
InstructIR
Not currently ranked — collecting fresh signals.
star history

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.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.