Go to file
2016-04-08 07:13:37 -05:00
docs Fix typo 2016-04-06 17:42:25 -07:00
git-hooks
notebook Build source map for lab 2016-04-08 07:13:37 -05:00
scripts
tools
.bowerrc
.dockerignore
.gitignore
.gitmodules
.mailmap
.travis.yml retry js tests on travis 2016-03-16 12:10:13 +01:00
bower.json
circle.yml
CONTRIBUTING.rst Minor file name changes 2016-03-24 15:13:48 -07:00
COPYING.md
Dockerfile
MANIFEST.in
package.json
README.md Add links to CONTRIBUTING.rst 2016-03-24 15:05:01 -07:00
readthedocs.yml Add nbsphinx to conda yaml 2016-03-23 19:22:10 -07:00
setup.cfg
setup.py Merge pull request #879 from ellisonbg/nbext-pain 2016-03-25 22:02:22 -07:00
setupbase.py Missing font-awesome css file. 2016-04-05 13:02:08 -04:00
webpack.config.js

Jupyter Notebook

Google Group Build Status Documentation Status

The Jupyter notebook is a web-based notebook environment for interactive computing.

Jupyter notebook example

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 discrete repos. [The Big Split™ announcement] [Jupyter Ascending blog post]

Installation

You can find the installation documentation for the Jupyter platform, on ReadTheDocs. The documentation for advanced usage of Jupyter notebook can be found here.

For a local installation, make sure you have pip installed and run:

$ pip install notebook

Usage - Running Jupyter notebook

Running in a local installation

Launch with:

$ 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 http://localhost:8888/. All notebooks from your session will be saved in the current directory.

On other platforms, such as Windows and OS X, that use docker-machine with docker, a container can be started using docker-machine. In the browser, open the URL http://ip:8888/ where ip is the IP address returned from the command docker-machine ip <MACHINE>:

$ docker-machine ip <MACHINE>

For example,

$ docker-machine ip myjupytermachine
192.168.99.104

In browser, open http://192.168.99.104:8888.

NOTE: With the deprecated boot2docker, use the command boot2docker ip to determine the URL.

Development Installation

See CONTRIBUTING.rst for how to set up a local development installation.

Contributing

If you are interested in contributing to the project, see CONTRIBUTING.rst.

Resources