Warning

This documentation covers a development version of IPython. The development version may differ significantly from the latest stable release.

Important

This documentation covers IPython versions 6.0 and higher. Beginning with version 6.0, IPython stopped supporting compatibility with Python versions lower than 3.3 including all versions of Python 2.7.

If you are looking for an IPython version compatible with Python 2.7, please use the IPython 5.x LTS release and refer to its documentation (LTS is the long term support release).

Installation

This sections will guide you through installing IPython itself, and installing kernels for Jupyter if you wish to work with multiple version of Python, or multiple environments.

Quick install reminder

Here is a quick reminder of the commands needed for installation if you are already familiar with IPython and are just searching to refresh your memory:

Install IPython:

$ pip install ipython

Install and register an IPython kernel with Jupyter:

$ python -m pip install ipykernel

$ python -m ipykernel install [--user] [--name <machine-readable-name>] [--display-name <"User Friendly Name">]

for more help see

$ python -m ipykernel install  --help

See also

Installing Jupyter

The Notebook, nbconvert, and many other former pieces of IPython are now part of Project Jupyter.