btrack has been tested with Python on x86_64 macos>=11, ubuntu>=20.04 and windows>=10.0.17763.

Installing Scientific Python

If you do have already an Anaconda or miniconda setup you can jump to the next step.


We strongly recommend using a Python virtual environment or a conda virtual environment.

If you don’t currently have a working scientific Python distribution then follow the Miniconda Python distribution installation instructions to install Miniconda.


Miniconda is a lighter version of conda. But all the commands are the same.

Setting up a conda environment

Once you have conda installed, you can create a virtual environment from the terminal/system command prompt or the ‘Anaconda Prompt’ (under Windows) as:

conda create -n btrack-env

and access to the environment via:

conda activate btrack-env

We could have skipped these two steps and install btrack in the base environment, but virtual environments allow us to keep packages independent of other installations.

Installing btrack

After we’ve created and activated the virtual environment, on the same terminal, we install btrack with:

pip install btrack

This will download and install btrack and all its dependencies.