.. _install:


============
Installation
============

The following is a quick start overview of installing the Jupyter Notebook and kernels. For detailed installation
instructions for individual Jupyter or IPython projects, please see the documentation and/or GitHub repos
of the individual projects listed :ref:`here <landing>`.

Installing the Jupyter Notebook
-------------------------------

While the Jupyter Notebook allows users to run code in many different programming
language, the Notebook itself is implemented in Python.

**If you already have Python**, you can install the notebook using pip::

    pip install jupyter


**If you're new to Python**, we recommend installing `Anaconda
<http://continuum.io/downloads#py34>`_, a Python distribution which includes
Jupyter. After you install it, ensure that Jupyter is up to date by running::

    conda update jupyter

To **upgrade from IPython 3 or older to Jupyter**, use pip or conda—according
to which one IPython was installed with—to install the ``jupyter`` package. This
should install the Jupyter Notebook and upgrade IPython to version 4.

Installing kernels
------------------

Installing the Jupyter Notebook should also have installed the `IPython kernel
<http://ipython.readthedocs.org/en/master/>`_ for the Python programming language.

To run notebooks in other languages, you'll need to install additional kernels:
see the `list of available kernels
<https://github.com/ipython/ipython/wiki/IPython-kernels-for-other-languages>`_.

.. _install:


============
Installation
============

The following is a quick start overview of installing the Jupyter Notebook and kernels. For detailed installation
instructions for individual Jupyter or IPython projects, please see the documentation and/or GitHub repos
of the individual projects listed :ref:`here <landing>`.

Installing the Jupyter Notebook
-------------------------------

While the Jupyter Notebook allows users to run code in many different programming
language, the Notebook itself is implemented in Python.

**If you already have Python**, you can install the notebook using pip::

    pip install jupyter


**If you're new to Python**, we recommend installing `Anaconda
<http://continuum.io/downloads#py34>`_, a Python distribution which includes
Jupyter. After you install it, ensure that Jupyter is up to date by running::

    conda update jupyter

.. note::

   Jupyter has just been released, and it will be packaged for conda in a few
   days. In the meantime, all of the Jupyter functionality is included in
   the latest packaged version of IPython. Make sure that the ``ipython`` and
   ``ipython-notebook`` packages are installed.

To **upgrade from IPython 3 or older to Jupyter**, use pip or conda—according
to which one IPython was installed with—to install the ``jupyter`` package. This
should install the Jupyter Notebook and upgrade IPython to version 4.

Installing kernels
------------------

Installing the Jupyter Notebook should also have installed the `IPython kernel
<http://ipython.readthedocs.org/en/master/>`_ for the Python programming language.

To run notebooks in other languages, you'll need to install additional kernels:
see the `list of available kernels
<https://github.com/ipython/ipython/wiki/IPython-kernels-for-other-languages>`_.

Add note that it's not packaged in conda yet
Add note that it's not packaged in conda yet
