Repolode
Enviar
jupyterhub

jupyterhub/repo2docker

Convierte un repositorio Git en una imagen Docker con Jupyter, a partir de los archivos de configuración que contiene.

Ver en GitHubSitio web
Estrellas
1,740
Forks
389
Issues abiertos
199
Último commit
hace 3 horas

¿Qué es?

repo2docker obtiene un repositorio Git, desde GitHub o una ruta local, y crea una imagen de contenedor a partir de los archivos de configuración que contiene. La imagen se prepara para explorar el contenido del repositorio en un entorno Jupyter, lo que facilita compartir un proyecto con sus dependencias ya instaladas.

Para ejecutarlo basta con un solo comando, como jupyter-repo2docker seguido de la URL de un repositorio. Docker debe estar en ejecución en la máquina. Cuando termina la compilación, la herramienta muestra una URL con un token de inicio de sesión que abre Jupyter Notebook con los archivos del repositorio.

El diseño se inspira en Heroku Build Packs: el propio repositorio declara cómo debe construirse el entorno. Es el motor que utilizan los servicios de tipo Binder, y BinderHub puede ejecutarlo dentro de un contenedor si tiene acceso al daemon de Docker. Es compatible con Linux y macOS, y se puede instalar desde PyPI como jupyter-repo2docker.

Funciones clave

  • 01Obtiene un repositorio Git desde GitHub o una ruta local y lo convierte en una imagen Docker.
  • 02Lee los archivos de configuración del repositorio para determinar cómo preparar el entorno.
  • 03Inicia un servidor Jupyter Notebook con el contenido del repositorio cuando termina la compilación.
  • 04Se puede instalar desde PyPI o desde el código fuente con pip.
  • 05Puede ejecutarse dentro de un contenedor si se le proporciona acceso al daemon de Docker, como hace BinderHub.

Casos de uso

  • Empaquetar un repositorio de investigación o docencia para que otras personas puedan ejecutarlo con todas las dependencias preinstaladas.
  • Ejecutar un repositorio de código compartido en un entorno Jupyter reproducible, sin configurarlo manualmente.
  • Ofrecer enlaces de inicio de tipo Binder para un proyecto mediante BinderHub.

Inicio rápido

  1. 1

    Instala Docker (es obligatorio y debe estar en ejecución)

  2. 2

    Instala repo2docker desde PyPI

    pip install jupyter-repo2docker
  3. 3

    Compila y ejecuta un repositorio

    jupyter-repo2docker https://github.com/norvig/pytudes

Antes de usarlo

  • Compatible con Linux y macOS; Windows no cuenta con soporte oficial.
  • Docker debe estar en ejecución en tu equipo.

Temas

#docker#jupyter#reproducibility#containers#notebooks#python#jupyterhub

Preguntas frecuentes

¿Qué es repo2docker?
Convierte un repositorio Git en una imagen Docker con Jupyter, a partir de los archivos de configuración que contiene. repo2docker obtiene un repositorio Git, desde GitHub o una ruta local, y crea una imagen de contenedor a partir de los archivos de configuración que contiene. La imagen se prepara para explorar el contenido del repositorio en un entorno Jupyter, lo que facilita compartir un proyecto con sus dependencias ya instaladas.
¿repo2docker es gratuito? ¿Qué licencia tiene?
repo2docker es open source bajo la licencia BSD-3-Clause. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿repo2docker sigue mantenido?
Mantenimiento activo. El último commit de repo2docker fue el 6 nov 2026.
¿Para qué puedo usar repo2docker?
Empaquetar un repositorio de investigación o docencia para que otras personas puedan ejecutarlo con todas las dependencias preinstaladas. Ejecutar un repositorio de código compartido en un entorno Jupyter reproducible, sin configurarlo manualmente. Ofrecer enlaces de inicio de tipo Binder para un proyecto mediante BinderHub.
¿Cómo se instala repo2docker?
Instala Docker (es obligatorio y debe estar en ejecución) Instala repo2docker desde PyPI: pip install jupyter-repo2docker Compila y ejecuta un repositorio: jupyter-repo2docker https://github.com/norvig/pytudes
¿Dónde consigo repo2docker?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/jupyterhub/repo2docker

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados