<inputtype="image" src="https://www.paypalobjects.com/en_US/i/btn/btn_donateCC_LG.gif" border="0" name="submit" alt="PayPal - The safer, easier way to pay online!">
<h1>FAQ<aclass="headerlink" href="#faq" title="Permalink to this headline">¶</a></h1>
<p>If your question isn’t answered below, check <aclass="reference external" href="http://ipython.org/ipython-doc/">the docs</a>, then ask on the <aclass="reference external" href="http://mail.scipy.org/mailman/listinfo/ipython-dev">mailing list</a>.</p>
<divclass="contents local topic" id="contents">
<ulclass="simple">
<li><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></li>
<li><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></li>
<li><aclass="reference internal" href="#does-ipython-play-well-with-windows" id="id3">Does IPython play well with Windows?</a></li>
<li><aclass="reference internal" href="#what-is-the-best-way-to-install-ipython" id="id4">What is the best way to install IPython?</a></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="Permalink to this headline">¶</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="Permalink to this headline">¶</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><pclass="first">Use a different Python version from Apple’s default (MacPython or Fink have been reported to work)</p>
</li>
<li><pclass="first">You can disable in your ipythonrc file the following lines by commenting them out:</p>
<h2>Does IPython play well with Windows?<aclass="headerlink" href="#does-ipython-play-well-with-windows" title="Permalink to this headline">¶</a></h2>
<p>Yes, it most definitely does! There are some things that should be noted: <aclass="reference external" href="http://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="Permalink to this headline">¶</a></h2>
<p>See <aclass="reference external" href="http://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 (<ttclass="docutils literal"><spanclass="pre">setup.py</span></tt>, <ttclass="docutils literal"><spanclass="pre">pip</span></tt> or <ttclass="docutils literal"><spanclass="pre">easy_install</span></tt>) 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>