Installation

Glue Factory requires Python 3.6+ and PyTorch. It is recommended to use a virtual environment or Conda environment.

Basic Installation

  1. Clone the repository:

    git clone https://github.com/cvg/glue-factory
    cd glue-factory
  2. Install in editable mode:

    This installs the library along with basic dependencies (numpy, opencv, matplotlib, etc.).

    python3 -m pip install -e .

Advanced Installation

For advanced features, including certain geometry libraries and line detection modules, install the extra dependencies:

python3 -m pip install -e .[extra]

This includes:

  • pycolmap
  • poselib
  • pytlsd
  • deeplsd
  • homography_est

Development Installation

If you plan to contribute to the codebase, install the development tools (linting, formatting, testing):

python3 -m pip install -e .[dev]

This installs black, flake8, isort, and parameterized.