Official repository for IPython itself. Other repos in the IPython organization contain things like the website, python3 support, etc.
Python Makefile
Pull request Compare This branch is 108 commits behind ipython:master.
Latest commit 211951b Jan 30, 2017 @Carreau update release instructions
Failed to load latest commit information.
IPython Merge pull request #10207 from Carreau/fix-embedded Jan 29, 2017
docs update release instructions Jan 30, 2017
examples remove python2 import statement Jan 5, 2017
tools remove Nov 2, 2016
.gitattributes Tell git about certain file extensions (.py, .js, .html) for use in w… Jul 13, 2012
.gitignore added .swp files to gitignore Aug 22, 2015
.mailmap Get GitHub stats since 5.1.0, and deduplicate mails in .mailmap Jan 30, 2017
.travis.yml Upgrade pip on Travis Jan 17, 2017 remove Nov 2, 2016
Dockerfile remove qtconsole Apr 10, 2015
README.rst Merge pull request #9894 from ipython/Carreau-patch-1 Aug 24, 2016
appveyor.yml Cut more appveyor tests. Jan 29, 2017
codecov.yml Add codecov file, its apparently only way ton configure now. Jul 25, 2016 the __future__ is now. Oct 22, 2016 Don't use execfile in Oct 29, 2013
tox.ini Cleaner PYPY flag (platform module); Comment fixes Aug 2, 2016


IPython: Productive Interactive Computing


Welcome to IPython. Our full documentation is available on and contains information on how to install, use and contribute to the project.

Officially, IPython requires Python version 3.3 and above. IPython 5.x is the last IPython version to support Python 2.7.

The Notebook, Qt console and a number of other pieces are now parts of Jupyter. See the Jupyter installation docs if you want to use these.

Development and Instant running

You can find the latest version of the development documentation on readthedocs.

You can run IPython from this directory without even installing it system-wide by typing at the terminal:

$ python -m IPython

Or see the development installation docs for the latest revision on read the docs.

Documentation and installation instructions for older version of IPython can be found on the IPython website

IPython requires Python version 3 or above

Starting with version 6.0, IPython does not support Python 2.7, 3.0, 3.1, or 3.2.

For a version compatible with Python 2.7, please install the 5.x LTS Long Term Support version.

If you are encountering this error message you are likely trying to install or use IPython from source. You need to checkout the remote 5.x branch. If you are using git the following should work:

$ git fetch origin $ git checkout -b origin/5.x

If you encounter this error message with a regular install of IPython, then you likely need to update your package manager, for example if you are using pip check the version of pip with

$ pip --version

You will need to update pip to the version 8.2 or greater. If you are not using pip, please inquiry with the maintainers of the package for your package manager.

For more information see one of our blog posts:

As well as the following Pull-Request for discussion: