Welcome to your comprehensive guide on utilizing GlueStick, a robust image matching tool that expertly combines points and lines for enhanced image analysis. This blog will walk you through installation, running GlueStick, and training your own models using the GlueFactory setup. Let’s dive in!
What is GlueStick?
GlueStick is a joint deep matcher for points and lines that has garnered attention for its robust image matching capabilities. Accepted at the ICCV 2023 conference, it’s designed to help researchers and developers tackle image matching challenges effectively.
Installing GlueStick
To install GlueStick on Ubuntu 22.04, follow the steps outlined below:
- Install the required packages:
sudo apt-get install build-essential cmake libopencv-dev libopencv-contrib-dev
git clone --recursive https://github.com/cvg/GlueStick.git
cd GlueStick
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
pip install -e .
Running GlueStick
To execute GlueStick, you’ll first need to download the model weights:
wget https://github.com/cvg/GlueStick/releases/download/v0.1_arxiv/checkpoint_GlueStick_MD.tar -P resources/weights
Now, you can run GlueStick with two images:
python -m gluestick.run -img1 resources/img1.jpg -img2 resources/img2.jpg
Training Models Using GlueFactory
If you want to train models, the training code is provided in a separate repository, GlueFactory. This allows you to train GlueStick and explore other deep matchers like LightGlue with various feature extraction and evaluation options.
Troubleshooting
While using GlueStick, you may encounter some issues. Here are a few troubleshooting tips:
- If you experience installation errors, ensure your dependencies are correctly installed and that you are using the supported Ubuntu version (22.04).
- For issues running the model, confirm that the image paths are accurate and that the model weights download finished successfully.
- In case of any error messages, check the GitHub repository’s issue section to see if others have encountered similar problems.
For more insights, updates, or to collaborate on AI development projects, stay connected with fxis.ai.
Final Thoughts
At fxis.ai, we believe that such advancements are crucial for the future of AI, as they enable more comprehensive and effective solutions. Our team is continually exploring new methodologies to push the envelope in artificial intelligence, ensuring that our clients benefit from the latest technological innovations.

