Save 4 hours! We auto-setup your workflow! Free!

Drop your workflow.json — we handle every dependency, custom node, and model. Just open the link and run.

Auto-Setup Workflow Json (Free) Now!
ComfyUI > Nodes > ComfyUI-PhotoDeblur

ComfyUI Extension: ComfyUI-PhotoDeblur

Repo Name

ComfyUI-PhotoDeblur

Author
porfeng (Account age: 756 days)
Nodes
View all nodes(5)
Latest Updated
2026-11-11
Github Stars
0.09K

How to Install ComfyUI-PhotoDeblur

Install this extension via the ComfyUI Manager by searching for ComfyUI-PhotoDeblur
  • 1. Click the Manager button in the main menu
  • 2. Select Custom Nodes Manager button
  • 3. Enter ComfyUI-PhotoDeblur in the search bar
After installation, click the Restart button to restart ComfyUI. Then, manually refresh your browser to clear the cache and access the updated list of nodes.

Visit ComfyUI Online for ready-to-use ComfyUI environment

  • Free trial available
  • 16GB VRAM to 80GB VRAM GPU machines
  • 400+ preloaded models/nodes
  • Freedom to upload custom models/nodes
  • 200+ ready-to-run workflows
  • 100% private workspace with up to 200GB storage
  • Dedicated Support

Run ComfyUI Online

ComfyUI-PhotoDeblur Description

ComfyUI-PhotoDeblur uses HI-Diff and MISCFilter to reduce camera shake and motion blur, restoring photos at original resolution with tiled processing, optional TTA, and tone matching.

ComfyUI-PhotoDeblur Introduction

ComfyUI-PhotoDeblur brings two photo-restoration models—HI-Diff and MISCFilter—into ComfyUI. It helps reduce camera shake and motion blur, making it easier to prepare photographs for further editing, color grading, or cropping.

Instead of simply sharpening every edge, these models use patterns learned from blurred and sharp images to estimate a clearer result. Depending on your photograph, this can improve lettering, architectural lines, object outlines, and other details affected by movement.

The extension includes:

  • Two deblurring models, each with three pretrained variants.
  • Original-resolution processing, so you can restore large photographs without first resizing them.
  • Tiled processing and overlap blending to process smaller sections and combine them into one image.
  • Optional test-time augmentation (TTA), which combines several predictions of the same image.
  • Optional tone matching to reduce broad color changes introduced during restoration.
  • Official model downloads with file verification.

Which photographs are worth trying?

Photograph typeDetails to inspect
Handheld night and indoor photographsLight trails, sign lettering, window frames, and furniture edges
Architecture, storefronts, and street scenesStraight lines, text outlines, and repeating textures
Portraits and event photographsMild to moderate shake around facial features, hair, and clothing
Animals and moving subjectsMotion trails around the subject, as well as nearby areas that were already sharp
High-resolution photographsFine details at the original dimensions before cropping or downsizing

Restoration has limits. Strong defocus, clipped highlights, very small faces, and severe blur can leave too little information for a convincing recovery. A clearer-looking result is not proof that every reconstructed detail is accurate.

The author reports noticeable improvements in signage and some structural edges in a bookstore night photograph. Results on night portraits varied, while a small, heavily blurred stage face and a cat’s face showed limited improvement in some tests. These observations come from a small photo set, not a guarantee for every image.

How ComfyUI-PhotoDeblur Works

1. A model estimates a sharper image

Both supported models restore a photograph without requiring you to describe the camera movement that caused the blur.

HI-Diff combines two approaches:

  • A diffusion model creates a compact set of guidance features—a kind of learned set of clues about how the restored image might look.
  • A deblurring network uses those clues at several image scales to estimate the clearer photograph.

An analogy is an artist first working out the overall structure, then using that structure to guide finer corrections. HI-Diff performs its diffusion process in a compact internal representation rather than repeatedly generating the entire full-resolution image from noise.

MISCFilter uses motion-adaptive filtering. It estimates filtering behavior suited to the blur in the image and combines this with learned reconstruction. Think of it as adjusting the corrective treatment to different patterns of movement rather than applying one uniform sharpening filter everywhere.

MISCFilter uses a direct network pass and does not have a sampling-step setting.

2. Large images are processed in tiles

A high-resolution photograph can require more GPU memory than is available. The extension divides it into smaller sections called tiles, restores those sections, and combines them at the original image size.

Imagine restoring a large mural one section at a time:

  • Tile size determines how much of the mural is handled at once.
  • Overlap lets neighboring sections share some of the same image area.
  • Blending combines those shared areas to soften transitions.

Tiling preserves the image dimensions; it is not an upscaling feature.

3. Optional TTA combines multiple views

Test-time augmentation, or TTA, processes eight flipped or rotated versions of the image and averages their predictions after returning them to the original orientation.

This gives the model several views of the same content. It can produce a different result worth comparing, but it requires roughly eight times the model computation. It does not guarantee a better restoration.

4. Optional tone matching limits broad color shifts

Restoration can change an image’s overall tone or color. The optional tone-matching node compares the restored image with the original and corrects broad differences.

More specifically, it subtracts a Gaussian-blurred version of the difference between the two images. In everyday terms, it aims to bring large-scale color and brightness back toward the original while retaining the restored detail.

ComfyUI-PhotoDeblur Quick Start

The supplied workflows are the simplest way to begin:

  1. Open example_workflows.
  2. Drag ComfyUI-PhotoDeblur.json onto the ComfyUI canvas. It includes English and Chinese notes.
  3. Select your photograph in Load Image.
  4. Choose a model and variant in the matching model loader.
  5. If using the download node, select the same model and variant there.
  6. Run the workflow and compare the restored image with the original.

The basic connections are:

Download Deblur Models.ready → Model Loader.download_ready
Load Image → Deblur Image (Tiled).image
Model Loader → Deblur Image (Tiled).deblur_model
Deblur Image (Tiled) IMAGE → Save Image

The download connection is optional when the required model weights are already available.

To switch from MISCFilter to HI-Diff, connect the HI-Diff Model Loader instead. If you use the downloader, switch its model selection to HI-Diff too.

Start with:

SettingStarting value
VariantRealBlur_J
Tile size768
Overlap96
Blendcomfy_linear
TTAOff
HI-Diff steps0
HI-Diff seed100

Try both models on the same original image before adjusting other settings. Compare the results at matching zoom levels, especially around text, faces, and high-contrast edges.

If GPU memory is limited, start with tile size 512, overlap 64, and TTA off.

ComfyUI-PhotoDeblur Features and Controls

Available nodes

Search for Photo Deblur on the ComfyUI canvas.

NodeWhat it does
Download Deblur ModelsDownloads official model weights and verifies the downloaded files
HI-Diff Model LoaderSelects HI-Diff weights and sampling steps
MISCFilter Model LoaderSelects MISCFilter weights
Deblur Image (Tiled)Restores the image using tiles, overlap blending, and optional TTA
Match Input Tone (Optional)Uses the original image to reduce broad tone and color changes in the restored result

Tile size and overlap

tile_size controls the size of each processed section.

  • Start at 768.
  • Try 512 if you encounter a GPU-memory error.
  • Larger tiles are an option to compare, not an automatic quality upgrade.

overlap controls how much neighboring tiles share.

  • Use 96 as a starting point with tiles of 768.
  • Use 64 as a starting point with tiles of 512.
  • Overlap must be smaller than tile size.

Overlapping areas give the extension room to transition between restored sections.

Blend mode

blend selects how overlapping tile predictions are combined.

Available modes are:

  • comfy_linear — the recommended starting choice.
  • cosine
  • gaussian
  • average

These are different weighting strategies for the shared areas between tiles. If transitions look distracting, compare the alternatives while keeping the rest of your settings unchanged. There is no single documented best mode for every photograph.

TTA

tta enables the eight-view prediction averaging described above.

Leave it off while choosing your model and variant. Once you have a promising result, save a separate TTA version and decide whether the difference is worth the additional processing time.

HI-Diff seed

seed controls HI-Diff’s random prior—the guidance generated by its diffusion component.

Start at 100. Keep the seed unchanged when comparing tile sizes or other settings so that you are not also changing the random guidance.

HI-Diff sampling steps

steps applies only to HI-Diff.

A value of 0 selects the variant’s default:

  • RealBlur_J: 16 steps
  • RealBlur_R: 16 steps
  • GoPro: 8 steps

Here, 0 does not mean “skip restoration.” More steps are an option to test, but they are not a guarantee of a better image.

MISCFilter has no equivalent sampling-step control.

Download verification and repair

The download node uses official Google Drive archives and checks them using SHA256 verification, a file-integrity check. Verified local files are reused rather than downloaded again.

repair_invalid is normally off. When enabled, it backs up mismatched files before replacing them. Use it when you need to repair a file that fails verification, rather than as a routine quality setting.

Tone-matching sigma

sigma belongs to the optional tone-matching node.

  • Start with 16.
  • Set it to 0 to bypass correction.

Sigma controls the blur scale used to identify broad differences between the original and restored images. It is not a deblurring-strength slider.

Compare tone matching on and off, particularly when the restored result is sharper but its overall color no longer matches the source.

ComfyUI-PhotoDeblur Models

