INSTALL.md

Install

Map Machine requires Python 3.10, pip, and two libraries:

• cairo 2D graphic library,
• GEOS library.

Python 3.8 support

If you want to use Python 3.8, there is a special branch python3.8. It has support for all features, but is likely to be updated less frequently than the main. Installation command is

pip install git+https://github.com/enzet/map-machine@python3.8

Without cairo

If you have any problems installing cairo library or cairo-related Python dependencies, but do not plan to generate PNG tiles (only SVG images), you may try special Map Machine branch no-cairo without cairo dependency. Installation command is

pip install git+https://github.com/enzet/map-machine@no-cairo

Installation examples

Ubuntu

apt install libcairo2-dev libgeos-dev
pip install git+https://github.com/enzet/map-machine

macOS

brew install cairo geos
pip install git+https://github.com/enzet/map-machine