Repo2docker: Turn code repositories into Jupyter enabled Docker Images
Project description
jupyter-repo2docker
jupyter-repo2docker takes as input a repository source, such as a GitHub repository. It then builds, runs, and/or pushes Docker images built from that source.
See the repo2docker documentation for more information.
Prerequisites
- Docker to build & run the repositories. The community edition is recommended.
- Python 3.4+.
Supported on Linux and macOS. See documentation note about Windows support.
Installation
To install from PyPI, the python packaging index, using pip:
pip install jupyter-repo2docker
To install from source:
git clone https://github.com/jupyter/repo2docker.git
cd repo2docker
pip install -e .
Usage
The core feature of repo2docker is to fetch a repository (from GitHub or locally), build a container image based on the specifications found in the repository & optionally launch a local Jupyter Notebook you can use to explore it.
Note that Docker needs to be running on your machine for this to work.
Example:
jupyter-repo2docker https://github.com/norvig/pytudes
After building (it might take a while!), it should output in your terminal something like:
Copy/paste this URL into your browser when you connect for the first time,
to login with a token:
http://0.0.0.0:36511/?token=f94f8fabb92e22f5bfab116c382b4707fc2cade56ad1ace0
If you copy paste that URL into your browser you will see a Jupyter Notebook with the contents of the repository you had just built!
For more information on how to use repo2docker, see the
usage guide.
Repository specifications
Repo2Docker looks for configuration files in the source repository to determine how the Docker image should be built. It is philosophically similar to Heroku Build Packs.
For a list of the configuration files that repo2docker can use,
see the usage guide.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file jupyter-repo2docker-0.6.0.tar.gz.
File metadata
- Download URL: jupyter-repo2docker-0.6.0.tar.gz
- Upload date:
- Size: 51.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.19.1 setuptools/40.2.0 requests-toolbelt/0.8.0 tqdm/4.25.0 CPython/3.6.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 32c6dc6fd2402d6f5a955f8ab59299097bb5f4972c7dcc6fe2a8fe4c96dcab27 |
|
| MD5 | 0418ad4854fe7ecd33246fae6e5343c6 |
|
| BLAKE2b-256 | fbd40693d98f05a62567bdf4d70ee9b67c166ea9f66cc2b89ad5a2c40e3790fd |
Provenance
File details
Details for the file jupyter_repo2docker-0.6.0-py2.py3-none-any.whl.
File metadata
- Download URL: jupyter_repo2docker-0.6.0-py2.py3-none-any.whl
- Upload date:
- Size: 45.0 kB
- Tags: Python 2, Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.19.1 setuptools/40.2.0 requests-toolbelt/0.8.0 tqdm/4.25.0 CPython/3.6.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 26045ae624a0f61db518f043b0495549238d9af9a8d3fc1ecbfe006d1fed649e |
|
| MD5 | 11a5d456628a931f1cc3b2d258672d31 |
|
| BLAKE2b-256 | 3313b34d39168265975a4c2c4cde14130ce8b03dbe58eb4f59b3271558ed7f89 |
