Go to file
2016-02-02 13:06:03 -08:00
docs Decrease toc depth and highlight general contribution docs 2016-02-02 13:06:03 -08:00
git-hooks Update githooks and description 2015-09-16 11:47:53 -07:00
notebook Merge pull request #1017 from Carreau/requires-require 2016-02-01 11:00:07 +01:00
scripts scripts/lxc-launcher.sh: Remove the LXC launcher as it is now unused. 2015-10-08 00:47:02 -04:00
tools Merge pull request #760 from Carreau/secure-server 2015-12-09 18:37:55 -08:00
.bowerrc s/jupyter_notebook/notebook 2015-05-14 10:49:28 -07:00
.dockerignore Adds a .dockerignore 2015-10-06 00:01:27 +02:00
.gitignore Add generated notebooks rst files to version control 2015-09-24 15:16:38 -07:00
.gitmodules remove submodule 2015-04-21 15:37:09 -07:00
.mailmap fix backward n_pulls, n_issues in github stats 2015-04-03 13:05:18 -07:00
.travis.yml don't install prereleases on Travis 2016-01-28 19:18:01 +01:00
bower.json CodeMirror 5.8 2015-10-21 14:57:15 +01:00
circle.yml circle.yml: Build the Dockerfile as a test step. 2015-10-12 09:57:14 -04:00
CONTRIBUTING.md Flesh out development installation instructions 2015-11-02 09:44:02 -08:00
COPYING.md package skeleton 2015-04-21 15:37:06 -07:00
Dockerfile Merge pull request #547 from jakirkham/docker_ci 2016-01-29 08:40:12 +01:00
MANIFEST.in Add missing files to manifest 2015-07-27 14:54:38 -07:00
package.json Revert "Use NPM, node ES5, and browserify." 2015-08-27 09:00:15 +02:00
README.md Correct copy pasta typos 2016-01-04 09:11:19 -08:00
readthedocs.yml don't install on RTD 2016-01-29 21:20:58 +01:00
setup.cfg package skeleton 2015-04-21 15:37:06 -07:00
setup.py Remove explicit Python 3.3 classifier 2015-12-01 15:00:37 +00:00
setupbase.py Simplify how to pass noprogress 2016-01-26 15:10:37 -08:00

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 Quickstart

Detailed Developer Documentation is available on ReadTheDocs.

  • Ensure that you have node/npm installed (e.g. brew install node on OS X)
  • Clone this repo and cd into it
  • 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.

For more detailed development install instructions (e.g. recompiling javascript and css, running tests), see the Developer Documentation on ReadTheDocs and the contributing guide.

Ubuntu Trusty

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

FreeBSD

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

Resources