| docs | ||
| git-hooks | ||
| notebook | ||
| scripts | ||
| tools | ||
| .bowerrc | ||
| .dockerignore | ||
| .gitignore | ||
| .gitmodules | ||
| .mailmap | ||
| .travis.yml | ||
| bower.json | ||
| CONTRIBUTING.md | ||
| COPYING.md | ||
| Dockerfile | ||
| MANIFEST.in | ||
| package.json | ||
| README.md | ||
| setup.cfg | ||
| setup.py | ||
| setupbase.py | ||
Jupyter Notebook
The Jupyter notebook is a web-based notebook environment for interactive computing.
Installation
Detailed user installation information can be found on ReadTheDocs.
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 require using
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>`](https://docs.docker.com/machine/reference/ip/).
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
cdinto 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