Skip to content
Official repository for IPython itself. Other repos in the IPython organization contain things like the website, documentation builds, etc.
Python Jupyter Notebook Other
Branch: master
Clone or download
Carreau Merge pull request #12122 from Inception95/last_slash_elide
Pop the last if path ends with slash
Latest commit 201acc8 Feb 13, 2020


Type Name Latest commit message Commit time
Failed to load latest commit information.
IPython Merge pull request #12122 from Inception95/last_slash_elide Feb 13, 2020
docs update stats Feb 1, 2020
examples Remove python 2 specific line. Feb 1, 2020
scripts Remove unused code for building Windows installers Apr 12, 2017
setupext Fixed typos Aug 13, 2019
tools Add tool to automatically upgrade a file. Feb 7, 2020
.editorconfig Add EditorConfig to preserve trailing whitespace http://editorconfig.… Oct 23, 2017
.git-blame-ignore-revs Adds support for blame ignore. Jan 21, 2020
.gitattributes Tell git about certain file extensions (.py, .js, .html) for use in w… Jul 13, 2012
.gitignore remove duplicated entry in gitignore Dec 27, 2019
.mailmap update relase toom and mailmap Jun 27, 2019
.meeseeksdev.yml Let anyone add "good first issue" Nov 14, 2019
.travis.yml Revert "Use update brew tap to fix test failures." Feb 12, 2020 Fix small typo in Jun 2, 2019
COPYING.rst Tweak wording referring to LICENSE Apr 3, 2018
LICENSE Update LICENCE and Copying to match. Apr 3, 2018 Exclude .git-blame-ignore-revs to fix CI Jan 31, 2020
README.rst Add section to README about enabling blame ignore revs. Jan 21, 2020
appveyor.yml Remove one appveyor test on win32. Dec 12, 2019
codecov.yml Add codecov file, its apparently only way ton configure now. Jul 25, 2016
pytest.ini MNT: update pytest.ini to work with pytest > 3 Jan 12, 2020
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 Require stack_data Feb 11, 2020 Fix manpage path in FreeBSD Jun 29, 2019 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

Starting with IPython 7.10, IPython follows NEP 29

IPython 7.10+ requires Python version 3.6 and above.

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:


Alternatives to IPython

IPython may not be to your taste; if that's the case there might be similar project that you might want to use:

Ignoring commits with git blame.ignoreRevsFile

As of git 2.23, it is possible to make formatting changes without breaking git blame. See the git documentation for more details.

To use this feature you must:

  • Install git >= 2.23
  • Configure your local git repo by running:
    • POSIX: tools\
    • Windows: tools\configure-git-blame-ignore-revs.bat
You can’t perform that action at this time.