pip_install_en.html



<!DOCTYPE html>
<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
<head>
  <meta charset="utf-8">
  
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  
  <title>Install using pip &mdash; PaddlePaddle  documentation</title>
  

    <link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
  

        <link rel="index" title="Index"
              href="../genindex.html"/>
        <link rel="search" title="Search" href="../search.html"/>
    <link rel="top" title="PaddlePaddle  documentation" href="../index.html"/>
        <link rel="up" title="Install and Build" href="index_en.html"/>
        <link rel="next" title="Run in Docker Containers" href="docker_install_en.html"/>
        <link rel="prev" title="Install and Build" href="index_en.html"/> 

  
  <script src="../_static/js/modernizr.min.js"></script>

</head>

<body class="wy-body-for-nav" role="document">

  <div class="wy-grid-for-nav">

    
    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
      <div class="wy-side-scroll">
        <div class="wy-side-nav-search">
          

            <a href="../index_en.html" class="icon icon-home"> PaddlePaddle
          

          </a>

          
<div role="search">
  <form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
    <input type="text" name="q" placeholder="Search docs" />
    <input type="hidden" name="check_keywords" value="yes" />
    <input type="hidden" name="area" value="default" />
  </form>
</div>

          
        </div>

        <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
          
            
                <ul class="current">
<li class="toctree-l1"><a class="reference internal" href="../getstarted/index_en.html">GET STARTED</a></li>
<li class="toctree-l1 current"><a class="reference internal" href="index_en.html">Install and Build</a><ul class="current">
<li class="toctree-l2 current"><a class="reference internal" href="index_en.html#install-steps">Install Steps</a><ul class="current">
<li class="toctree-l3 current"><a class="current reference internal" href="#">Install using pip</a><ul>
<li class="toctree-l4"><a class="reference internal" href="#pip-install">Install using pip</a></li>
<li class="toctree-l4"><a class="reference internal" href="#runtime-dependency">Runtime Dependency</a></li>
<li class="toctree-l4"><a class="reference internal" href="#faq">FAQ</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="docker_install_en.html">Run in Docker Containers</a></li>
<li class="toctree-l3"><a class="reference internal" href="index_en.html#build-from-source">Build from Source</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="index_en.html#faq">FAQ</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="../howto/index_en.html">HOW TO</a></li>
<li class="toctree-l1"><a class="reference internal" href="../dev/index_en.html">Development</a></li>
<li class="toctree-l1"><a class="reference internal" href="../faq/index_en.html">FAQ</a></li>
</ul>

            
        </div>
      </div>
    </nav>

    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">

      
      <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
        <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
        <a href="../index_en.html">PaddlePaddle</a>
      </nav>


      <div class="wy-nav-content">
        <div class="rst-content">
          

<div role="navigation" aria-label="breadcrumbs navigation">
  <ul class="wy-breadcrumbs">
    <li><a href="../index_en.html">Docs</a> &raquo;</li>
      
          <li><a href="index_en.html">Install and Build</a> &raquo;</li>
      
    <li>Install using pip</li>
      <li class="wy-breadcrumbs-aside">
        
          
            <a href="../_sources/build_and_install/pip_install_en.rst.txt" rel="nofollow"> View page source</a>
          
        
      </li>
  </ul>
  <hr/>
</div>
          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
           <div itemprop="articleBody">
            
  <div class="section" id="install-using-pip">
