This documentation covers a development version of IPython. The development version may differ significantly from the latest stable release.


This documentation covers IPython versions 6.0 and higher. Beginning with version 6.0, IPython stopped supporting compatibility with Python versions lower than 3.3 including all versions of Python 2.7.

If you are looking for an IPython version compatible with Python 2.7, please use the IPython 5.x LTS release and refer to its documentation (LTS is the long term support release).

IPython DocumentationΒΆ

Date:October 24, 2016

Welcome to the official IPython documentation

IPython provides a rich toolkit to help you make the most out of using Python interactively. Its main components are:

  • A powerful interactive Python shell
  • A Jupyter kernel to work with Python code in Jupyter notebooks and other interactive frontends.

The enhanced interactive Python shells and kernel have the following main features:

  • Comprehensive object introspection.
  • Input history, persistent across sessions.
  • Caching of output results during a session with automatically generated references.
  • Extensible tab completion, with support by default for completion of python variables and keywords, filenames and function keywords.
  • Extensible system of ‘magic’ commands for controlling the environment and performing many tasks related either to IPython or the operating system.
  • A rich configuration system with easy switching between different setups (simpler than changing $PYTHONSTARTUP environment variables every time).
  • Session logging and reloading.
  • Extensible syntax processing for special purpose situations.
  • Access to the system shell with user-extensible alias system.
  • Easily embeddable in other Python programs and GUIs.
  • Integrated access to the pdb debugger and the Python profiler.

The Command line interface inherits all the above functionality and posses

  • real multi-line editing.
  • syntax highlighting as you type
  • integration with command line editor for a better workflow.

The kernel also have its share of feature, when used with a compatible frontend it allows for:

  • rich display system for object allowing to display Html, Images, Latex,Sounds Video.
  • interactive widgets with the use of the ipywidgets package.

This documentation will walk through most of the features of the IPython command line and kernel, as well as describe the internals mechanisms in order to improve your Python workflow.

You can always find the table of content for this documentation in the left sidebar, allowing you to come back on previous section if needed, or skip ahead.

The latest development version is always available from IPython’s GitHub repository.

See also

Jupyter documentation
The Notebook code and many other pieces formerly in IPython are now parts of Project Jupyter.
ipyparallel documentation
Formerly IPython.parallel.