The extension supports two model families, each with three pretrained variants. A pretrained model contains the learned information used to perform restoration; its variant reflects the dataset used during training.

Model families

ModelApproachWhen to try it
HI-DiffCombines compact diffusion-generated guidance with a deblurring networkWhen you want to compare diffusion-guided restoration and its seed or step options
MISCFilterUses motion-adaptive collaborative filtering and learned reconstructionWhen you want a direct restoration pass without sampling-step choices

Neither model is documented as the best choice for all photographs. One may produce more pleasing lettering while the other gives a better overall appearance on the same image. Judge both local detail and the whole photograph.

All available variants

ModelVariantTraining basis and suggested use
HI-DiffRealBlur_JTrained on RealBlur-J; the recommended starting variant for ordinary real-photo comparisons
HI-DiffRealBlur_RTrained on RealBlur-R; an alternative to compare on the same photograph
HI-DiffGoProTrained on the GoPro blur dataset; another option when the RealBlur variants are not satisfactory
MISCFilterRealBlur_JTrained on RealBlur-J; the recommended starting variant for a first comparison
MISCFilterRealBlur_RTrained on RealBlur-R; useful as an alternative restoration
MISCFilterGoProTrained on the GoPro blur dataset; useful for comparing behavior learned from a different dataset

RealBlur_R is a checkpoint variant, not a camera RAW input mode. Develop RAW photographs before loading them, regardless of which variant you select.

Different training datasets can change how a model handles edges and textures. The variant name alone does not tell you which will work best on your photograph.

Official model downloads

The workflow’s download node can retrieve and verify these weights. The official archives are also available here:

ModelVariantOfficial archive
HI-DiffRealBlur-JHI_Diff_RealBlur_J.zip
HI-DiffRealBlur-RHI_Diff_RealBlur_R.zip
HI-DiffGoProHI_Diff_GoPro.zip
MISCFilterAll three variantscheckpoints.zip

ComfyUI-PhotoDeblur Before-and-After Examples

Each comparison shows the original on the left and the restored result on the right, cropped from the same area at the same scale. Click an image to open the full-size comparison.

HI-Diff: street signs

Look for clearer lettering and architectural edges.

HI-Diff street signs: original on the left and restored on the right

HI-Diff: storefront

Look for reduced camera shake around signs and outlines.

HI-Diff storefront: original on the left and restored on the right

MISCFilter: camera display

Look for clearer camera and lens outlines.

MISCFilter camera display: original on the left and restored on the right

MISCFilter: colorful wafer

Look for reduced ghosting along grid lines and circular edges.

MISCFilter colorful wafer: original on the left and restored on the right

MISCFilter: city at night

Look for reduced light trails on buildings. This example uses TTA and tone matching with sigma 16.

MISCFilter city at night: original on the left and restored on the right

ComfyUI-PhotoDeblur Color and Output Quality

Prepare your image

Use display-referred sRGB images. For camera RAW files, complete RAW development first, then load an sRGB TIFF or PNG.

A practical editing order is:

  1. Develop the RAW file, if applicable.
  2. Restore blur in ComfyUI.
  3. Compare the result with the original.
  4. Continue color grading, cropping, or downsizing.

Internal precision versus saved precision

Inference and blending use FP32 RGB/RGBA tensors at the original image dimensions. Output values are in the 0–1 range.

This internal precision does not mean every saved file is automatically high-bit-depth:

  • Input precision for 16-bit TIFF and PNG depends on the image loader.
  • Standard Save Image writes 8-bit PNG.
  • For further color grading, use Save Image (Advanced) → PNG → 16-bit → sRGB, when available.

Preserve intentional blur

Background blur may be part of your composition, especially in panning shots or shallow-depth-of-field portraits.

If you only want to restore the subject, blend the restored image with the original using a mask in your photo editor. This lets you retain intentional background softness.

Troubleshooting ComfyUI-PhotoDeblur

The workflow reports missing model weights

  1. Check which model loader is connected to Deblur Image (Tiled).
  2. Confirm that the downloader uses the same model family and variant.
  3. Connect Download Deblur Models.ready to the loader’s download_ready input.
  4. Run the workflow again.

If you use manually managed weights, check the expected structure in ComfyUI’s configured model directory:

models/
├── HI-Diff/
│   ├── HI_Diff_RealBlur_J/
│   │   ├── net_g.pth
│   │   ├── net_le_dm.pth
│   │   └── net_d.pth
│   ├── HI_Diff_RealBlur_R/
│   │   └── [the same three filenames]
│   └── HI_Diff_GoPro/
│       └── [the same three filenames]
└── MISCFilter/
    ├── RealBlur_J.pth
    ├── RealBlur_R.pth
    └── GoPro.pth

