Installation

We recommend to use virtualenv when possible, especially when dealing distributed systems such as SLURM.

So if you are using conda, make sure to exit your environment via conda deactivate. While you could install DeepBLAST / TMvec within a conda environment, we have run into problems when running distributed training, so use at your own risk.

You can create a new virtual environment via

python3 -m venv tmvec

This will create a folder called tmvec, and all install scripts will be installed there. The install script location can be placed anywhere on your system (sometimes useful on distributed systems).

Once the virtualenv is created, you can activate your environment and install everything as follows. If you have a GPU available, you can take advantage of accelerated database building, search and alignment.

This can be done as follows

pip3 install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu116
pip3 install faiss-gpu

For more details on pytorch versions, see the pytorch instructions

If you don't have a GPU, make sure to instead install faiss via pip install faiss-cpu

Then, the latest versions of DeepBLAST and TMvec can be installed as follows.

pip install git+https://github.com/flatironinstitute/deepblast.git
pip install git+https://github.com/tymor22/tm-vec.git