This is the recommended way for all systems.

This approach is independent of the OS used.

First create an environment.

conda create --name tagmaps

Then install tagmaps from the conda-forge channel.

conda activate tagmaps
conda config --env --set channel_priority strict
conda install tagmaps --channel conda-forge


There are many ways to install python tools:

  1. The recommended way to install the package is with conda
  2. For Windows users, an alternative is to download the newest pre-compiled build from releases and run tagmaps.exe
  3. If you need to install with pip, it is recommended to
    • install all dependencies first (e.g. Windows users: use Gohlke wheels if available) and then run:
    • pip install tagmaps --no-dependencies
    • or clone the repository, and install locally with:
    • pip install --no-dependencies --editable .

Of these 3 choices, using conda is the one that I prefer. For users who are not familiar with python package managers, please see the detailed instructions to install tagmaps with conda provided here.


Both pip install tagmaps and conda install tagmaps -c conde-forge are available to install tagmaps in Linux.

Setup requires gdal to be available. As a minimal example, have a look at the following commands for Ubuntu:

git clone
cd tagmaps
apt-get install python3-venv
# create a virtual env
python3 -m venv tagmaps
source ./tagmaps/bin/activate
# install gdal
apt-get install libgdal-dev
export CPLUS_INCLUDE_PATH=/usr/include/gdal
export C_INCLUDE_PATH=/usr/include/gdal
# get gdal version
gdal-config --version # Output: 2.2.3
# install matching gdal version with pip
pip install GDAL==2.2.3
# Install latest tagmaps from GitHub
pip install --editable .
# or from latest release on pip:
# pip install tagmaps