The easiest way to install is through conda, which will also install the dependencies:

conda install poppunk

Then run with poppunk.


From v2.1.0 onwards, PopPUNK requires python3.8 to run (which on many default Linux installations is run using python3 rather than python).


From v2.1.2 onwards, PopPUNK no longer supports mash. If you want to use older databases created with mash, please downgrade to <v2

Installing with pip#

If you do not have conda, you can also install through pip:

python3 -m pip install poppunk

This may not deal with all necessary dependencies, but we are working on it and it should again be possible in an upcoming release.

Clone the code#

You can also clone the github to run the latest version, which is executed by:

git clone && cd PopPUNK
python3 build
python3 install

This will also give access to the Scripts.

You will need to install the dependencies yourself (you can still use conda or pip for this purpose). See environment.yml:

mamba env create -f environment.yml
conda activate pp_env