Installation

Mamba (recommended)

Tip

Installing with a conda-based tool (mamba, conda, micromamba, or pixi) lets you install qgis alongside JupyterGIS, enabling .qgz file support. QGIS is a C++ application and only available as a conda-forge package — it cannot be installed via pip or uv.

Mamba / Conda (recommended)

mamba install -c conda-forge jupytergis qgis

pip

Warning

When installing with pip, QGIS compatibility and optional tiler functions won’t work out of the box. You may especially run in to problems with Python 3.14, for which many geospatial libraries still lack wheels as of May 2026. You’re on your own!

pip install jupytergis  # or jupytergis[tiler]!

Once JupyterGIS is installed, start JupyterLab:

jupyter lab

Or with conda:

conda install -c conda-forge jupytergis qgis
jupyter lab

Pixi

Install into a project:

pixi add jupytergis qgis
pixi run jupyter lab

Or run directly without a permanent install:

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

pip

Warning

.qgz file support is not available — QGIS is not distributed on PyPI.

pip install jupytergis
jupyter lab

uv

Warning

.qgz file support is not available — QGIS is not distributed on PyPI.

Install into a project:

uv add jupytergis
uv run jupyter lab

Or run directly without a permanent install:

uv run --with jupytergis jupyter lab

Docker

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

Docker build source: geojupyter/jupytergis-docker