# Using HEAVY.AI with JupyterLab

{% tabs %}
{% tab title="HEAVY.AI Enterprise Edition" %}
HEAVY.AI Enterprise Edition comes with a fully integrated version of [JupyterHub](https://jupyter.org/hub). This provides a secure, multi-user notebook environment for data exploration with OmniSci, and is the primary user interface for the HEAVY.AI Data Science Foundation.

You can quickly switch from visual data exploration, to a Data Science environment preloaded with useful open source libraries and tools that work with OmniSci transparently.

You can access [JupyterLab](https://jupyterlab.readthedocs.io/en/stable/), the next generation Jupyter notebook UI from within Immerse via a button located on the dashboard title

![](https://875484548-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgWRc88gdQeZ7mRBB46Rx%2Fuploads%2Fgit-blob-8522c6f84e6a3ffb98695d9d8988c8a204b1d540%2F7_datasci-jupyter-1.png?alt=media)

In addition, you can also launch JupyterLab from SQL Editor. In this case, a notebook is opened up with the query wrapped in an Ibis expression.

![](https://875484548-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgWRc88gdQeZ7mRBB46Rx%2Fuploads%2Fgit-blob-392fabb8ff5c86622dcb98a2125d618512411fd1%2F7_datasci-usingomnici-2%20\(3\)%20\(3\)%20\(3\)%20\(3\)%20\(3\)%20\(4\)%20\(4\)%20\(4\)%20\(2\).png?alt=media)

{% hint style="info" %}
HEAVY.AI Enterprise allows you to control which users have access to JupyterLab and Data Science tools. This is managed as a separate privilege under the HEAVY.AI role-based permissions model. Refer to the [installation](https://docs.heavy.ai/python-data-science/get-started-jupyter) instructions for how to set this up for specific users
{% endhint %}
{% endtab %}

{% tab title="HEAVY.AI Open Source Edition" %}
If you are an HEAVY.AI open source edition user, you do not have access to HeavyImmerse, but you can still explore HEAVY.AI with the Data Science Foundation tools.

{% hint style="info" %}
Using JupyterLab with HEAVY.AI Open Source Edition requires you to connect to HEAVY.AI explicitly from within a Jupyter notebook cell, using [Ibis](https://docs.heavy.ai/python-data-science/introduction-to-ibis) or [py](https://github.com/omnisci/docs-internal/tree/7ca9a3f8fbca75498ccfec3bba1ada3eb88f2fe4/apis-and-interfaces/pyomnisci.md)[mapd](https://github.com/omnisci/docs-internal/tree/7ca9a3f8fbca75498ccfec3bba1ada3eb88f2fe4/apis-and-interfaces/pyomnisci.md) connection syntax. Refer to the [Ibis](https://docs.heavy.ai/python-data-science/introduction-to-ibis) or pyomnisci examples for more details.
{% endhint %}

**Using the Anaconda Package Manager**

If you are using the Anaconda package manager, you can install the set of Python tools for HEAVY.AI:

```
conda install -c conda-forge omnisci-pytools
```

**Using the HEAVY.AI Docker Container for Jupyter tools**

You can download a prebuilt Docker container and simply start up these tools as a standalone container.
{% endtab %}
{% endtabs %}

## Tools and Utilities

HEAVY.AI provides a collection utilities to work with JupyterLab.

This is a collection of useful functions and Jupyter cell magics that allows running commands that are typically possible from [heavysql](https://docs.heavy.ai/apis-and-interfaces/heavysql) from inside a notebook environment.