Hugging Face Hub 上の Jupyter Notebooks

Jupyter notebooksは、機械学習やデータサイエンスにおけるコードやデータ分析の共有に非常に人気のある形式です。コード、可視化、テキストを含むインタラクティブなドキュメントです。

Google ColabとKaggleでオープンモデルを開く

Hugging Face Hub のモデルページにアクセスすると、“Use this model” のドロップダウンメニューに新しい “Google Colab” / “Kaggle” ボタンが表示されます。このボタンをクリックすると、モデルの読み込みとテストを行うための基本的なコードを含む、すぐに実行できるノートブックが生成されます。これは、ブラウザを離れることなく、クイックなプロトタイピング、推論のテスト、ファインチューニングの実験を行うのに最適です。

ユーザーは、モデルカードのURLに/colabを付加することで、すぐに実行できるノートブックにアクセスすることもできます。例えば、最新のGemma 3 4B ITモデルの場合、対応するColabノートブックは、モデルカードのURL 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でこのファイルを使用します。モデルの作成者は、ワンクリックでColabに統合できる利点を保ちながら、カスタマイズされた例、詳細な手順、または高度なユースケースを提供できます。NousResearch/Genstruct-7Bはその一例です。

Hub での .ipynb Jupyter ノートブックのレンダリング

Jupyter Notebook ファイル（通常は.ipynb拡張子で共有されます）は、内部では JSON ファイルです。これらのファイルを直接表示することは可能ですが、人間が読むことを意図した形式ではありません。Hub には、Hub にホストされているノートブックのレンダリング機能が備わっています。これにより、ノートブックは人間が読みやすい形式で表示されます。

Notebooksは、Hub上のあらゆるタイプのリポジトリ（モデル、データセット、Spacesを含む）に含められた場合に表示されます。

Google Colabで起動

Google Colabは、セットアップが不要で完全にクラウド上で動作する無料のJupyter Notebook環境です。ローカルマシンに何もインストールせずにJupyter Notebookを実行できる、優れた方法です。

Hub にホストされているすべての .ipynb ファイルには、「Open in Colab」ボタンが自動的に付与されます。これにより、1クリックで Colab でノートブックを開くことができます。

Update on GitHub