Repolode
Enviar
jupyterhub

jupyterhub/repo2docker

Cria uma imagem Docker com Jupyter a partir de um repositório Git, usando os arquivos de configuração encontrados nele.

Ver no GitHubSite
Estrelas
1,740
Forks
389
Issues abertas
199
Último commit
há 12 horas

O que é?

repo2docker busca um repositório Git, do GitHub ou de um caminho local, e cria uma imagem de contêiner com base nos arquivos de configuração que ele contém. A imagem é preparada para que o conteúdo do repositório possa ser explorado em um ambiente Jupyter, facilitando o compartilhamento de um projeto com as dependências já instaladas.

A execução exige apenas um comando, como jupyter-repo2docker seguido da URL de um repositório. O Docker precisa estar em execução na máquina. Quando a criação da imagem termina, a ferramenta exibe uma URL com um token de login que abre o Jupyter Notebook com os arquivos do repositório.

O design é inspirado nos Build Packs do Heroku: o próprio repositório declara como o ambiente deve ser criado. repo2docker é o mecanismo por trás de serviços no estilo Binder, e o BinderHub pode executá-lo dentro de um contêiner quando tem acesso ao Docker daemon. Compatível com Linux e macOS, pode ser instalado pelo PyPI como jupyter-repo2docker.

Recursos principais

  • 01Busca um repositório Git do GitHub ou de um caminho local e o transforma em uma imagem Docker.
  • 02Lê os arquivos de configuração do repositório para definir a configuração do ambiente.
  • 03Após a criação da imagem, inicia um servidor Jupyter Notebook com o conteúdo do repositório.
  • 04Pode ser instalado pelo PyPI ou a partir do código-fonte com pip.
  • 05Pode ser executado dentro de um contêiner quando há acesso ao Docker daemon, como no BinderHub.

Casos de uso

  • Empacotar um repositório de pesquisa ou ensino para que outras pessoas possam executá-lo com todas as dependências já instaladas.
  • Executar um repositório de código compartilhado em um ambiente Jupyter reproduzível, sem configuração manual.
  • Disponibilizar links de inicialização no estilo Binder para um projeto por meio do BinderHub.

Início rápido

  1. 1

    Instale o Docker (obrigatório e deve estar em execução)

  2. 2

    Instale o repo2docker pelo PyPI

    pip install jupyter-repo2docker
  3. 3

    Compile e execute um repositório

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

Antes de usar

  • Compatível com Linux e macOS; o Windows não tem suporte oficial.
  • O Docker precisa estar em execução na sua máquina.

Tópicos

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

Perguntas frequentes

O que é repo2docker?
Cria uma imagem Docker com Jupyter a partir de um repositório Git, usando os arquivos de configuração encontrados nele. repo2docker busca um repositório Git, do GitHub ou de um caminho local, e cria uma imagem de contêiner com base nos arquivos de configuração que ele contém. A imagem é preparada para que o conteúdo do repositório possa ser explorado em um ambiente Jupyter, facilitando o compartilhamento de um projeto com as dependências já instaladas.
repo2docker é gratuito? Qual é a licença?
repo2docker é open source sob a licença BSD-3-Clause. Confira os termos da licença antes de usá-lo em produtos comerciais.
repo2docker ainda é mantido?
Manutenção ativa. O último commit de repo2docker foi em 6 de nov. de 2026.
Para que posso usar repo2docker?
Empacotar um repositório de pesquisa ou ensino para que outras pessoas possam executá-lo com todas as dependências já instaladas. Executar um repositório de código compartilhado em um ambiente Jupyter reproduzível, sem configuração manual. Disponibilizar links de inicialização no estilo Binder para um projeto por meio do BinderHub.
Como instalar repo2docker?
Instale o Docker (obrigatório e deve estar em execução) Instale o repo2docker pelo PyPI: pip install jupyter-repo2docker Compile e execute um repositório: jupyter-repo2docker https://github.com/norvig/pytudes
Onde consigo repo2docker?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/jupyterhub/repo2docker

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados