Hugging Face's logo
加入 Hugging Face 社区

并获得增强的文档体验

开始使用

Hugging Face Hub 上的 Jupyter Notebook

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

在 Google Colab 和 Kaggle 中打开模型

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

Google Colab and Kaggle option for models on the Hub

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

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

对于 Kaggle 类似:https://huggingface.co/google/gemma-3-4b-it/kaggle

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

在 Hub 上渲染 Jupyter Notebook

在底层,Jupyter Notebook 文件(通常以 .ipynb 扩展名共享)是 JSON 文件。虽然可以直接查看这些文件,但它们的格式不适合人类阅读。Hub 支持渲染托管在 Hub 上的 Notebook。这意味着 Notebook 将以人类可读的格式显示。

Before and after notebook rendering

Notebook 将在 Hub 上包含在任何类型的仓库中时进行渲染。这包括模型、数据集和 Spaces。

在 Google Colab 中启动

Google Colab 是一个免费的 Jupyter Notebook 环境,无需设置,完全在云端运行。它是一种无需在本地机器上安装任何东西即可运行 Jupyter Notebook 的好方法。Hub 上托管的 Notebook 会自动获得一个“在 Colab 中打开”按钮。这使您可以通过单击一下在 Colab 中打开 Notebook。

< > 在 GitHub 上更新