jupyter

Installing Jupyter Notebook

This information explains how to install the Jupyter Notebook and the IPython kernel.

Prerequisite: Python

While Jupyter runs code in many programming languages, Python is a requirement (Python 3.3 or greater, or Python 2.7) for installing Jupyter notebook.

We recommend using the Anaconda distribution to install Python and Jupyter. We’ll go through its installation in the next section.

Installing Jupyter using Anaconda and conda

For new users, we highly recommend installing Anaconda. Anaconda conveniently installs Python, the Jupyter Notebook, and other commonly used packages for scientific computing and data science.

Use the following installation steps:

  1. Download Anaconda. We recommend downloading Anaconda’s latest Python 3 version (currently Python 3.5).

  2. Install the version of Anaconda, which you downloaded.

  3. Congratulations, you have installed Jupyter Notebook. To run the notebook:

    jupyter notebook
    

    See Running the Notebook for more details.

Optional for experienced Python developers: Installing Jupyter with pip

Important

Jupyter installation requires Python 3.3 or greater, or Python 2.7. Older releases of IPython are available here.

We recommend Anaconda for installing Jupyter. Though as an existing Python user, you may wish to use Python’s package manager, pip, as an alternative.

Install the Jupyter Notebook using:

pip3 install jupyter

(Use pip if using legacy Python 2.)

Note

Some of Jupyter’s dependencies may require compilation, in which case you would need the ability to compile Python C-extensions. You will need a C compiler and the Python headers. On Debian-based systems (e.g. Ubuntu), you can get this with:

apt-get install build-essential python3-dev

And on Fedora-based systems (e.g. Red Hat, CentOS):

yum groupinstall 'Development Tools'
yum install python3-devel

(Use python for legacy Python 2.)

Congratulations. You have installed Jupyter Notebook. See Running the Notebook for more details.