<h1>FAQ<aclass="headerlink" href="#faq" title="Link to this heading">¶</a></h1>
<p>If your question isn’t answered below, check <aclass="reference external" href="https://ipython.org/ipython-doc/">the docs</a>, then ask on the <aclass="reference external" href="https://mail.python.org/mailman/listinfo/ipython-dev">mailing list</a>.</p>
<navclass="contents local" id="contents">
<ulclass="simple">
<li><p><aclass="reference internal" href="#can-ipython-run-under-ironpython-pypy-jython-other-python-interpreters" id="id1">Can IPython run under IronPython/PyPy/Jython/other Python interpreters?</a></p></li>
<li><p><aclass="reference internal" href="#ipython-crashes-under-os-x-when-using-the-arrow-keys" id="id2">IPython crashes under OS X when using the arrow keys</a></p></li>
<li><p><aclass="reference internal" href="#does-ipython-play-well-with-windows" id="id3">Does IPython play well with Windows?</a></p></li>
<li><p><aclass="reference internal" href="#what-is-the-best-way-to-install-ipython" id="id4">What is the best way to install IPython?</a></p></li>
<h2>Can IPython run under IronPython/PyPy/Jython/other Python interpreters?<aclass="headerlink" href="#can-ipython-run-under-ironpython-pypy-jython-other-python-interpreters" title="Link to this heading">¶</a></h2>
<p>The terminal-based shell should run on any interpreter which complies with
the necessary version of Python. IPython 0.11 requires Python 2.6
or above, and as of June 2011, IronPython and PyPy both support this.</p>
<p>The most likely problems would come from Readline and from using the undocumented
sys._getframe() function. On Windows we ship our own <aclass="reference external" href="pyreadline.html">pyreadline</a>,
which might also work under IronPython. PyPy ships its own readline module,
which should now work.</p>
<p>If IPython does not work under a supported interpreter, please
<aclass="reference external" href="https://github.com/ipython/ipython/issues">file a bug</a>.</p>
<h2>IPython crashes under OS X when using the arrow keys<aclass="headerlink" href="#ipython-crashes-under-os-x-when-using-the-arrow-keys" title="Link to this heading">¶</a></h2>
<p>Under some circumstances, using the arrow keys to navigate your input history can cause a complete crash of the Python interpreter.</p>
<p><strong>Answer:</strong> This is due to a bug in the readline library from the official builds. There are a few solutions you can take:</p>
<blockquote>
<div><olclass="arabic">
<li><p>Use a different Python version from Apple’s default (MacPython or Fink have been reported to work)</p></li>
<li><p>You can disable in your ipythonrc file the following lines by commenting them out:</p>
<p>You will lose searching in your history with the arrow keys, but at least Python won’t crash.</p>
</section>
<sectionid="does-ipython-play-well-with-windows">
<h2>Does IPython play well with Windows?<aclass="headerlink" href="#does-ipython-play-well-with-windows" title="Link to this heading">¶</a></h2>
<p>Yes, it most definitely does! There are some things that should be noted: <aclass="reference external" href="https://ipython.org/ipython-doc/stable/install/install.html#windows">see
<h2>What is the best way to install IPython?<aclass="headerlink" href="#what-is-the-best-way-to-install-ipython" title="Link to this heading">¶</a></h2>
<p>See <aclass="reference external" href="https://ipython.org/ipython-doc/stable/install/install.html#installing-ipython-itself">the installation documentation</a> for full details.</p>
<p>The standard Python installation mechanisms (<codeclass="docutils literal notranslate"><spanclass="pre">setup.py</span></code>, <codeclass="docutils literal notranslate"><spanclass="pre">pip</span></code> or <codeclass="docutils literal notranslate"><spanclass="pre">easy_install</span></code>) all work for installing IPython to use in a terminal. Windows users are best off installing <aclass="reference external" href="https://pypi.python.org/pypi/distribute">distribute</a>, then running the .exe installer, to create start menu shortcuts.</p>
<p>To use the notebook or the Qt console, it’s easiest to install through a package manager, or download a Python distribution such as <aclass="reference external" href="https://store.continuum.io/cshop/anaconda">Anaconda</a> or <aclass="reference external" href="https://www.enthought.com/downloads/">Enthought Canopy</a>. Otherwise, you will need to install pyzmq, along with tornado for the notebook, and PyQt4/PySide and pygments for the Qt console.</p>
</section>
</section>
<divclass="clearer"></div>
</div>
</div>
</div>
</div>
<divclass="clearer"></div>
</div>
</div>
<divclass="footer-wrapper">
<divclass="footer" role="contentinfo">
© Copyright the IPython development team. Python is trademark of the Python Software Foundation.
Created using <ahref="https://www.sphinx-doc.org/">Sphinx</a> 7.4.7.