Coiled integrates with the tools you already use.
When it comes to using Coiled with JupyterLab,
there are a few useful open source JupyterLab extensions that we recommend trying out:
Dask JupyterLab extension
The Dask community maintains a JupyterLab extension
which allows Dask dashboard plots
to be embedded directly into a JupyterLab session. Viewing diagnostic plots in JupyterLab,
instead of in a separate browser tab or window, is often a pleasant user experience if you find
yourself working in JupyterLab a lot.
The Dask JupyterLab extension can be installed with:
conda install -c conda-forge jupyterlab nodejs dask-labextension
jupyter labextension install dask-labextension
jupyter serverextension enable dask_labextension
Now when you launch JupyterLab there will be a tab with the orange Dask logo in the left sidebar.
You can connect the extension to your Coiled cluster by copying the Dask dashboard URL
for your coiled.Cluster (available via the Cluster.dashboard_link attribute) into the
Dask tab in the JupyterLab left sidebar.
Dashboard plots are now available for you to embed directly into your JupyterLab session!
Plots are accessible by clicking the orange button with each plot’s name like “Progress”
or “Task Stream”. You can then click and drag the tabs of those new windows to
construct your ideal workspace. We recommend starting with the “Task Stream”
and “Progress” charts.
The nb_conda_kernels extension
enables you to access other conda environments on your machine
from Jupyter Notebook or JupyterLab. This allows you to smoothly switch between different Coiled
software environments you’ve installed locally. You can install the nb_conda_kernels extension
conda install -c conda-forge nb_conda_kernels
Note that any other environments you wish to access must have a kernel package, e.g. ipykernel,
installed in them. By default any Coiled software environment you’ve installed locally with
coiled install will have ipykernel automatically installed to enable use with
To select the conda environment to use with a notebook in JupyterLab, click the text indicating
the current kernel in the upper righthand corner of the notebook (screenshot below).
This will bring up a “Select Kernel” dropdown menu where you can select which kernel you would like
to use for the notebook.
ipywidgets enables interactive HTML widgets
for Jupyter notebooks and JupyterLab. This provides a rich, responsive user experience when working in Jupyter.
The coiled.Cluster cluster manager utilizes ipywidgets to display an interactive widget in JupyterLab
(screenshot below) which allows you to manually scale up, scale down, or
adaptively scale the number of workers in your
The ipywidgets JupyterLab extension can be installed with:
conda install -c conda-forge ipywidgets nodejs
jupyter labextension install @jupyter-widgets/jupyterlab-manager
After installing the extension, the cluster widget will now appear any time your cluster is
the output of a JupyterLab notebook cell.