mirror of https://github.com/jupyter/notebook.git synced 2024-12-15 04:00:34 +08:00

Go to file

Min RK d1d81f8015 get package version for docs so we don't need to manually update version strings		2015-12-22 14:05:25 +01:00
docs	get package version for docs	2015-12-22 14:05:25 +01:00
git-hooks	Update githooks and description	2015-09-16 11:47:53 -07:00
notebook	Removed "window."	2015-12-21 12:18:15 -06: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	Rework multiple selections to be continuous	2015-12-02 14:15:09 +01:00
bower.json	CodeMirror 5.8	2015-10-21 14:57:15 +01: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	Dockerfile: Add a basic jupyter notebook profile. Allow for IPs from anywhere to connect by adding this into the the jupyter notebook profile.	2015-10-12 09:18:39 -04: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	Flesh out development installation instructions	2015-11-02 09:44:02 -08:00
setup.cfg	package skeleton	2015-04-21 15:37:06 -07:00
setup.py	Assume versions are normalised in setup.py	2015-12-14 16:58:42 +01:00
setupbase.py	Assume versions are normalised in setup.py	2015-12-14 16:58:42 +01:00

README.md

Jupyter Notebook

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

Usage

Local installation

Launch with:

$ jupyter notebook

In a Docker container

If you 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 without docker, this can be started using docker-machine by replacing localhost with an IP from docker-machine ip <MACHINE>. With the deprecated boot2docker, this IP will be boot2docker ip.

Installation

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

$ pip install notebook

Dev quickstart

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), please see 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