Installing JupyterGIS

Mamba (recommended)

Note

It is best to install JupyterGIS using mamba, conda, micromamba, or pixi since you’ll be able to install qgis at the same time, allowing you to open .qgz files.

mamba install -c conda-forge jupytergis qgis

pip

Warning

When installing with pip, QGIS compatibility functions won’t work out of the box. You’re on your own!

pip install jupytergis

Once JupyterGIS is installed, start JupyterLab:

jupyter lab

Quickstart

Here are a few neat options to quickstart in an ephemeral environment:

Docker

Docker

docker run -p 8888:8888 ghcr.io/geojupyter/jupytergis:latest

Pixi

Pixi

pixi exec --spec jupytergis --spec qgis jupyter lab

uv

uv

uv run --with jupytergis jupyter lab