The Jupyter notebook is a web-based notebook environment for interactive
Jupyter notebook, the language-agnostic evolution of IPython notebook
Jupyter notebook is the language-agnostic HTML notebook application for
Project Jupyter. In 2015, Jupyter notebook was released as part of
The Big Split™ of the IPython codebase. IPython 3 was the last major monolithic
release containing both language-agnostic code, such as the IPython notebook,
and language specific code, such as the IPython kernel for Python. As
computing spans many languages, Project Jupyter will continue to develop the
language-agnostic Jupyter notebook in this repo and with the help of the
community develop language specific kernels which are found in their own
[The Big Split™ announcement]
[Jupyter Ascending blog post]
For a local installation, make sure you have
pip installed and run:
$ pip install notebook
Usage - Running Jupyter notebook
Running in a local installation
$ jupyter notebook
Running in a Docker container
If you are using Linux and have a
Docker daemon running,
e.g. reachable on
localhost, start a container with:
$ docker run --rm -it -p 8888:8888 -v "$(pwd):/notebooks" jupyter/notebook
In your browser, open the URL
All notebooks from your session will be saved in the current directory.
On other platforms, such as Windows and OS X, that use
docker, a container can be started using
docker-machine. In the browser, open the URL
the IP address returned from the command
docker-machine ip <MACHINE>:
$ docker-machine ip <MACHINE>
$ docker-machine ip myjupytermachine 192.168.99.104
In browser, open
NOTE: With the deprecated
boot2docker, use the command
boot2docker ip to
determine the URL.
Development Installation Quickstart
Detailed Developer Documentation
is available on ReadTheDocs.
- Ensure that you have node/npm installed (e.g.
brew install nodeon OS X)
- Clone this repo and
pip install --pre -e .
NOTE: For Debian/Ubuntu systems, if you're installing the system node you
need to use the 'nodejs-legacy' package and not the 'node' package.
sudo apt-get install nodejs-legacy npm python-virtualenv python-dev # ensure setuptools/pip are up-to-date pip install --upgrade setuptools pip git clone https://github.com/jupyter/notebook.git cd notebook pip install --pre -e . jupyter notebook
cd /usr/ports/www/npm sudo make install # (Be sure to select the "NODE" option) cd /usr/ports/devel/py-pip sudo make install cd /usr/ports/devel/py-virtualenv sudo make install cd /usr/ports/shells/bash sudo make install mkdir -p ~/.virtualenvs python2.7 -m virtualenv ~/.virtualenvs/notebook bash source ~/.virtualenvs/notebook/bin/activate pip install --upgrade setuptools pip pycurl git clone https://github.com/jupyter/notebook.git cd notebook pip install -r requirements.txt -e . jupyter notebook