# jupyterhub/repo2docker

Turn repositories into Jupyter-enabled Docker images

Repository: https://github.com/jupyterhub/repo2docker
Canonical: https://ross.abutalabs.com/products/repo2docker
Homepage: https://repo2docker.readthedocs.io
Language: Python
License: BSD-3-Clause
License Family: permissive
Topics: jupyterhub, jupyter, docker
Last push: 2026-08-21T20:07:47+00:00

## Health v2 (maintenance only)
Score: 84/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 98, release rhythm 56, longevity 100
- inputs: {"age_days": 3403, "days_push": 12, "days_rel": 132, "gap_med": 128, "n_releases_24m": 4}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1732, forks 387 (observed 2026-08-28T04:05:28.787069+00:00)

## What it is
repo2docker is a Python CLI tool that fetches a git repository and builds a Docker container image from its configuration files, optionally launching a Jupyter-enabled environment. It powers Binder and enables reproducible computational environments from source repositories.

## Use cases
- turn a github repo into a runnable jupyter docker image
- build reproducible environments for data science notebooks
- launch a repository's code in a container with jupyter
- create container images from requirements.txt or environment.yml
- reproduce a paper's computational environment from its repo
- run arbitrary git repositories locally without manual setup

## When to choose
- you want reproducible Jupyter environments directly from git repositories
- you run a BinderHub or need Binder-compatible image builds
- you want to respect repo config files like requirements.txt, environment.yml, or postBuild

## When to avoid
- you need general-purpose Docker image building without Jupyter conventions
- you work primarily on native Windows without WSL/Docker
- you need lightweight environments without Docker installed

## Facets
- artifact type: cli-tool
- maturity: active
- function: container-runtime, build-tool, developer-tools, cli
- domain: developer-tools, data-science
- platform: python, cli
- tags: jupyter, docker-images, reproducibility, binder, git-repositories, containers, devops, linux, macos, docker

## Member repositories
- jupyterhub/repo2docker (main) score 84

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:28.787069+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:31:30.780495+00:00, confidence not recorded.
  - readme: https://github.com/jupyterhub/repo2docker (fetched 2026-08-28T04:05:28.787069+00:00, sha 38ac753ed042)
- Data as of 2026-08-30T08:39:29.467469+00:00.