<h1>Install using pip<a class="headerlink" href="#install-using-pip" title="Permalink to this headline">¶</a></h1>
<p>You can use current widely used Python package management
tool <a class="reference external" href="https://pip.pypa.io/en/stable/installing/">pip</a>
to install PaddlePaddle. This method can be used in
most of current Linux systems or MacOS.</p>
<div class="section" id="pip-install">
<span id="id1"></span><h2>Install using pip<a class="headerlink" href="#pip-install" title="Permalink to this headline">¶</a></h2>
<p>Run the following command to install PaddlePaddle on the current
machine, it will also download requirements, the version is cpu_avx_openblas.</p>
<blockquote>
<div><div class="highlight-bash"><div class="highlight"><pre><span></span>pip install paddlepaddle
</pre></div>
</div>
</div></blockquote>
<p>If you wish to install GPU version (cuda7.5_cudnn5_avx_openblas), just run:</p>
<blockquote>
<div><div class="highlight-bash"><div class="highlight"><pre><span></span>pip install paddlepaddle-gpu
</pre></div>
</div>
</div></blockquote>
<p>If you wish to install the latest develop branch PaddlePaddle,
you can download the latest whl package from our CI system. Access
the below links, log in as guest, then click at the &#8220;Artifact&#8221;
tab, you&#8217;ll find the download link of whl packages.</p>
<p>If the links below shows up the login form, just click &#8220;Log in as guest&#8221; to start the download:</p>
<a class="reference internal image-reference" href="../_images/paddleci.png"><img alt="../_images/paddleci.png" class="align-center" src="../_images/paddleci.png" style="width: 398.0px; height: 224.5px;" /></a>
<table border="1" class="colwidths-given docutils" id="id13">
<caption><span class="caption-text">whl package of each version</span><a class="headerlink" href="#id13" title="Permalink to this table">¶</a></caption>
<colgroup>
<col width="10%" />
<col width="30%" />
<col width="30%" />
<col width="30%" />
</colgroup>
<thead valign="bottom">
<tr class="row-odd"><th class="head">version</th>
<th class="head">cp27-cp27mu</th>
<th class="head">cp27-cp27m</th>
<th class="head">C-API</th>
</tr>
</thead>
<tbody valign="top">
<tr class="row-even"><td>cpu_avx_mkl</td>
<td><a class="reference external" href="https://guest:&#64;paddleci.ngrok.io/repository/download/Manylinux1_CpuAvxCp27cp27mu/.lastSuccessful/paddlepaddle-0.11.0-cp27-cp27mu-linux_x86_64.whl">paddlepaddle-0.11.0-cp27-cp27mu-linux_x86_64.whl</a></td>
<td><a class="reference external" href="https://guest:&#64;paddleci.ngrok.io/repository/download/Manylinux1_CpuAvxCp27cp27mu/.lastSuccessful/paddlepaddle-0.11.0-cp27-cp27m-linux_x86_64.whl">paddlepaddle-0.11.0-cp27-cp27m-linux_x86_64.whl</a></td>
<td><a class="reference external" href="https://guest:&#64;paddleci.ngrok.io/repository/download/Manylinux1_CpuAvxCp27cp27mu/.lastSuccessful/paddle.tgz">paddle.tgz</a></td>
</tr>
<tr class="row-odd"><td>cpu_avx_openblas</td>
<td><a class="reference external" href="https://guest:&#64;paddleci.ngrok.io/repository/download/Manylinux1_CpuAvxOpenblas/.lastSuccessful/paddlepaddle-0.11.0-cp27-cp27mu-linux_x86_64.whl">paddlepaddle-0.11.0-cp27-cp27mu-linux_x86_64.whl</a></td>
<td><a class="reference external" href="https://guest:&#64;paddleci.ngrok.io/repository/download/Manylinux1_CpuAvxOpenblas/.lastSuccessful/paddlepaddle-0.11.0-cp27-cp27m-linux_x86_64.whl">paddlepaddle-0.11.0-cp27-cp27m-linux_x86_64.whl</a></td>
<td>Not Available</td>
</tr>
<tr class="row-even"><td>cpu_noavx_openblas</td>
<td><a class="reference external" href="https://guest:&#64;paddleci.ngrok.io/repository/download/Manylinux1_CpuNoavxOpenblas/.lastSuccessful/paddlepaddle-0.11.0-cp27-cp27mu-linux_x86_64.whl">paddlepaddle-0.11.0-cp27-cp27mu-linux_x86_64.whl</a></td>
<td><a class="reference external" href="https://guest:&#64;paddleci.ngrok.io/repository/download/Manylinux1_CpuNoavxOpenblas/.lastSuccessful/paddlepaddle-0.11.0-cp27-cp27m-linux_x86_64.whl">paddlepaddle-0.11.0-cp27-cp27m-linux_x86_64.whl</a></td>
<td>Not Available</td>
</tr>
<tr class="row-odd"><td>cuda7.5_cudnn5_avx_mkl</td>
<td><a class="reference external" href="https://guest:&#64;paddleci.ngrok.io/repository/download/Manylinux1_Cuda75cudnn5cp27cp27mu/.lastSuccessful/paddlepaddle_gpu-0.11.0-cp27-cp27mu-linux_x86_64.whl">paddlepaddle_gpu-0.11.0-cp27-cp27mu-linux_x86_64.whl</a></td>
<td><a class="reference external" href="https://guest:&#64;paddleci.ngrok.io/repository/download/Manylinux1_Cuda75cudnn5cp27cp27mu/.lastSuccessful/paddlepaddle_gpu-0.11.0-cp27-cp27m-linux_x86_64.whl">paddlepaddle_gpu-0.11.0-cp27-cp27m-linux_x86_64.whl</a></td>
<td><a class="reference external" href="https://guest:&#64;paddleci.ngrok.io/repository/download/Manylinux1_Cuda75cudnn5cp27cp27mu/.lastSuccessful/paddle.tgz">paddle.tgz</a></td>
</tr>
<tr class="row-even"><td>cuda8.0_cudnn5_avx_mkl</td>
<td><a class="reference external" href="https://guest:&#64;paddleci.ngrok.io/repository/download/Manylinux1_Cuda80cudnn5cp27cp27mu/.lastSuccessful/paddlepaddle_gpu-0.11.0-cp27-cp27mu-linux_x86_64.whl">paddlepaddle_gpu-0.11.0-cp27-cp27mu-linux_x86_64.whl</a></td>
<td><a class="reference external" href="https://guest:&#64;paddleci.ngrok.io/repository/download/Manylinux1_Cuda80cudnn5cp27cp27mu/.lastSuccessful/paddlepaddle_gpu-0.11.0-cp27-cp27m-linux_x86_64.whl">paddlepaddle_gpu-0.11.0-cp27-cp27m-linux_x86_64.whl</a></td>
<td><a class="reference external" href="https://guest:&#64;paddleci.ngrok.io/repository/download/Manylinux1_Cuda80cudnn5cp27cp27mu/.lastSuccessful/paddle.tgz">paddle.tgz</a></td>
</tr>
<tr class="row-odd"><td>cuda8.0_cudnn7_avx_mkl</td>
<td><a class="reference external" href="https://guest:&#64;paddleci.ngrok.io/repository/download/Manylinux1_Cuda8cudnn7cp27cp27mu/.lastSuccessful/paddlepaddle_gpu-0.11.0-cp27-cp27mu-linux_x86_64.whl">paddlepaddle_gpu-0.11.0-cp27-cp27mu-linux_x86_64.whl</a></td>
<td><a class="reference external" href="https://guest:&#64;paddleci.ngrok.io/repository/download/Manylinux1_Cuda8cudnn7cp27cp27mu/.lastSuccessful/paddlepaddle_gpu-0.11.0-cp27-cp27m-linux_x86_64.whl">paddlepaddle_gpu-0.11.0-cp27-cp27m-linux_x86_64.whl</a></td>
<td><a class="reference external" href="https://guest:&#64;paddleci.ngrok.io/repository/download/Manylinux1_Cuda8cudnn7cp27cp27mu/.lastSuccessful/paddle.tgz">paddle.tgz</a></td>
</tr>
</tbody>
</table>
</div>
<div class="section" id="runtime-dependency">
<span id="pip-dependency"></span><h2>Runtime Dependency<a class="headerlink" href="#runtime-dependency" title="Permalink to this headline">¶</a></h2>
<p>PaddlePaddle installation packages (whl) does not only contain .py files,
but also binaries built from C++ code. We ensure that PaddlePaddle can
run on current mainline Linux distributions, like CentOS 6, Ubuntu 14.04
and MacOS 10.12.</p>
<p>PaddlePaddle whl packages are trying to satisfy
<a class="reference external" href="https://www.python.org/dev/peps/pep-0513/#the-manylinux1-policy">manylinux1</a>
standard, which uses CentOS 5 as default build environment. But CUDA libraries
seems only run on CentOS 6 at least, also, CentOS 5 is about to end its lifetime,
so we use CentOS 6 as default build environment.</p>
<table border="1" class="colwidths-given docutils" id="id14">
<caption><span class="caption-text">PaddlePaddle Runtime Deps</span><a class="headerlink" href="#id14" title="Permalink to this table">¶</a></caption>
<colgroup>
<col width="18%" />
<col width="27%" />
<col width="55%" />
</colgroup>
<thead valign="bottom">
<tr class="row-odd"><th class="head">Dependency</th>
<th class="head">version</th>
<th class="head">description</th>
</tr>
</thead>
<tbody valign="top">
<tr class="row-even"><td>OS</td>
<td>Linux, MacOS</td>
<td>CentOS 6 or later，Ubuntu 14.04 or later，MacOS 10.12 or later</td>
</tr>
<tr class="row-odd"><td>Python</td>
<td>2.7.x</td>
<td>Currently Python3 is not supported</td>
</tr>
<tr class="row-even"><td>libc.so</td>
<td>GLIBC_2.7</td>
<td>glibc at least include GLIBC_2.7 symbols</td>
</tr>
<tr class="row-odd"><td>libstdc++.so</td>
<td>GLIBCXX_3.4.11, CXXABI_1.3.3</td>
<td>At least include GLIBCXX_3.4.11, CXXABI_1.3.3 symbols</td>
</tr>
<tr class="row-even"><td>libgcc_s.so</td>
<td>GCC_3.3</td>
<td>At least include GCC_3.3 symbols</td>
</tr>
</tbody>
</table>
</div>
<div class="section" id="faq">
<span id="pip-faq"></span><h2>FAQ<a class="headerlink" href="#faq" title="Permalink to this headline">¶</a></h2>
<ul>
<li><p class="first">paddlepaddle*.whl is not a supported wheel on this platform.</p>
<p>The main cause of this issue is that your current platform is
not supported. Please check that you are using Python 2.7 series.
Besides, pypi only supports manylinux1 standard, you&#8217;ll need to
upgrade your pip to &gt;9.0.0. Then run the below command:</p>
<blockquote>
<div><div class="highlight-bash"><div class="highlight"><pre><span></span>pip install --upgrade pip
</pre></div>
</div>
</div></blockquote>
<p>If the problem still exists, run the following command:</p>
<blockquote>
<div><div class="highlight-bash"><div class="highlight"><pre><span></span>python -c <span class="s2">&quot;import pip; print(pip.pep425tags.get_supported())&quot;</span>
</pre></div>
</div>
</div></blockquote>
<p>Then you&#8217;ll get supported package suffixes, then check if it matches
the file name of the whl package. You can find default whl package at
<a class="reference external" href="https://pypi.python.org/pypi/paddlepaddle/0.10.5">here</a></p>
<p>If your system supports linux_x86_64 but the whl package is manylinux1_x86_64,
you&#8217;ll need to update pip to the latest version; If your system supports
manylinux1_x86_64 but the whl package is linux_x86_64 you can rename the
file to manylinux1_x86_64 suffix and then install.</p>
</li>
</ul>
</div>
</div>


           </div>
          </div>
          <footer>
  
    <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
      
        <a href="docker_install_en.html" class="btn btn-neutral float-right" title="Run in Docker Containers" accesskey="n">Next <span class="fa fa-arrow-circle-right"></span></a>
      
      
        <a href="index_en.html" class="btn btn-neutral" title="Install and Build" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous</a>
      
    </div>
  

  <hr/>

  <div role="contentinfo">
    <p>
        &copy; Copyright 2016, PaddlePaddle developers.

    </p>
  </div>
  Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>. 

</footer>

        </div>
      </div>

    </section>

  </div>
  

    <script type="text/javascript">
        var DOCUMENTATION_OPTIONS = {
            URL_ROOT:'../',
            VERSION:'',
            COLLAPSE_INDEX:false,
            FILE_SUFFIX:'.html',
            HAS_SOURCE:  true
        };
    </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="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.0/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>

  
    <script type="text/javascript" src="../_static/js/theme.js"></script>
  

  <script type="text/javascript">
      jQuery(function () {
          SphinxRtdTheme.StickyNav.enable();
      });
  </script>
   

</body>
</html>