Studio supports both JupyterLab and the classic Jupyter Notebook environment.

In the JupyterLab environment, Studio also installs file handlers, see below for details.


The Map SDK lets you control Studio from a notebook environment. The Data SDK lets you interact with saved maps and datasets in the Studio Cloud from any Python environment, even outside a notebook.

To install both using pip, in a terminal shell run:

$ pip install unfolded.map-sdk unfolded.data-sdk


The installation method for JupyterLab depends on the version of JupyterLab you have installed. To find your JupyterLab version, you can run jupyter lab --version and consider the left-most number displayed.

JupyterLab version 3

If you are using JupyterLab version 3 or higher, no additional steps are needed.

JupyterLab version 1 or 2

If you are using JupyterLab version 1 or 2, you must complete the below steps to install the JupyterLab extension.

Prerequisites for JupyterLab version 1 and 2:

  • Node > 10.15.0
  • Python 3

Then install the JupyterLab extension:

$ jupyter labextension install @jupyter-widgets/jupyterlab-manager @unfolded/jupyter-map-sdk

Jupyter Notebook

If you are using Jupyter Notebook instead of JupyterLab, you must also run:

$ jupyter nbextension install --py --symlink --sys-prefix unfolded.map_sdk
$ jupyter nbextension enable --py --sys-prefix unfolded.map_sdk

JupyterLab Features

Studio File Handlers

As of Map SDK version 0.6.0, Studio is registered as a JupyterLab file handler for .geojson and .csv files. This is an easy way to explore your geospatial datasets without starting a Python environment.

Simply right click a file with a valid extension and choose "Open With > Studio".

Studio will open in a new pane and load that dataset.

A GeoJSON layer visualized via the Studio File Handler.A GeoJSON layer visualized via the Studio File Handler.

A GeoJSON layer visualized via the Studio File Handler.

Sign In