IPython requires Python 2.7 or ≥ 3.3.
pip already installed :
$ pip install ipython
This installs IPython as well as its dependencies.
If you want to use IPython with notebooks or the Qt console, you should also
pip install jupyter.
This document describes in detail the steps required to install IPython. For a few quick ways to get started with package managers or full Python distributions, see the install page of the IPython website.
Please let us know if you have problems installing IPython or any of its dependencies.
IPython and most dependencies should be installed via :command:`pip`. In many scenarios, this is the simplest method of installing Python packages. More information about :mod:`pip` can be found on its PyPI page.
More general information about installing Python packages can be found in Python's documentation.
Installing IPython itself
IPython requires several dependencies to work correctly, it is not recommended
to install IPython and all its dependencies manually as this can be quite long and troublesome.
You should use the python package manager
Installation using pip
The quickest way to get up and running with IPython is to install it with pip:
$ pip install ipython
Installation from source
$ tar -xzf ipython.tar.gz $ cd ipython $ pip install .
Do not invoke
setup.py directly as this can have undesirable consequences for further upgrades.
Try to also avoid any usage of
easy_install that can have similar undesirable consequences.
If you are installing to a location (like
/usr/local) that requires higher
permissions, you may need to run the last command with :command:`sudo`. You can
also install in user specific location by using the
--user flag in conjunction with pip.
To run IPython's test suite, use the :command:`iptest` command from outside of the IPython source tree:
Installing the development version
It is also possible to install the development version of IPython from our Git source code repository. To do this you will need to have Git installed on your system. Then do:
$ git clone https://github.com/ipython/ipython.git $ cd ipython $ pip install .
Some users want to be able to follow the development branch as it changes. With :mod:`pip` installed, you can replace the last step by:
$ pip install -e .
This creates links in the right places and installs the command line script to the appropriate location.
Then, if you want to update your IPython at any time, do:
$ git pull
IPython relies on a number of other Python packages. Installing using a package manager like pip or conda will ensure the necessary packages are installed. If you install manually, it's up to you to make sure dependencies are installed. They're not listed here since a static list would inevitably fall out of date as dependencies may change from release to release and also vary depending on the platform.