🎮 Demo Preview

Interact with caution. Content generated by third-party code.

💻 Usage

Install SDK

pip install gradio

Run Locally

git clone https://huggingface.co/spaces/Realcat/image-matching-webui

Space Overview

[![Contributors][contributors-shield]][contributors-url] [![Forks][forks-shield]][forks-url] [![Stargazers][stars-shield]][stars-url] [![Issues][issues-shield]][issues-url]

Image Matching WebUI
Matching Keypoints between two images

Description

Image Matching WebUI (IMCUI) efficiently matches image pairs using multiple famous image matching algorithms. The tool features a Graphical User Interface (GUI) designed using gradio. You can effortlessly select two images and a matching algorithm and obtain a precise matching result. Note: the images source can be either local images or webcam images.

Try it on function r(){document.querySelectorAll(".markdown-copy-btn").forEach(t=>{t.getAttribute("data-init")||(t.setAttribute("data-init","true"),t.addEventListener("click",async()=>{const n=t,i=n.dataset.code||"",e=n.querySelector(".btn-text"),o=n.querySelector(".btn-icon");try{await navigator.clipboard.writeText(i),e&&(e.textContent="Done!"),o&&(o.textContent="✅"),setTimeout(()=>{e&&(e.textContent="Copy"),o&&(o.textContent="📋")},2e3)}catch(c){console.error("Copy failed",c)}}))})}r();document.addEventListener("astro:after-swap",r);

[![Contributors][contributors-shield]][contributors-url] [![Forks][forks-shield]][forks-url] [![Stargazers][stars-shield]][stars-url] [![Issues][issues-shield]][issues-url]

Image Matching WebUI
Matching Keypoints between two images

Description

Image Matching WebUI (IMCUI) efficiently matches image pairs using multiple famous image matching algorithms. The tool features a Graphical User Interface (GUI) designed using gradio. You can effortlessly select two images and a matching algorithm and obtain a precise matching result. Note: the images source can be either local images or webcam images.

Try it on

Here is a demo of the tool:

https://github.com/Vincentqyw/image-matching-webui/assets/18531182/263534692-c3484d1b-cc00-4fdc-9b31-e5b7af07ecd9

The tool currently supports various popular image matching algorithms, namely:

| Algorithm | |------------------|--------- | RIPE | ✅ | ICCV | RDD | ✅ | CVPR | LiftFeat | ✅ | ICRA | DaD | ✅ | ARXIV | MINIMA | ✅ | ARXIV | XoFTR | ✅ | CVPR | EfficientLoFTR | ✅ | CVPR | MASt3R | ✅ | CVPR | DUSt3R | ✅ | CVPR | OmniGlue | ✅ | CVPR | XFeat | ✅ | CVPR | RoMa | ✅ | CVPR | DeDoDe | ✅ | 3DV | Mickey | ❌ | CVPR | GIM | ✅ | ICLR | ALIKED | ✅ | ICCV | LightGlue | ✅ | ICCV | DarkFeat | ✅ | AAAI | SFD2 | ✅ | CVPR | IMP | ✅ | CVPR | ASTR | ❌ | CVPR | SEM | ❌ | CVPR | DeepLSD | ❌ | CVPR | GlueStick | ✅ | ICCV | ConvMatch | ❌ | AAAI | LoFTR | ✅ | CVPR | SOLD2 | ✅ | CVPR | LineTR | ❌ | RA-L | DKM | ✅ | CVPR | NCMNet | ❌ | CVPR | TopicFM | ✅ | AAAI | AspanFormer | ✅ | ECCV | LANet | ✅ | ACCV | LISRD | ❌ | ECCV | REKD | ❌ | CVPR | CoTR | ✅ | ICCV | ALIKE | ✅ | TMM | RoRD | ✅ | IROS | SGMNet | ✅ | ICCV | SuperPoint | ✅ | CVPRW | SuperGlue | ✅ | CVPR | D2Net | ✅ | CVPR | R2D2 | ✅ | DISK | ✅ | Key.Net | ❌ | ICCV | OANet | ❌ | ICCV | SOSNet | ✅ | CVPR | HardNet | ✅ | SIFT | ✅ | IJCV Supported | Conference/Journal | Year | GitHub Link | --|--------------------|------|-------------| | 2025 | Link | | 2025 | Link | | 2025 | Link | | 2025 | Link | | 2024 | Link | | 2024 | Link | | 2024 | Link | | 2024 | Link | | 2024 | Link | | 2024 | Link | | 2024 | Link | | 2024 | Link | | 2024 | Link | | 2024 | Link | | 2024 | Link | | 2023 | Link | | 2023 | Link | | 2023 | Link | | 2023 | Link | | 2023 | Link | | 2023 | Link | | 2023 | Link | | 2023 | Link | | 2023 | Link | | 2023 | Link | | 2021 | Link | | 2021 | Link | | 2021 | Link | | 2023 | Link | | 2023 | Link | | 2023 | Link | | 2022 | Link | | 2022 | Link | | 2022 | Link | | 2022 | Link | | 2021 | Link | | 2022 | Link | | 2021 | Link | | 2021 | Link | | 2018 | Link | | 2020 | Link | | 2019 | Link | | NeurIPS | 2019 | Link | | NeurIPS | 2020 | Link | | 2019 | Link | | 2019 | Link | | 2019 | Link | | NeurIPS | 2017 | Link | | 2004 | Link |

