1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
|
.. _install:
Installing IPython
==================
IPython requires Python 2.7 or ≥ 3.3.
Quick Install
-------------
With ``pip`` already installed :
.. code-block:: bash
$ pip install ipython
This installs IPython as well as its dependencies.
If you want to use IPython with notebooks or the Qt console, you should also
install Jupyter ``pip install jupyter``.
Overview
--------
This document describes in detail the steps required to install IPython. For a
few quick ways to get started with package managers or full Python
distributions, see `the install page <http://ipython.org/install.html>`_ of the
IPython website.
Please let us know if you have problems installing IPython or any of its
dependencies.
IPython and most dependencies should be installed via :command:`pip`.
In many scenarios, this is the simplest method of installing Python packages.
More information about :mod:`pip` can be found on
`its PyPI page <https://pip.pypa.io>`__.
More general information about installing Python packages can be found in
`Python's documentation <http://docs.python.org>`_.
.. _dependencies:
Dependencies
~~~~~~~~~~~~
IPython relies on a number of other Python packages. Installing using a package
manager like pip or conda will ensure the necessary packages are installed.
Manual installation without dependencies is possible, but not recommended.
The dependencies can be viewed with package manager commands,
such as :command:`pip show ipython` or :command:`conda info ipython`.
Installing IPython itself
~~~~~~~~~~~~~~~~~~~~~~~~~
IPython requires several dependencies to work correctly, it is not recommended
to install IPython and all its dependencies manually as this can be quite long
and troublesome. You should use the python package manager ``pip``.
Installation using pip
~~~~~~~~~~~~~~~~~~~~~~
Make sure you have the latest version of :mod:`pip` (the Python package
manager) installed. If you do not, head to `Pip documentation
<https://pip.pypa.io/en/stable/installing/>`_ and install :mod:`pip` first.
The quickest way to get up and running with IPython is to install it with pip:
.. code-block:: bash
$ pip install ipython
That's it.
Installation from source
~~~~~~~~~~~~~~~~~~~~~~~~
To install IPython from source,
grab the latest stable tarball of IPython `from PyPI
<https://pypi.python.org/pypi/ipython>`__. Then do the following:
.. code-block:: bash
tar -xzf ipython-5.1.0.tar.gz
cd ipython-5.1.0
# The [test] extra ensures test dependencies are installed too:
pip install .[test]
Do not invoke ``setup.py`` directly as this can have undesirable consequences
for further upgrades. We do not recommend using ``easy_install`` either.
If you are installing to a location (like ``/usr/local``) that requires higher
permissions, you may need to run the last command with :command:`sudo`. You can
also install in user specific location by using the ``--user`` flag in
conjunction with pip.
To run IPython's test suite, use the :command:`iptest` command from outside of
the IPython source tree:
.. code-block:: bash
$ iptest
.. _devinstall:
Installing the development version
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
It is also possible to install the development version of IPython from our
`Git <http://git-scm.com/>`_ source code repository. To do this you will
need to have Git installed on your system.
Then do:
.. code-block:: bash
$ git clone https://github.com/ipython/ipython.git
$ cd ipython
$ pip install -e .[test]
The :command:`pip install -e .` command allows users and developers to follow
the development branch as it changes by creating links in the right places and
installing the command line scripts to the appropriate locations.
Then, if you want to update your IPython at any time, do:
.. code-block:: bash
$ git pull
If the dependencies or entrypoints have changed, you may have to run
.. code-block:: bash
$ pip install -e .
again, but this is infrequent.
|
