MapLibre for Python

Docs | Discord | Examples | Slack

MapLibre for Python provides Python bindings for MapLibre GL JS. Furthermore, Deck.GL Layers can be mixed with MapLibre Layers.

It integrates seamlessly into Shiny for Python, Marimo, Jupyter and JupyterLite.

Join the conversation

Join us on Discord.

Installation

# Stable
pip install maplibre # minimal
pip install "maplibre[shiny]" # shiny bindings
pip install "maplibre[ipywidget]" # marimo and jupyter bindings
pip install "maplibre[all]"
uv add maplibre
uv add "maplibre[all]"
Unstable
pip install git+https://github.com/eoda-dev/py-maplibregl@dev
pip install "maplibre[all] @ git+https://github.com/eoda-dev/py-maplibregl@dev"
uv add "git+https://github.com/eoda-dev/py-maplibregl@dev[all]"
Conda
conda install -c conda-forge maplibre

Quickstart

from maplibre import Map, MapOptions
m = Map(MapOptions(center=(-123.1256, 49.24658), zoom=9)) m.save(preview=True)

Documentation

• Basic usage
• API Documentation
• Examples

Development

Python

poetry install
poetry run pytest
poetry run pytest --ignore=maplibre/ipywidget.py --doctest-modules maplibre

JavaScript

See maplibre-bindings