Jupyter Notebooks на Hugging Face Hub

Jupyter notebooks — это очень популярный формат для обмена кодом и результатами анализа данных в области машинного обучения и data science. Это интерактивные документы, которые могут содержать код, визуализации и текст.

Открытие моделей в Google Colab и Kaggle

Когда вы открываете страницу модели на Hugging Face Hub, в выпадающем списке «Use this model» вы увидите новую кнопку «Google Colab»/«Kaggle». Нажатие на неё генерирует готовый к запуску ноутбук с базовым кодом для загрузки и проверки модели. Это идеально подходит для быстрого прототипирования, тестирования инференса или экспериментов с дообучением — всё это можно сделать, не покидая браузер.

Пользователи также могут получить доступ к готовому для запуска ноутбуку, добавив /colab к URL-адресу карточки модели. Например, для последней модели 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 — один из таких примеров.

Отображение Jupyter-ноутбуков .ipynb на Hub

Под капотом файлы Jupyter Notebook (обычно распространяются с расширением .ipynb) представляют собой файлы JSON. Хотя их можно просматривать напрямую, этот формат не предназначен для чтения человеком. Hub поддерживает отображение ноутбуков, размещённых на Hub. Это означает, что ноутбуки отображаются в удобном для чтения формате.

Notebooks будут отображаться при включении в любой тип репозитория на Hub. Сюда входят модели, наборы данных и Spaces.

Запуск в Google Colab

Google Colab — это бесплатная среда Jupyter Notebook, не требующая настройки и работающая полностью в облаке. Это отличный способ запускать Jupyter Notebooks без необходимости устанавливать что-либо на локальную машину.

Все файлы .ipynb, размещённые на Hub, автоматически получают кнопку «Open in Colab». Это позволяет открыть ноутбук в Colab одним щелчком мыши.

Update on GitHub