Jupyter Notebooks on the Hugging Face Hub

Jupyter notebooks are a very popular format for sharing code and data analysis for machine learning and data science. They are interactive documents that can contain code, visualizations, and text.

Open models in Google Colab and Kaggle

When you visit a model page on the Hugging Face Hub, you’ll see a new “Google Colab”/ “Kaggle” button in the “Use this model” drop down. Clicking this will generate a ready-to-run notebook with basic code to load and test the model. This is perfect for quick prototyping, inference testing, or fine-tuning experiments — all without leaving your browser.

Users can also access a ready-to-run notebook by appending /colab to the model card’s URL. As an example, for the latest Gemma 3 4B IT model, the corresponding Colab notebook can be reached by taking the model card URL: https://huggingface.co/google/gemma-3-4b-it

And then appending /colab to it: https://huggingface.co/google/gemma-3-4b-it/colab

and similarly for kaggle: https://huggingface.co/google/gemma-3-4b-it/kaggle

If a model repository includes a file called notebook.ipynb, we will use it for Colab and Kaggle instead of the auto-generated notebook content. Model authors can provide tailored examples, detailed walkthroughs, or advanced use cases while still benefiting from one-click Colab integration. NousResearch/Genstruct-7B is one such example.

Rendering Jupyter notebooks on the Hub

Under the hood, Jupyter Notebook files (usually shared with a .ipynb extension) are JSON files. While viewing these files directly is possible, it’s not a format intended to be read by humans. The Hub has rendering support for notebooks hosted on the Hub. This means that notebooks are displayed in a human-readable format.

Notebooks will be rendered when included in any type of repository on the Hub. This includes models, datasets, and Spaces.

Launch in Google Colab

Google Colab is a free Jupyter Notebook environment that requires no setup and runs entirely in the cloud. It’s a great way to run Jupyter Notebooks without having to install anything on your local machine. Notebooks hosted on the Hub are automatically given a “Open in Colab” button. This allows you to open the notebook in Colab with a single click.

< > Update on GitHub