Each HI-Diff variant requires its own matching set of three files. Avoid an extra archive-folder level in the final paths. ComfyUI Desktop may use a model directory inside your chosen data directory.

When loading manually managed weights, disconnect or remove the download node.

A model file fails verification

  1. Confirm that you selected the intended model and variant.
  2. Enable repair_invalid in the download node.
  3. Run the download again.

The repair option backs up mismatched files before replacing them.

The workflow runs out of GPU memory

  1. Reduce tile_size to 512.
  2. Set overlap to 64.
  3. Turn TTA off.
  4. Run the same photograph again.

These are the author’s suggested lower-memory starting settings.

Processing is much slower with TTA

  1. Check whether TTA is enabled.
  2. Turn it off for your initial comparisons.
  3. Re-enable it only for a separate final test.

TTA performs roughly eight times the model computation. HI-Diff sampling steps also affect how much processing is performed; begin with steps = 0.

MISCFilter reports a missing CuPy dependency

  1. Check whether the error specifically mentions CuPy.
  2. Verify that the MISCFilter dependency requirements were applied to ComfyUI’s own Python environment, not another Python installation.
  3. For the documented NVIDIA/CUDA 12 setup, the relevant dependency file is requirements-misc-cu12.txt.

A CUDA or NVRTC error appears

  1. Check that the CuPy package matches the CUDA setup.
  2. Check the local CUDA Toolkit and CUDA_PATH.
  3. Refer to the extension repository for the project’s setup guidance.

These are environment issues rather than image-quality settings.

Tone matching reports that cv2 is missing

  1. Confirm that the error comes from the optional tone-matching stage.
  2. Check that OpenCV is available in ComfyUI’s Python environment; the project provides requirements-tone.txt for this dependency.
  3. Bypass the optional tone-matching stage if you want to continue testing deblurring without it.

A TIFF thumbnail appears blank

  1. Connect the image to Preview Image.
  2. Check the actual image there before assuming that the TIFF failed to load.

A blank thumbnail alone is not sufficient to judge the loaded image.

The result looks different in color

  1. Confirm that your input is a developed sRGB image.
  2. Compare the restored image with the original.
  3. Try Match Input Tone (Optional) with sigma 16.
  4. Compare against sigma 0, which bypasses correction.

The result is sharper, but faces or textures look worse

  1. Compare both models using the original photograph as input.
  2. Keep the zoom level consistent.
  3. Try another variant before adding TTA or more HI-Diff steps.
  4. Inspect areas that were already sharp, not just the blurred subject.
  5. For noisy inputs, check whether shadow texture has been smoothed away or amplified.

Very small faces, severe blur, and defocus may remain difficult even after changing settings.

Frequently asked questions

Does this extension upscale images?
No. Its tiled processing restores images at their original dimensions.

Does steps = 0 disable HI-Diff?
No. It selects 16 steps for RealBlur-J/R and 8 steps for GoPro.

Can I load a RAW file by selecting RealBlur-R?
No. RealBlur-R identifies the pretrained weights. Develop RAW files first.

Are larger tiles, more steps, or TTA always better?
No. Treat them as comparison options and choose by the result on your photograph.

Will restored text always be correct?
Do not assume so. Better-looking lettering is not proof that missing characters have been recovered accurately. Verify important text against a reliable source.

How do I keep background bokeh or panning blur?
Blend the restored subject with the original using a mask in your photo editor.

Why is my saved PNG only 8-bit?
Standard Save Image writes 8-bit PNG. Use an available advanced saver configured for 16-bit sRGB PNG when you need that output.

Learn More about ComfyUI-PhotoDeblur

Practical resources

Model background

The upstream repositories also contain research training and testing instructions. Those are separate from using the ComfyUI nodes; you do not need to train a model to use the supplied pretrained weights.

ComfyUI-PhotoDeblur Credits and License

ComfyUI-PhotoDeblur integrates these upstream projects:

  • HI-Diff — NeurIPS 2023; Apache-2.0 license.
  • MISCFilter — CVPR 2024; MIT license.

The extension’s node integration code is provided under the MIT license. See THIRD_PARTY.md for upstream notices and port changes.

Model weights are downloaded separately from upstream sources.

ComfyUI-PhotoDeblur Related Nodes

RunComfy
Copyright 2025 RunComfy. All Rights Reserved.

RunComfy is the premier ComfyUI platform, offering ComfyUI online environment and services, along with ComfyUI workflows featuring stunning visuals. RunComfy also provides AI Models, enabling artists to harness the latest AI tools to create incredible art.

ComfyUI-PhotoDeblur detailed guide | ComfyUI