install.html


<!DOCTYPE html>

<html lang="en" data-content_root="./">
  <head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="viewport" content="width=device-width, initial-scale=1" />

    <title>Installing IPython &#8212; IPython</title>
    <link rel="stylesheet" type="text/css" href="_static/pygments.css?v=03e43079" />
    <link rel="stylesheet" type="text/css" href="_static/agogo.css?v=9d7b1825" />
    <link rel="stylesheet" href="_static/ipython.css" type="text/css" />
    <script src="_static/documentation_options.js?v=5929fcd5"></script>
    <script src="_static/doctools.js?v=9a2dae69"></script>
    <script src="_static/sphinx_highlight.js?v=dc90522c"></script>
    <link rel="search" title="Search" href="search.html" />
    <link rel="next" title="Microsoft Corporation sponsors IPython" href="microsoft-donation-2013.html" />
    <link rel="prev" title="FAQ" href="faq.html" /> 
  </head><body>
    <div class="header-wrapper">
      <div class="header">
          <div class="logo"><a href="index.html">
            <img class="logo" src="_static/IPy_header.png" alt="Logo"/>
          </a></div>
       
        <div class="rel">
          <a href="https://jupyter.readthedocs.io/en/latest/install.html" target="_blank">Install</a> · 
<a href="documentation.html">Documentation</a> ·
<a href="project.html">Project</a> ·
<a href="https://jupyter.org/" target="_blank">Jupyter</a> · 
<a href="news.html">News</a> · 
<a href="citing.html">Cite</a> ·
<a href="donate.html">Donate</a> ·
<a href="books.html">Books</a>
        </div>
       </div>
    </div>

    <div class="content-wrapper">
      <div class="content">
             
            
      <div class="sphinxsidebar" role="navigation" aria-label="Main">
        <div class="sphinxsidebarwrapper"> 

<div class="sidebarblock">
<h3>Notebook Viewer</h3>

Share your notebooks

<div class="nbviewer-thm-random">
  <script src="_static/nbviewer_thm.js"></script>
  <script type="text/javascript">
    nbviewer_random_thumbnail();
  </script>
</div>

</div>

<div class="sidebarblock">
<h3>Community</h3>

  <ul class="simple">
    <li><a class="reference external" href="http://stackoverflow.com/questions/tagged/ipython">
            Stack Overflow</a></li>
    <li><a class="reference external" href="https://github.com/ipython/ipython/issues">
            File a bug</a></li>
    <li><a class="reference external" href="http://www.reddit.com/r/IPython">
            Reddit</a></li>
  </ul>

</div>
        </div>
      </div>
        
        <div class="document">
            
      <div class="documentwrapper">
        <div class="bodywrapper">
          <div class="body" role="main">
            
  <section id="installing-ipython">
<h1>Installing IPython<a class="headerlink" href="#installing-ipython" title="Link to this heading">¶</a></h1>
<p>There are multiple ways of installing IPython. This page contains simplified installation
instructions that should work for most users. Our official documentation
contains <a class="reference external" href="https://ipython.readthedocs.io/en/stable/install/install.html">more detailed instructions</a>
for manual installation targeted at advanced users and developers.</p>
<p>If you are looking for installation documentation for the notebook and/or qtconsole,
those are now part of <a class="reference external" href="https://jupyter.readthedocs.io/en/latest/install.html">Jupyter</a>.</p>
<section id="i-already-have-python">
<h2>I already have Python<a class="headerlink" href="#i-already-have-python" title="Link to this heading">¶</a></h2>
<p>If you already have Python installed and are familiar with installing packages, you can get IPython with <strong class="command">pip</strong>:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">pip</span> <span class="n">install</span> <span class="n">ipython</span>
</pre></div>
</div>
</section>
<section id="i-am-getting-started-with-python">
<h2>I am getting started with Python<a class="headerlink" href="#i-am-getting-started-with-python" title="Link to this heading">¶</a></h2>
<p>For new users who want to install a full Python environment for scientific computing and
data science, we suggest installing the Anaconda or Canopy Python distributions, which provide Python, IPython and all of its dependences as well as a complete set of open source packages
for scientific computing and data science.</p>
<ol class="arabic simple">
<li><p>Download and install Continuum’s <a class="reference external" href="https://www.continuum.io/downloads">Anaconda</a> or the free edition of Enthought’s <a class="reference external" href="https://www.enthought.com/downloads/">Canopy</a>.</p></li>
<li><p>Update IPython to the current version using the Terminal:</p></li>
</ol>
<blockquote>
<div><p>Anaconda:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">conda</span> <span class="n">update</span> <span class="n">conda</span>
<span class="n">conda</span> <span class="n">update</span> <span class="n">ipython</span>
</pre></div>
</div>
<p>Enthought Canopy:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">enpkg</span> <span class="n">ipython</span>
</pre></div>
</div>
</div></blockquote>
</section>
<section id="downloads">
<span id="id1"></span><h2>Downloads<a class="headerlink" href="#downloads" title="Link to this heading">¶</a></h2>
<p>You can manually download IPython from  <a class="reference external" href="http://github.com/ipython/ipython/releases">GitHub</a> or <a class="reference external" href="http://pypi.python.org/pypi/ipython">PyPI</a>.  To install one of these versions, unpack it and run
the following from the top-level source directory using the Terminal:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">pip</span> <span class="n">install</span> <span class="o">.</span>
</pre></div>
</div>
</section>
</section>


            <div class="clearer"></div>
          </div>
        </div>
      </div>
        </div>
        <div class="clearer"></div>
    </div>
    </div>

    <div class="footer-wrapper">
      
    <div class="footer" role="contentinfo">
    &#169; Copyright the IPython development team. Python is trademark of the Python Software Foundation.
      Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 7.4.7.
    </div>
    </div>

  </body>
</html>