{"id":19517444,"url":"https://github.com/cvg/gluestick","last_synced_at":"2025-05-15T14:08:47.144Z","repository":{"id":151109337,"uuid":"622867606","full_name":"cvg/GlueStick","owner":"cvg","description":"Joint Deep Matcher for Points and Lines 🖼️💥🖼️ (ICCV 2023)","archived":false,"fork":false,"pushed_at":"2025-04-07T12:20:12.000Z","size":36558,"stargazers_count":610,"open_issues_count":10,"forks_count":50,"subscribers_count":15,"default_branch":"main","last_synced_at":"2025-05-09T22:03:27.802Z","etag":null,"topics":["computer-vision","deep-learning","graph-neural-networks","image-matching","local-features","machine-learning","torch"],"latest_commit_sha":null,"homepage":"https://iago-suarez.com/gluestick","language":"Jupyter Notebook","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cvg.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-04-03T08:19:25.000Z","updated_at":"2025-05-09T07:53:18.000Z","dependencies_parsed_at":null,"dependency_job_id":"5bf59e1d-998e-4345-913c-f6476d39b723","html_url":"https://github.com/cvg/GlueStick","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cvg%2FGlueStick","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cvg%2FGlueStick/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cvg%2FGlueStick/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cvg%2FGlueStick/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cvg","download_url":"https://codeload.github.com/cvg/GlueStick/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254355335,"owners_count":22057354,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["computer-vision","deep-learning","graph-neural-networks","image-matching","local-features","machine-learning","torch"],"created_at":"2024-11-11T00:03:25.975Z","updated_at":"2025-05-15T14:08:42.131Z","avatar_url":"https://github.com/cvg.png","language":"Jupyter Notebook","funding_links":[],"categories":[],"sub_categories":[],"readme":"# GlueStick\n[![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/cvg/GlueStick/blob/main/gluestick_matching_demo.ipynb) [![arXiv](https://img.shields.io/badge/arXiv-2304.02008-b31b1b.svg?style=flat)](https://arxiv.org/abs/2304.02008) [![Project Page](https://badgen.net/badge/color/project/green?icon=awesome\u0026label)](https://iago-suarez.com/gluestick)\n\nJoint deep matcher for points and lines 🖼️💥🖼️\n\n**Update: we are pleased to announce that the training code has been released within our new training framework, [GlueFactory](https://github.com/cvg/glue-factory).**\n\n![Visualization of point and line matches](resources/demo_seq1.gif)\n\nThis repository contains the official implementation of \n[GlueStick: Robust Image Matching by Sticking Points and Lines Together](https://arxiv.org/abs/2304.02008), accepted at ICCV 2023.\n\n## Install 🛠️\n\nTo install the software in Ubuntu 22.04 follow these instructions:\n```bash\nsudo apt-get install build-essential cmake libopencv-dev libopencv-contrib-dev\ngit clone --recursive https://github.com/cvg/GlueStick.git\ncd GlueStick\n# Create and activate a virtual environment\npython -m venv venv\nsource venv/bin/activate\npip install -r requirements.txt\npip install .\n```\n\n## Running GlueStick 🏃\nDownload the weights of the model:\n```\nwget https://github.com/cvg/GlueStick/releases/download/v0.1_arxiv/checkpoint_GlueStick_MD.tar -P resources/weights\n```\n\nYou can execute the inference with it with:\n```\npython -m gluestick.run -img1 resources/img1.jpg -img2 resources/img2.jpg\n```\n\n## Training 🏋️\nThe training code is available in a separate repository, [GlueFactory](https://github.com/cvg/glue-factory). Within GlueFactory, you can not only train GlueStick, but also other deep matchers such as [LightGlue](https://github.com/cvg/LightGlue), use multiple feature extractors, line extractors, robust estimators, as well as run evaluations on multiple benchmarks.\n\n## Licence 📜\nOur code is licenced under [MIT licence](https://github.com/cvg/GlueStick/blob/main/LICENSE).\nHowever, bear in mind that it uses a SuperPoint backbone that has a \n[non-commercial licence](https://github.com/magicleap/SuperPointPretrainedNetwork/blob/master/LICENSE). \nTherefore, the overall system is non-commercial 😞. We are working on an analogous version based on \n[DISK](https://github.com/cvlab-epfl/disk) to avoid this problem.\n\n## Citation 📝\nIf you use this code in your project, please consider citing the following paper:\n```bibtex\n@InProceedings{pautrat_suarez_2023_gluestick,\n    title={{GlueStick}: Robust Image Matching by Sticking Points and Lines Together},\n    author={Pautrat, R{\\'e}mi* and Su{\\'a}rez, Iago* and Yu, Yifan and Pollefeys, Marc and Larsson, Viktor},\n    booktitle={International Conference on Computer Vision (ICCV)},\n    year={2023}\n}\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcvg%2Fgluestick","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcvg%2Fgluestick","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcvg%2Fgluestick/lists"}