Hub documentation

Jupyter Notebooks no Hugging Face Hub

Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

Jupyter Notebooks no Hugging Face Hub

notebooks do Jupyter são um formato muito popular para compartilhar código e análises de dados em aprendizado de máquina e ciência de dados. São documentos interativos que podem conter código, visualizações e texto.

Abra modelos no Google Colab e no Kaggle

Ao visitar uma página de modelo no Hugging Face Hub, você verá um novo botão “Google Colab”/ “Kaggle” no menu suspenso “Use this model”. Ao clicar nele, será gerado um notebook pronto para execução, com código básico para carregar e testar o modelo. Isso é perfeito para prototipagem rápida, testes de inferência ou experimentos de fine-tuning — tudo sem sair do navegador.

Google Colab and Kaggle option for models on the Hub

Os usuários também podem acessar um notebook pronto para execução adicionando /colab à URL do cartão do modelo. Como exemplo, para o modelo Gemma 3 4B IT mais recente, o notebook Colab correspondente pode ser acessado a partir da URL do cartão do modelo: https://huggingface.co/google/gemma-3-4b-it

E, em seguida, adicionando /colab a ele: https://huggingface.co/google/gemma-3-4b-it/colab

e da mesma forma para o kaggle: https://huggingface.co/google/gemma-3-4b-it/kaggle

Se um repositório de modelos incluir um arquivo chamado notebook.ipynb, ele será usado no Colab e no Kaggle em vez do conteúdo do notebook gerado automaticamente. Os autores dos modelos podem fornecer exemplos personalizados, explicações detalhadas ou casos de uso avançados, ainda aproveitando a integração com um clique no Colab. NousResearch/Genstruct-7B é um exemplo disso.

Renderização de notebooks Jupyter .ipynb no Hub

Por baixo dos panos, os arquivos do Jupyter Notebook (geralmente compartilhados com a extensão .ipynb) são arquivos JSON. Embora seja possível visualizar esses arquivos diretamente, esse não é um formato destinado a ser lido por humanos. O Hub oferece suporte à renderização de notebooks hospedados no Hub. Isso significa que os notebooks são exibidos em um formato legível por humanos.

Before and after notebook rendering

Notebooks serão renderizados quando incluídos em qualquer tipo de repositório no Hub. Isso inclui modelos, conjuntos de dados e Spaces.

Iniciar no Google Colab

Google Colab é um ambiente gratuito de Jupyter Notebook que não requer configuração e roda inteiramente na nuvem. É uma ótima maneira de executar Jupyter Notebooks sem precisar instalar nada na sua máquina local.

Todos os arquivos .ipynb hospedados no Hub recebem automaticamente um botão “Open in Colab”. Isso permite abrir o notebook no Colab com um único clique.

Update on GitHub