Welcome to IPython. Our full documentation, including PDF versions of our manual, is available on our website; if you downloaded a built source distribution the docs/html directory contains an HTML version of the manual. The docs/source directory contains the plaintext version of these manuals.

For full details, see the installation section of the manual. The basic parts of IPython only need the Python standard library, but much of its more advanced functionality requires extra packages.

Officially, IPython requires Python version 2.6 or 2.7. A separate repository contains our Python 3 version, as explained in our wiki.

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

$ python ipython.py