How to use

HuggingFace / Lightning AI

Just try it on

or deploy it locally following the instructions below.

Requirements

Python 3.9+

#### Install from pip [NEW]

Update: now support install from pip, just run:

bash

pip install imcui

#### Install from source

``bash git clone --recursive https://github.com/Vincentqyw/image-matching-webui.git cd image-matching-webui conda env create -f environment.yaml conda activate imw pip install -e .


        
          code
          
        
        or using docker:


     bash
docker pull vincentqin/image-matching-webui:latest
docker run -it -p 7860:7860 vincentqin/image-matching-webui:latest python app.py --server_name "0.0.0.0" --server_port=7860


          code


        <h3 class="text-lg font-semibold mt-6 mb-3 text-gray-900 dark:text-white">Deploy to Railway</h3>Deploy to Railway, setting up a Custom Start Command in Deploy section:


     bash
python -m imcui.api.server
      

        
          code
          
        
        <h3 class="text-lg font-semibold mt-6 mb-3 text-gray-900 dark:text-white">Run demo</h3>
      
     bash
python app.py --config ./config/config.yaml


          code


        then open http://localhost:7860 in your browser.
<h3 class="text-lg font-semibold mt-6 mb-3 text-gray-900 dark:text-white">Add your own feature / matcher</h3>I provide an example to add local feature in imcui/hloc/extractors/example.py. Then add feature settings in confs in file imcui/hloc/extract_features.py. Last step is adding some settings to matcher_zoo in file imcui/ui/config.yaml.
<h3 class="text-lg font-semibold mt-6 mb-3 text-gray-900 dark:text-white">Upload models</h3>
IMCUI hosts all models on Huggingface.  You can upload your model to Huggingface and add it to the Realcat/imcui_checkpoints repository.

<h2 class="text-xl font-bold mt-8 mb-4 text-gray-900 dark:text-white">Contributions welcome!</h2>
External contributions are very much welcome. Please follow the PEP8 style guidelines using a linter like flake8. This is a non-exhaustive list of features that might be valuable additions:
[x] support pip install command

[x] add CPU CI
[x] add webcam support
[x] add line feature matching algorithms
[x] example to add a new feature extractor / matcher
[x] ransac to filter outliers
[ ] add rotation images options before matching
[ ] support export matches to colmap (#issue 6)
[x] add config file to set default parameters
[x] dynamically load models and reduce GPU overload

Adding local features / matchers as submodules is very easy. For example, to add the GlueStick:


     bash
git submodule add https://github.com/cvg/GlueStick.git imcui/third_party/GlueStick
      

        
          code
          
        
        If remote submodule repositories are updated, don't forget to pull submodules with:
      
     bash
git submodule update --init --recursive  # init and download
git submodule update --remote  # update
      

        
          code
          
        
        if you only want to update one submodule, use git submodule update --remote imcui/third_party/GlueStick.To format code before committing, run:
      
    bash
pre-commit run -a  # Auto-checks and fixes

``

Contributors

Resources

Acknowledgement

This code is built based on Hierarchical-Localization. We express our gratitude to the authors for their valuable source code.

[contributors-shield]: https://img.shields.io/github/contributors/Vincentqyw/image-matching-webui.svg?style=for-the-badge [contributors-url]: https://github.com/Vincentqyw/image-matching-webui/graphs/contributors [forks-shield]: https://img.shields.io/github/forks/Vincentqyw/image-matching-webui.svg?style=for-the-badge [forks-url]: https://github.com/Vincentqyw/image-matching-webui/network/members [stars-shield]: https://img.shields.io/github/stars/Vincentqyw/image-matching-webui.svg?style=for-the-badge [stars-url]: https://github.com/Vincentqyw/image-matching-webui/stargazers [issues-shield]: https://img.shields.io/github/issues/Vincentqyw/image-matching-webui.svg?style=for-the-badge [issues-url]: https://github.com/Vincentqyw/image-matching-webui/issues

11,768 characters total

image-matching-webui

Best Scenarios

Technical Constraints

🕸️ Neural Graph Explorer

📈 Interest Trend

🕸️ Neural Graph Explorer

📈 Interest Trend

🔬Deep Dive

🛠️ Technical Profile

⚡ Hardware & Scale

🌐 Cloud & Rights

🎮 Demo Preview

💻 Usage

Space Overview

Image Matching WebUI
Matching Keypoints between two images

Description

Image Matching WebUI
Matching Keypoints between two images

Description

How to use

HuggingFace / Lightning AI

Requirements

Contributors

Resources

Acknowledgement

Welcome to Free2AI Tools!

Smart Search

FNI Score

You're All Set!

Best Scenarios

Technical Constraints

🕸️ Neural Graph Explorer

📈 Interest Trend

🕸️ Neural Graph Explorer

📈 Interest Trend

🔬Deep Dive

🛠️ Technical Profile

⚡ Hardware & Scale

🌐 Cloud & Rights

🎮 Demo Preview

💻 Usage

Space Overview

Image Matching WebUI Matching Keypoints between two images

Description

Image Matching WebUI Matching Keypoints between two images

Description

How to use

HuggingFace / Lightning AI

Requirements

Contributors

Resources

Acknowledgement

Image Matching WebUI
Matching Keypoints between two images

Image Matching WebUI
Matching Keypoints between two images