# Hugging Face Hub 上的 Jupyter Notebooks

[Jupyter notebooks](https://jupyter.org/) 是机器学习和数据科学领域中用于分享代码和数据分析的非常流行的格式。它们是交互式文档，可以包含代码、可视化和文本。

## 在 Google Colab 和 Kaggle 中打开模型

当您在 Hugging Face Hub 上访问模型页面时，您会在“Use this model”下拉菜单中看到一个新的“Google Colab”/ "Kaggle"按钮。点击该按钮将生成一个可直接运行的 notebook，其中包含用于加载和测试模型的基础代码。这非常适合快速原型开发、推理测试或微调实验——全程无需离开浏览器。

![Google Colab and Kaggle option for models on the Hub](https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/blog/hf-google-colab/gemma3-4b-it-dark.png)

用户还可以通过在模型卡 URL 后添加 /colab 来访问一个可直接运行的 notebook。例如，对于最新的 Gemma 3 4B IT 模型，可以通过获取模型卡 URL：https://huggingface.co/google/gemma-3-4b-it 来访问对应的 Colab notebook

然后在其后添加 `/colab`：https://huggingface.co/google/gemma-3-4b-it/colab

kaggle 的情况类似：https://huggingface.co/google/gemma-3-4b-it/kaggle

如果模型仓库中包含名为 `notebook.ipynb` 的文件，我们将使用它来替代自动生成的笔记本内容，用于 Colab 和 Kaggle。模型作者可以提供定制化的示例、详细的操作指南或高级用例，同时仍能享受一键集成 Colab 的便利。[NousResearch/Genstruct-7B](https://huggingface.co/NousResearch/Genstruct-7B) 就是一个这样的例子。

![](https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/blog/hf-google-colab/genstruct-notebook-dark.png)

## 在 Hub 上渲染 .ipynb Jupyter 笔记本

在底层实现上，Jupyter Notebook 文件（通常使用 `.ipynb` 扩展名共享）是 JSON 文件。虽然可以直接查看这些文件，但该格式并非为人类阅读而设计。Hub 支持对托管在 Hub 上的 Notebook 进行渲染。这意味着 Notebook 会以人类可读的格式显示。

![Before and after notebook rendering](https://huggingface.co/blog/assets/135_notebooks-hub/before_after_notebook_rendering.png)

Notebooks 在 Hub 上的任何类型仓库中都会被渲染，包括模型、数据集和 Spaces。

### 在 Google Colab 中启动

[Google Colab](https://colab.google/) 是一个免费的 Jupyter Notebook 环境，无需任何配置，完全在云端运行。它是运行 Jupyter Notebook 的绝佳方式，无需在本地机器上安装任何内容。

托管在 Hub 上的所有 .ipynb 文件都会自动获得一个“在 Colab 中打开”按钮。这允许您单击一次即可在 Colab 中打开该笔记本。