This simple tool 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.
Here is a demo of the tool:
The tool currently supports various popular image matching algorithms, namely:
or deploy it locally following the instructions below.
git clone --recursive https://github.com/Vincentqyw/image-matching-webui.git
cd image-matching-webui
conda env create -f environment.yaml
conda activate imw
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=7860
Deploy to Railway, setting up a Custom Start Command
in Deploy
section:
python -m api.server
python ./app.py
then open http://localhost:7860 in your browser.
I provide an example to add local feature in hloc/extractors/example.py. Then add feature settings in confs
in file hloc/extract_features.py. Last step is adding some settings to matcher_zoo
in file ui/config.yaml.
External contributions are very much welcome. Please follow the PEP8 style guidelines using a linter like flake8 (reformat using command python -m black .
). This is a non-exhaustive list of features that might be valuable additions:
Adding local features / matchers as submodules is very easy. For example, to add the GlueStick:
git submodule add https://github.com/cvg/GlueStick.git third_party/GlueStick
If remote submodule repositories are updated, don't forget to pull submodules with:
git submodule init
git submodule update --remote
if you only want to update one submodule, use git submodule update --remote third_party/GlueStick
.
This code is built based on Hierarchical-Localization. We express our gratitude to the authors for their valuable source code.