Hub documentation

Carnets Jupyter sur le Hugging Face Hub

Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

Carnets Jupyter sur le Hugging Face Hub

Les notebooks Jupyter sont un format très populaire pour partager du code et des analyses de données en apprentissage automatique et en science des données. Ce sont des documents interactifs qui peuvent contenir du code, des visualisations et du texte.

Ouvrir des modèles ouverts dans Google Colab et Kaggle

Lorsque vous consultez une page de modèle sur le Hugging Face Hub, vous verrez un nouveau bouton « Google Colab » / « Kaggle » dans le menu déroulant « Utiliser ce modèle ». En cliquant dessus, un notebook prêt à l’emploi est généré, contenant du code de base pour charger et tester le modèle. C’est idéal pour le prototypage rapide, les tests d’inférence ou les expériences de fine-tuning — le tout sans quitter votre navigateur.

Google Colab and Kaggle option for models on the Hub

Les utilisateurs peuvent également accéder à un notebook prêt à l’emploi en ajoutant /colab à l’URL de la carte du modèle. À titre d’exemple, pour le modèle Gemma 3 4B IT le plus récent, le notebook Colab correspondant est accessible en prenant l’URL de la carte du modèle : https://huggingface.co/google/gemma-3-4b-it

Puis en ajoutant /colab à l’adresse : https://huggingface.co/google/gemma-3-4b-it/colab

et de même pour kaggle : https://huggingface.co/google/gemma-3-4b-it/kaggle

Si un dépôt de modèle contient un fichier nommé notebook.ipynb, celui-ci sera utilisé pour Colab et Kaggle à la place du contenu du notebook généré automatiquement. Les auteurs de modèles peuvent ainsi fournir des exemples adaptés, des explications détaillées ou des cas d’usage avancés tout en bénéficiant de l’intégration Colab en un clic. NousResearch/Genstruct-7B en est un exemple.

Affichage des notebooks Jupyter .ipynb sur le Hub

Sous le capot, les fichiers Jupyter Notebook (partagés généralement avec l’extension .ipynb) sont des fichiers JSON. Bien qu’il soit possible de consulter ces fichiers directement, ce n’est pas un format conçu pour être lu par des humains. Le Hub prend en charge l’affichage des notebooks hébergés sur le Hub. Cela signifie que les notebooks sont présentés dans un format lisible par l’homme.

Before and after notebook rendering

Les notebooks sont rendus lorsqu'ils sont inclus dans tout type de dépôt sur le Hub. Cela inclut les modèles, les jeux de données et les Spaces.

Lancer dans Google Colab

Google Colab est un environnement Jupyter Notebook gratuit qui ne nécessite aucune configuration et qui s’exécute entièrement dans le cloud. C’est une excellente façon d’exécuter des Jupyter Notebooks sans avoir à installer quoi que ce soit sur votre machine locale.

Tous les fichiers .ipynb hébergés sur le Hub reçoivent automatiquement un bouton « Open in Colab ». Cela vous permet d’ouvrir le notebook dans Colab en un seul clic.

Update on GitHub