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:
imw.mp4
The tool currently supports various popular image matching algorithms, namely:
| Algorithm | Supported | Conference/Journal | Year | GitHub Link |
|---|---|---|---|---|
| MINIMA | ✅ | ARXIV | 2024 | Link |
| XoFTR | ✅ | CVPR | 2024 | Link |
| EfficientLoFTR | ✅ | CVPR | 2024 | Link |
| MASt3R | ✅ | CVPR | 2024 | Link |
| DUSt3R | ✅ | CVPR | 2024 | Link |
| OmniGlue | ✅ | CVPR | 2024 | Link |
| XFeat | ✅ | CVPR | 2024 | Link |
| RoMa | ✅ | CVPR | 2024 | Link |
| DeDoDe | ✅ | 3DV | 2024 | Link |
| Mickey | ❌ | CVPR | 2024 | Link |
| GIM | ✅ | ICLR | 2024 | Link |
| ALIKED | ✅ | ICCV | 2023 | Link |
| LightGlue | ✅ | ICCV | 2023 | Link |
| DarkFeat | ✅ | AAAI | 2023 | Link |
| SFD2 | ✅ | CVPR | 2023 | Link |
| IMP | ✅ | CVPR | 2023 | Link |
| ASTR | ❌ | CVPR | 2023 | Link |
| SEM | ❌ | CVPR | 2023 | Link |
| DeepLSD | ❌ | CVPR | 2023 | Link |
| GlueStick | ✅ | ICCV | 2023 | Link |
| ConvMatch | ❌ | AAAI | 2023 | Link |
| LoFTR | ✅ | CVPR | 2021 | Link |
| SOLD2 | ✅ | CVPR | 2021 | Link |
| LineTR | ❌ | RA-L | 2021 | Link |
| DKM | ✅ | CVPR | 2023 | Link |
| NCMNet | ❌ | CVPR | 2023 | Link |
| TopicFM | ✅ | AAAI | 2023 | Link |
| AspanFormer | ✅ | ECCV | 2022 | Link |
| LANet | ✅ | ACCV | 2022 | Link |
| LISRD | ❌ | ECCV | 2022 | Link |
| REKD | ❌ | CVPR | 2022 | Link |
| CoTR | ✅ | ICCV | 2021 | Link |
| ALIKE | ✅ | TMM | 2022 | Link |
| RoRD | ✅ | IROS | 2021 | Link |
| SGMNet | ✅ | ICCV | 2021 | Link |
| SuperPoint | ✅ | CVPRW | 2018 | Link |
| SuperGlue | ✅ | CVPR | 2020 | Link |
| D2Net | ✅ | CVPR | 2019 | Link |
| R2D2 | ✅ | NeurIPS | 2019 | Link |
| DISK | ✅ | NeurIPS | 2020 | Link |
| Key.Net | ❌ | ICCV | 2019 | Link |
| OANet | ❌ | ICCV | 2019 | Link |
| SOSNet | ✅ | CVPR | 2019 | Link |
| HardNet | ✅ | NeurIPS | 2017 | Link |
| SIFT | ✅ | IJCV | 2004 | Link |
Just try it on 
or deploy it locally following the instructions below.
Update: now support install from pip, just run:
pip install imcuigit 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 .or using docker:
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=7860Deploy to Railway, setting up a Custom Start Command in Deploy section:
python -m imcui.api.serverpython app.py --config ./config/config.yamlthen open http://localhost:7860 in your browser.
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.
IMCUI hosts all models on Huggingface. You can upload your model to Huggingface and add it to the Realcat/imcui_checkpoints repository.
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:
- support pip install command
- add CPU CI
- add webcam support
- add line feature matching algorithms
- example to add a new feature extractor / matcher
- ransac to filter outliers
- add rotation images options before matching
- support export matches to colmap (#issue 6)
- add config file to set default parameters
- dynamically load models and reduce GPU overload
Adding local features / matchers as submodules is very easy. For example, to add the GlueStick:
git submodule add https://github.com/cvg/GlueStick.git imcui/third_party/GlueStickIf remote submodule repositories are updated, don't forget to pull submodules with:
git submodule update --init --recursive # init and download
git submodule update --remote # updateif you only want to update one submodule, use git submodule update --remote imcui/third_party/GlueStick.
To format code before committing, run:
pre-commit run -a # Auto-checks and fixesThis code is built based on Hierarchical-Localization. We express our gratitude to the authors for their valuable source code.
