Refactor: Migrate to vismatch package and clean up codebase

[Vincentqyw]

Summary

This PR introduces major refactoring to simplify the codebase by leveraging the vismatch pip package for image matching algorithms, instead of maintaining them as git submodules.

Key Changes

• Remove all git submodules: Eliminated imcui/third_party/ directory containing ~40 algorithm implementations
• Remove hloc module: Deleted entire imcui/hloc/ directory (8000+ lines of code)
• Migrate to vismatch: All matchers are now dynamically loaded from the vismatch package
• Simplify configuration: Reduce config files from 548+ lines to minimal YAML
• Clean up dependencies: Trimmed requirements.txt from 43 lines to 17 lines

Additional Improvements

• Fix match_threshold parameter not being passed to dense matchers (LoFTR, RoMa)
• Add support for keypoint_threshold parameter
• Update documentation to clarify matchers are maintained in vismatch repository
• Improve config path resolution (check current dir, then fallback to package default)

Breaking Changes

• All matching algorithms must now be installed via vismatch package
• New matchers should be added to the vismatch repository instead of this WebUI

Test plan

• Verify UI loads and displays available matchers
• Test sparse matcher (superpoint-lightglue)
• Test dense matcher (loftr) with match_threshold parameter
• Verify config file loading
• Run existing tests

🤖 Generated with Claude Code

[Vincentqyw]

Linux: Model loading fails after the first successful import. Specifically, loftr loads without issues, but se2loftr, xoftr, ASpanFormer, and MatchAnything cannot be imported.

pytest tests/ -s

Error details:

se2loftr:

  File "/usr/local/lib/python3.13/site-packages/vismatch/__init__.py", line 175, in get_matcher
    from vismatch.im_models import se2loftr
  File "/usr/local/lib/python3.13/site-packages/vismatch/im_models/se2loftr.py", line 11, in <module>
    from configs.loftr.outdoor.loftr_ds_e2_dense_8rot import cfg as rot8_cfg
  File "/usr/local/lib/python3.13/site-packages/vismatch/third_party/Se2_LoFTR/configs/loftr/outdoor/loftr_ds_e2_dense_8rot.py", line 6, in <module>
    cfg.LOFTR.RESNETFPN.NBR_ROTATIONS = 8
    ^^^^^^^^^^^^^^^^^^^
  File "/usr/local/lib/python3.13/site-packages/yacs/config.py", line 141, in __getattr__
    raise AttributeError(name)
AttributeError: RESNETFPN

xoftr:

  File "/app/imcui/ui/config.py", line 142, in get_model
    return get_matcher(model_name, device=DEVICE, **kwargs)
  File "/usr/local/lib/python3.13/site-packages/vismatch/__init__.py", line 180, in get_matcher
    from vismatch.im_models import xoftr
  File "/usr/local/lib/python3.13/site-packages/vismatch/im_models/xoftr.py", line 10, in <module>
    from src.xoftr import XoFTR
ModuleNotFoundError: No module named 'src.xoftr'

ASpanFormer:

  File "/app/imcui/ui/config.py", line 142, in get_model
    return get_matcher(model_name, device=DEVICE, **kwargs)
  File "/usr/local/lib/python3.13/site-packages/vismatch/__init__.py", line 185, in get_matcher
    from vismatch.im_models import aspanformer
  File "/usr/local/lib/python3.13/site-packages/vismatch/im_models/aspanformer.py", line 14, in <module>
    from src.ASpanFormer.aspanformer import ASpanFormer
ModuleNotFoundError: No module named 'src.ASpanFormer'

MatchAnything:

  File "/app/imcui/ui/config.py", line 142, in get_model
    return get_matcher(model_name, device=DEVICE, **kwargs)
  File "/usr/local/lib/python3.13/site-packages/vismatch/__init__.py", line 172, in get_matcher
    return matchanything.MatchAnythingMatcher(device, variant="roma", *args, **kwargs)
           ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/local/lib/python3.13/site-packages/vismatch/im_models/matchanything.py", line 55, in __init__
    self._load_model()
    ~~~~~~~~~~~~~~~~^^
  File "/usr/local/lib/python3.13/site-packages/vismatch/im_models/matchanything.py", line 68, in _load_model
    cfg.merge_from_file(str(MATCHANYTHING_DIR.joinpath("configs", "models", "roma_model.py")))
    ~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/local/lib/python3.13/site-packages/yacs/config.py", line 212, in merge_from_file
    cfg = self.load_cfg(f)
  File "/usr/local/lib/python3.13/site-packages/yacs/config.py", line 363, in load_cfg
    return cls._load_cfg_from_file(cfg_file_obj_or_str)
           ~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^
  File "/usr/local/lib/python3.13/site-packages/yacs/config.py", line 374, in _load_cfg_from_file
    return cls._load_cfg_py_source(file_obj.name)
           ~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^
  File "/usr/local/lib/python3.13/site-packages/yacs/config.py", line 390, in _load_cfg_py_source
    module = _load_module_from_file("yacs.config.override", filename)
  File "/usr/local/lib/python3.13/site-packages/yacs/config.py", line 554, in _load_module_from_file
    spec.loader.exec_module(module)
    ~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^
  File "<frozen importlib._bootstrap_external>", line 1023, in exec_module
  File "<frozen importlib._bootstrap>", line 488, in _call_with_frames_removed
  File "/usr/local/lib/python3.13/site-packages/vismatch/third_party/MatchAnything/imcui/third_party/MatchAnything/configs/models/roma_model.py", line 2, in <module>
    cfg.ROMA.RESIZE_BY_STRETCH = True
    ^^^^^^^^
  File "/usr/local/lib/python3.13/site-packages/yacs/config.py", line 141, in __getattr__
    raise AttributeError(name)
AttributeError: ROMA
 

SSL certificate issue when downloading model (click to expand)

Windows: