Hugging Face Hub 上的 Jupyter Notebooks

Jupyter notebooks 是用于共享机器学习和数据科学代码和数据分析的非常流行的格式。它们是交互式文档，可以包含代码、可视化和文本。

在 Google Colab 和 Kaggle 中打开模型

当你访问 Hugging Face Hub 上的模型页面时，你会在"使用此模型"下拉菜单中看到一个新的"Google Colab"/"Kaggle"按钮。点击此按钮将生成一个可立即运行的 notebook，其中包含加载和测试模型的基本代码。这对于快速原型设计、推理测试或微调实验非常完美——所有这些都无需离开浏览器。

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

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

对于 kaggle 也是类似的： https://huggingface.co/google/gemma-3-4b-it/kaggle

如果模型仓库包含名为 notebook.ipynb 的文件，我们将使用它作为 Colab 和 Kaggle 的内容，而不是自动生成的 notebook 内容。模型作者可以提供量身定制的示例、详细的演练或高级用例，同时仍然受益于一键式 Colab 集成。NousResearch/Genstruct-7B 就是这样一个例子。

在 Hub 上渲染 .ipynb Jupyter notebooks

实际上，Jupyter Notebook 文件（通常以 .ipynb 扩展名共享）是 JSON 文件。虽然可以直接查看这些文件，但这不是供人类阅读的格式。Hub 对托管在 Hub 上的 notebooks 提供渲染支持。这意味着 notebooks 以人类可读的格式显示。

当 notebooks 包含在 Hub 上的任何类型的仓库中时，它们将被渲染。这包括模型、数据集和 Spaces。

在 Google Colab 中启动

Google Colab 是一个免费的 Jupyter Notebook 环境，无需设置，完全在云中运行。这是在本地机器上无需安装任何内容即可运行 Jupyter Notebooks 的好方法。

托管在 Hub 上的所有 .ipynb 文件都会自动获得一个"在 Colab 中打开"按钮。这允许你一键在 Colab 中打开 notebook。