Skip to main content

Repo2docker: Turn code repositories into Jupyter enabled Docker Images

Project description

repo2docker

Build Status Documentation Status

repo2docker fetches a git repository and builds a container image based on the configuration files found in the repository.

See the repo2docker documentation for more information on using repo2docker.

For support questions please search or post to https://discourse.jupyter.org/c/binder.

See the contributing guide for information on contributing to repo2docker.

See our roadmap to learn about where the project is heading.

Using repo2docker

Prerequisites

  1. Docker to build & run the repositories. The community edition is recommended.
  2. Python 3.5+.

Supported on Linux and macOS. See documentation note about Windows support.

Installation

This a quick guide to installing repo2docker, see our documentation for a full guide.

To install from PyPI:

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 git repository (from GitHub or locally), build a container image based on the specifications found in the repository & optionally launch the container that you can use to explore the repository.

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. For a list of the configuration files that repo2docker can use, see the complete list of configuration files.

The philosophy of repo2docker is inspired by Heroku Build Packs.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

jupyter-repo2docker-0.10.0.tar.gz (72.5 kB view details)

Uploaded Source

Built Distribution

jupyter_repo2docker-0.10.0-py2.py3-none-any.whl (74.9 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file jupyter-repo2docker-0.10.0.tar.gz.

File metadata

  • Download URL: jupyter-repo2docker-0.10.0.tar.gz
  • Upload date:
  • Size: 72.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.32.2 CPython/3.6.7

File hashes

Hashes for jupyter-repo2docker-0.10.0.tar.gz
Algorithm Hash digest
SHA256 7965262913be6be60e64c8016f5f3d4bf93701f2787209215859d73b2adbc05a
MD5 69a9376cacf253c4ecc521b0488c8de2
BLAKE2b-256 2d3d31541ef606aeee9d70d31e061f56be310560e9bb78f57c80cbe28fc9c56f

See more details on using hashes here.

Provenance

File details

Details for the file jupyter_repo2docker-0.10.0-py2.py3-none-any.whl.

File metadata

  • Download URL: jupyter_repo2docker-0.10.0-py2.py3-none-any.whl
  • Upload date:
  • Size: 74.9 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.32.2 CPython/3.6.7

File hashes

Hashes for jupyter_repo2docker-0.10.0-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 baefdde940482b087a0aee8c72941461a4dbb2aa71dee3ccf4f00e20908d2da5
MD5 61a3457fc8fb1c67d9773e27a54a5910
BLAKE2b-256 72e2fd02fed40be3169d9489d37bd71f6e2b6e841f1609eb10dbcc4e6d80636f

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page