| Server IP : 82.208.35.60 / Your IP : 216.73.217.33 Web Server : Apache/2.4.55 (FreeBSD) OpenSSL/1.1.1q-freebsd PHP/7.3.31 System : FreeBSD server7.d2m.cz 12.4-RELEASE-p9 FreeBSD 12.4-RELEASE-p9 GENERIC amd64 User : studiokobylisy_cz ( 1008) PHP Version : 7.3.31 Disable Function : NONE MySQL : OFF | cURL : ON | WGET : OFF | Perl : OFF | Python : OFF | Sudo : OFF | Pkexec : OFF Directory : /usr/local/share/doc/py36-pip/ |
Upload File : |
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Installation — pip 19.1.1 documentation</title>
<link rel="stylesheet" href="_static/pypa.css" type="text/css" />
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT: './',
VERSION: '19.1.1',
COLLAPSE_INDEX: false,
FILE_SUFFIX: '.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<script type="text/javascript" src="_static/sidebar.js"></script>
<link rel="search" title="Search" href="search.html" />
<link rel="next" title="User Guide" href="user_guide.html" />
<link rel="prev" title="Quickstart" href="quickstart.html" />
<link rel="shortcut icon" type="image/png" href="_static/py.png" />
<script type="text/javascript" src="_static/copybutton.js"></script>
</head>
<body>
<div class="related" role="navigation" aria-label="related navigation">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="user_guide.html" title="User Guide"
accesskey="N">next</a></li>
<li class="right" >
<a href="quickstart.html" title="Quickstart"
accesskey="P">previous</a> |</li>
<li><img src="_static/py.png" alt=""
style="vertical-align: middle; margin-top: -1px"/></li>
<li><a href="https://pypa.io">PyPA</a> »</li>
<a href="index.html">pip 19.1.1 documentation</a> »
<li class="right">
<div class="inline-search" style="display: none" role="search">
<form class="inline-search" action="search.html" method="get">
<input placeholder="Quick search" type="text" name="q" />
<input type="submit" value="Go" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
<script type="text/javascript">$('.inline-search').show(0);</script>
|
</li>
</ul>
</div>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body" role="main">
<div class="section" id="installation">
<span id="id1"></span><h1>Installation<a class="headerlink" href="#installation" title="Permalink to this headline">¶</a></h1>
<div class="section" id="do-i-need-to-install-pip">
<h2>Do I need to install pip?<a class="headerlink" href="#do-i-need-to-install-pip" title="Permalink to this headline">¶</a></h2>
<p>pip is already installed if you are using Python 2 >=2.7.9 or Python 3 >=3.4
downloaded from <a class="reference external" href="https://www.python.org">python.org</a> or if you are working
in a <span class="xref std std-ref">Virtual Environment</span>
created by <span class="xref std std-ref">pypug:virtualenv</span> or <span class="xref std std-ref">pyvenv</span>.
Just make sure to <a class="reference internal" href="#upgrading-pip"><span class="std std-ref">upgrade pip</span></a>.</p>
</div>
<div class="section" id="installing-with-get-pip-py">
<span id="get-pip"></span><h2>Installing with get-pip.py<a class="headerlink" href="#installing-with-get-pip-py" title="Permalink to this headline">¶</a></h2>
<p>To install pip, securely download <a class="reference external" href="https://bootstrap.pypa.io/get-pip.py">get-pip.py</a>. <a class="footnote-reference" href="#id7" id="id2">[1]</a>:</p>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">curl</span> <span class="n">https</span><span class="p">:</span><span class="o">//</span><span class="n">bootstrap</span><span class="o">.</span><span class="n">pypa</span><span class="o">.</span><span class="n">io</span><span class="o">/</span><span class="n">get</span><span class="o">-</span><span class="n">pip</span><span class="o">.</span><span class="n">py</span> <span class="o">-</span><span class="n">o</span> <span class="n">get</span><span class="o">-</span><span class="n">pip</span><span class="o">.</span><span class="n">py</span>
</pre></div>
</div>
<p>Then run the following:</p>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">python</span> <span class="n">get</span><span class="o">-</span><span class="n">pip</span><span class="o">.</span><span class="n">py</span>
</pre></div>
</div>
<div class="admonition warning">
<p class="first admonition-title">Warning</p>
<p class="last">Be cautious if you are using a Python install that is managed by your operating
system or another package manager. <code class="docutils literal"><span class="pre">get-pip.py</span></code> does not coordinate with
those tools, and may leave your system in an inconsistent state.</p>
</div>
<p><code class="docutils literal"><span class="pre">get-pip.py</span></code> also installs <span class="xref std std-ref">pypug:setuptools</span> <a class="footnote-reference" href="#id8" id="id3">[2]</a> and <span class="xref std std-ref">pypug:wheel</span>
if they are not already. <span class="xref std std-ref">pypug:setuptools</span> is required to install
<span class="xref std std-term">source distributions</span>. Both are
required in order to build a <a class="reference internal" href="reference/pip_install.html#wheel-cache"><span class="std std-ref">Wheel Cache</span></a> (which improves installation
speed), although neither are required to install pre-built <span class="xref std std-term">wheels</span>.</p>
<div class="admonition note">
<p class="first admonition-title">Note</p>
<p class="last">The get-pip.py script is supported on the same python version as pip.
For the now unsupported Python 2.6, alternate script is available
<a class="reference external" href="https://bootstrap.pypa.io/2.6/get-pip.py">here</a>.</p>
</div>
<div class="section" id="get-pip-py-options">
<h3>get-pip.py options<a class="headerlink" href="#get-pip-py-options" title="Permalink to this headline">¶</a></h3>
<dl class="option">
<dt id="cmdoption-no-setuptools">
<code class="descname">--no-setuptools</code><code class="descclassname"></code><a class="headerlink" href="#cmdoption-no-setuptools" title="Permalink to this definition">¶</a></dt>
<dd><p>If set, do not attempt to install <span class="xref std std-ref">pypug:setuptools</span></p>
</dd></dl>
<dl class="option">
<dt id="cmdoption-no-wheel">
<code class="descname">--no-wheel</code><code class="descclassname"></code><a class="headerlink" href="#cmdoption-no-wheel" title="Permalink to this definition">¶</a></dt>
<dd><p>If set, do not attempt to install <span class="xref std std-ref">pypug:wheel</span></p>
</dd></dl>
<p><code class="docutils literal"><span class="pre">get-pip.py</span></code> allows <a class="reference internal" href="reference/pip_install.html#pip-install-options"><span class="std std-ref">pip install options</span></a> and the <a class="reference internal" href="reference/pip.html#general-options"><span class="std std-ref">general options</span></a>. Below are
some examples:</p>
<p>Install from local copies of pip and setuptools:</p>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">python</span> <span class="n">get</span><span class="o">-</span><span class="n">pip</span><span class="o">.</span><span class="n">py</span> <span class="o">--</span><span class="n">no</span><span class="o">-</span><span class="n">index</span> <span class="o">--</span><span class="n">find</span><span class="o">-</span><span class="n">links</span><span class="o">=/</span><span class="n">local</span><span class="o">/</span><span class="n">copies</span>
</pre></div>
</div>
<p>Install to the user site <a class="footnote-reference" href="#id9" id="id4">[3]</a>:</p>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">python</span> <span class="n">get</span><span class="o">-</span><span class="n">pip</span><span class="o">.</span><span class="n">py</span> <span class="o">--</span><span class="n">user</span>
</pre></div>
</div>
<p>Install behind a proxy:</p>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">python</span> <span class="n">get</span><span class="o">-</span><span class="n">pip</span><span class="o">.</span><span class="n">py</span> <span class="o">--</span><span class="n">proxy</span><span class="o">=</span><span class="s2">"http://[user:passwd@]proxy.server:port"</span>
</pre></div>
</div>
<p><code class="docutils literal"><span class="pre">get-pip.py</span></code> can also be used to install a specified combination of <code class="docutils literal"><span class="pre">pip</span></code>,
<code class="docutils literal"><span class="pre">setuptools</span></code>, and <code class="docutils literal"><span class="pre">wheel</span></code> using the same requirements syntax as <code class="docutils literal"><span class="pre">pip</span></code>:</p>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">python</span> <span class="n">get</span><span class="o">-</span><span class="n">pip</span><span class="o">.</span><span class="n">py</span> <span class="n">pip</span><span class="o">==</span><span class="mf">9.0</span><span class="o">.</span><span class="mi">2</span> <span class="n">wheel</span><span class="o">==</span><span class="mf">0.30</span><span class="o">.</span><span class="mi">0</span> <span class="n">setuptools</span><span class="o">==</span><span class="mf">28.8</span><span class="o">.</span><span class="mi">0</span>
</pre></div>
</div>
</div>
</div>
<div class="section" id="using-linux-package-managers">
<h2>Using Linux Package Managers<a class="headerlink" href="#using-linux-package-managers" title="Permalink to this headline">¶</a></h2>
<p>See <span class="xref std std-ref">pypug:Installing pip/setuptools/wheel with Linux Package Managers</span> in
the <a class="reference external" href="https://packaging.python.org/en/latest/current/">Python Packaging User Guide</a>.</p>
</div>
<div class="section" id="upgrading-pip">
<span id="id5"></span><h2>Upgrading pip<a class="headerlink" href="#upgrading-pip" title="Permalink to this headline">¶</a></h2>
<p>On Linux or macOS:</p>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">pip</span> <span class="n">install</span> <span class="o">-</span><span class="n">U</span> <span class="n">pip</span>
</pre></div>
</div>
<p>On Windows <a class="footnote-reference" href="#id10" id="id6">[4]</a>:</p>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">python</span> <span class="o">-</span><span class="n">m</span> <span class="n">pip</span> <span class="n">install</span> <span class="o">-</span><span class="n">U</span> <span class="n">pip</span>
</pre></div>
</div>
</div>
<div class="section" id="python-and-os-compatibility">
<span id="compatibility-requirements"></span><h2>Python and OS Compatibility<a class="headerlink" href="#python-and-os-compatibility" title="Permalink to this headline">¶</a></h2>
<p>pip works with CPython versions 2.7, 3.4, 3.5, 3.6, 3.7 and also pypy.</p>
<p>This means pip works on the latest patch version of each of these minor
versions. Previous patch versions are supported on a best effort approach.</p>
<p>pip works on Unix/Linux, macOS, and Windows.</p>
<hr class="docutils" />
<table class="docutils footnote" frame="void" id="id7" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
<tr><td class="label"><a class="fn-backref" href="#id2">[1]</a></td><td>“Secure” in this context means using a modern browser or a
tool like <cite>curl</cite> that verifies SSL certificates when downloading from
https URLs.</td></tr>
</tbody>
</table>
<table class="docutils footnote" frame="void" id="id8" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
<tr><td class="label"><a class="fn-backref" href="#id3">[2]</a></td><td>Beginning with pip v1.5.1, <code class="docutils literal"><span class="pre">get-pip.py</span></code> stopped requiring setuptools to
be installed first.</td></tr>
</tbody>
</table>
<table class="docutils footnote" frame="void" id="id9" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
<tr><td class="label"><a class="fn-backref" href="#id4">[3]</a></td><td>The pip developers are considering making <code class="docutils literal"><span class="pre">--user</span></code> the default for all
installs, including <code class="docutils literal"><span class="pre">get-pip.py</span></code> installs of pip, but at this time,
<code class="docutils literal"><span class="pre">--user</span></code> installs for pip itself, should not be considered to be fully
tested or endorsed. For discussion, see <a class="reference external" href="https://github.com/pypa/pip/issues/1668">Issue 1668</a>.</td></tr>
</tbody>
</table>
<table class="docutils footnote" frame="void" id="id10" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
<tr><td class="label"><a class="fn-backref" href="#id6">[4]</a></td><td><a class="reference external" href="https://github.com/pypa/pip/issues/1299">https://github.com/pypa/pip/issues/1299</a></td></tr>
</tbody>
</table>
</div>
</div>
</div>
</div>
</div>
<div class="sphinxsidebar" role="navigation" aria-label="main navigation">
<div class="sphinxsidebarwrapper">
<h3><a href="index.html">Table Of Contents</a></h3>
<ul class="current">
<li class="toctree-l1"><a class="reference internal" href="quickstart.html">Quickstart</a></li>
<li class="toctree-l1 current"><a class="current reference internal" href="#">Installation</a><ul>
<li class="toctree-l2"><a class="reference internal" href="#do-i-need-to-install-pip">Do I need to install pip?</a></li>
<li class="toctree-l2"><a class="reference internal" href="#installing-with-get-pip-py">Installing with get-pip.py</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#get-pip-py-options">get-pip.py options</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#using-linux-package-managers">Using Linux Package Managers</a></li>
<li class="toctree-l2"><a class="reference internal" href="#upgrading-pip">Upgrading pip</a></li>
<li class="toctree-l2"><a class="reference internal" href="#python-and-os-compatibility">Python and OS Compatibility</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="user_guide.html">User Guide</a></li>
<li class="toctree-l1"><a class="reference internal" href="reference/index.html">Reference Guide</a></li>
<li class="toctree-l1"><a class="reference internal" href="development/index.html">Development</a></li>
<li class="toctree-l1"><a class="reference internal" href="news.html">Release Notes</a></li>
</ul>
<h4>Previous topic</h4>
<p class="topless"><a href="quickstart.html"
title="previous chapter">Quickstart</a></p>
<h4>Next topic</h4>
<p class="topless"><a href="user_guide.html"
title="next chapter">User Guide</a></p>
</div>
</div>
<div class="clearer"></div>
</div>
<div class="related" role="navigation" aria-label="related navigation">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="user_guide.html" title="User Guide"
>next</a></li>
<li class="right" >
<a href="quickstart.html" title="Quickstart"
>previous</a> |</li>
<li><img src="_static/py.png" alt=""
style="vertical-align: middle; margin-top: -1px"/></li>
<li><a href="https://pypa.io">PyPA</a> »</li>
<a href="index.html">pip 19.1.1 documentation</a> »
<li class="right">
<div class="inline-search" style="display: none" role="search">
<form class="inline-search" action="search.html" method="get">
<input placeholder="Quick search" type="text" name="q" />
<input type="submit" value="Go" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
<script type="text/javascript">$('.inline-search').show(0);</script>
|
</li>
</ul>
</div>
<div class="footer">
© <a href="copyright.html">Copyright</a> 2008-2017, PyPA.
<br />
The Python Software Foundation is a non-profit corporation.
<a href="https://www.python.org/psf/donations/">Please donate.</a>
<br />
<br />
Last updated on Nov 14, 2019.
<a href="https://github.com/pypa/pip/issues">Found a bug</a>?
<br />
Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.6.5.
</div>
</body>
</html>