Official repository for IPython itself. Other repos in the IPython organization contain things like the website, documentation builds, etc.
Carreau Merge pull request #11491 from reuben/add_cd_force_quiet
Add option to force silence %cd
Latest commit 844ad8b Nov 11, 2018
Failed to load latest commit information.
IPython Merge pull request #11491 from reuben/add_cd_force_quiet Nov 11, 2018
docs Merge pull request #11491 from reuben/add_cd_force_quiet Nov 11, 2018
examples Fix breaking newline Aug 4, 2018
scripts Remove unused code for building Windows installers Apr 12, 2017
setupext Misc. typos Mar 29, 2018
tools Attempt to fix latex symbols in the completer Oct 15, 2018
.editorconfig Add EditorConfig to preserve trailing whitespace http://editorconfig.… Oct 23, 2017
.gitattributes Tell git about certain file extensions (.py, .js, .html) for use in w… Jul 13, 2012
.gitignore Add .python-version to gitignore Aug 4, 2018
.mailmap update mailmap Oct 27, 2018
.meeseeksdev.yml Allow anyone to tag/untag/close issues. Sep 21, 2018
.travis.yml remove reference to no-longer-executed js test group Nov 1, 2018 Update Oct 30, 2018
COPYING.rst Tweak wording referring to LICENSE Apr 3, 2018
LICENSE Update LICENCE and Copying to match. Apr 3, 2018 Remove include from MANIFEST Sep 11, 2018
README.rst Merge pull request #11466 from kd2718/README_quick_fix Oct 30, 2018
appveyor.yml doc, remove appveyor 3.4 Aug 16, 2018
codecov.yml Add codecov file, its apparently only way ton configure now. Jul 25, 2016
readthedocs.yml Use readthedocs.yaml file as we need a recent version of sphinx Sep 27, 2018
setup.cfg Include LICENSE file in wheels Jun 8, 2018 Replace simplegeneric.generic with functools.singledispatch Oct 13, 2018 Merge pull request #11285 from Carreau/project_url Sep 7, 2018 Don't use execfile in Oct 29, 2013


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.

IPython versions and Python Support

IPython 7.0 requires Python version 3.5 and above.

IPython 6.x requires Python version 3.3 and above.

IPython 5.x LTS is the compatible release for Python 2.7. If you require Python 2 support, you must use IPython 5.x LTS. Please update your project configurations and requirements as necessary.

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 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 9.0.1 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:

This error does also occur if you are invoking directly – which you should not – or are using easy_install If this is the case, use pip install . instead of install , and pip install -e . instead of develop If you are depending on IPython as a dependency you may also want to have a conditional dependency on IPython depending on the Python version:

install_req = ['ipython']
if sys.version_info[0] < 3 and 'bdist_wheel' not in sys.argv: