Official repository for IPython itself. Other repos in the IPython organization contain things like ...
The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:
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 <https:></https:>
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 <https:></https:>
__ if you want to use these.
You can find the latest version of the development documentation on
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<https:></https:>
_ for the latest revision on read the docs.
Documentation and installation instructions for older version of IPython can be found on the
IPython website <https:></https:>
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
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
If this is the case, use
pip install .
pip install -e .
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 \< 3 and 'bdist\_wheel' not in sys.argv: install\_req.remove('ipython') install\_req.append('ipython\<6') setup( ... install\_requires=install\_req )
IPython may not be to your taste; if that's the case there might be similar project that you might want to use:
ptpython and ptipython <https:></https:>
As of git 2.23, it is possible to make formatting changes without breaking
. See the
_ for more details.
To use this feature you must: