Repolode
jupyterhub

jupyterhub/repo2docker

Собирает git-репозиторий в Docker-образ с Jupyter на основе конфигурационных файлов репозитория.

Звёзды
1,740
Форки
389
Открытые issues
199
Последний коммит
23 часа назад

Что это?

repo2docker загружает git-репозиторий с GitHub или из локального каталога и собирает из содержащихся в нём конфигурационных файлов образ контейнера. В образе настроена среда Jupyter, в которой можно изучать содержимое репозитория, — так проект легко передать другим уже с установленными зависимостями.

Для запуска достаточно одной команды, например jupyter-repo2docker с URL репозитория. На компьютере должен быть запущен Docker. После сборки инструмент выводит URL с токеном для входа, который открывает Jupyter Notebook с файлами репозитория.

В основе проекта лежит подход Heroku Build Packs: инструкции по сборке среды задаются в самом репозитории. repo2docker служит движком для сервисов в стиле Binder, а BinderHub может запускать его в контейнере при наличии доступа к Docker daemon. Поддерживаются Linux и macOS; установить инструмент можно из PyPI как jupyter-repo2docker.

Ключевые возможности

  • 01Загружает git-репозиторий с GitHub или из локального каталога и собирает из него Docker-образ.
  • 02Читает конфигурационные файлы в репозитории, чтобы определить настройки среды.
  • 03После завершения сборки запускает сервер Jupyter Notebook с содержимым репозитория.
  • 04Можно установить из PyPI или из исходного кода с помощью pip.
  • 05Может работать внутри контейнера при наличии доступа к Docker daemon, как это используется в BinderHub.

Сценарии использования

  • Упаковка исследовательского или учебного репозитория, чтобы другие могли запускать его со всеми заранее установленными зависимостями.
  • Запуск общего репозитория с кодом в воспроизводимой среде Jupyter без ручной настройки.
  • Создание ссылок для запуска проекта в стиле Binder с помощью BinderHub.

Быстрый старт

  1. 1

    Установите Docker (он обязателен и должен быть запущен)

  2. 2

    Установите repo2docker из PyPI

    pip install jupyter-repo2docker
  3. 3

    Соберите и запустите репозиторий

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

Что важно знать

  • Поддерживаются Linux и macOS; официальной поддержки Windows нет.
  • Docker должен быть запущен на вашем компьютере.

Темы

Частые вопросы

Что такое repo2docker?
Собирает git-репозиторий в Docker-образ с Jupyter на основе конфигурационных файлов репозитория. repo2docker загружает git-репозиторий с GitHub или из локального каталога и собирает из содержащихся в нём конфигурационных файлов образ контейнера. В образе настроена среда Jupyter, в которой можно изучать содержимое репозитория, — так проект легко передать другим уже с установленными зависимостями.
repo2docker можно использовать бесплатно? Какая у него лицензия?
repo2docker распространяется с открытым исходным кодом под лицензией BSD-3-Clause. Перед использованием в коммерческих продуктах проверьте условия лицензии.
repo2docker всё ещё поддерживается?
Активно поддерживается. Последний коммит в repo2docker — 6 нояб. 2026 г..
Для чего можно использовать repo2docker?
Упаковка исследовательского или учебного репозитория, чтобы другие могли запускать его со всеми заранее установленными зависимостями. Запуск общего репозитория с кодом в воспроизводимой среде Jupyter без ручной настройки. Создание ссылок для запуска проекта в стиле Binder с помощью BinderHub.
Как установить repo2docker?
Установите Docker (он обязателен и должен быть запущен) Установите repo2docker из PyPI: pip install jupyter-repo2docker Соберите и запустите репозиторий: jupyter-repo2docker https://github.com/norvig/pytudes
Где скачать repo2docker?
Исходный код и инструкции по установке — на GitHub: https://github.com/jupyterhub/repo2docker

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты

Расширение Jupyter Server запускает внешние веб-приложения, например RStudio или Code Server, рядом с сервером ноутбуков и предоставляет к ним доступ через защищённые пути.

405155PythonBSD-3-ClauseАктивно поддерживаетсяОбновлён 5 дней назад