layout | title | tagline | permalink |
---|---|---|---|
page_md |
Installing the Jupyter Software |
Get up and running with the JupyterLab or the classic Jupyter Notebook on your computer within minutes! |
/install |
install JupyterLab using conda
, pip
, or pipenv
. Conda is recommended if you have no installation preference.
Project installation instructions from the git sources are available in the contributor documentation.
Conda is an open source package management system and environment management system that runs on Windows, macOS, and Linux. Conda packages and distributes software for any language, and by default uses the Anaconda repository managed by Anaconda Inc. To install conda, please see the conda installation instructions.
Install the JupyterLab conda
package with:
conda install -c conda-forge jupyterlab
pip is a package management system for installing and updating Python packages, and comes with any Python installation. On Ubuntu, SUSE Enterprise Linux, openSUSE, and Fedora Linux, use the system package manager to install the python3-pip
package. _The Hitchhiker's Guide to Python_provides guidance on how to install Python; Another option is to install Python directly from python.org. We suggest you upgrade pip before using it to install other programs.
JupyterLab requires Python 3.5 or higher.
- When using Windows with Python version 3.5 or higher, use the Python Launcher for Windows to use
pip
with Python version 3:py -3 -m pip install jupyterlab
- If the system has a
python3
command (standard on Unix-like systems), install with the comand:python3 -m pip install jupyterlab
- Using the
python
command directly is another option, but this will use the current version of Python (which may be Python version 2 or version 3 if both are installed):python -m pip install jupyterlab
Some systems have a pip3
command that has the same effect as python3 -m pip
and/or a pip
command that behaves the same as python -m pip
.
Adding --user
after pip install
will install the files to a local user install directory (typically ~/.local/
or %APPDATA%\Python
on Windows) instead of the system-wide directory. This can be helpful, especially if writing to the system-wide directory is not permitted. However, the user-level bin
directory must be added to the PATH
environment variable in order to launch jupyter lab
.
While Jupyter runs code in many programming languages, Python is a requirement (Python 3.3 or greater, or Python 2.7) for installing the JupyterLab or the classic Jupyter Notebook.
We strongly recommend installing Python and Jupyter using the Anaconda Distribution, which includes Python, the Jupyter Notebook, and other commonly used packages for scientific computing and data science.
First, download Anaconda. We recommend downloading Anaconda’s latest Python 3 version.
Second, install the version of Anaconda which you downloaded, following the instructions on the download page.
Congratulations, you have installed Jupyter Notebook! To run the notebook, run the following command at the Terminal (Mac/Linux) or Command Prompt (Windows):
jupyter notebook
See Running the Notebook for more details.
As an existing or experienced Python user, you may wish to install Jupyter using Python’s package manager, pip, instead of Anaconda.
If you have Python 3 installed (which is recommended):
python3 -m pip install --upgrade pip
python3 -m pip install jupyter
If you have Python 2 installed:
python -m pip install --upgrade pip
python -m pip install jupyter
Congratulations, you have installed Jupyter Notebook! To run the notebook, run the following command at the Terminal (Mac/Linux) or Command Prompt (Windows):
jupyter notebook
See Running the Notebook for more details.