Hub documentation
Jupyter Notebooks trên Hugging Face Hub
Jupyter Notebooks trên Hugging Face Hub
Jupyter notebooks là định dạng rất phổ biến để chia sẻ mã và phân tích dữ liệu cho học máy và khoa học dữ liệu. Chúng là các tài liệu tương tác có thể chứa mã, trực quan hóa và văn bản.
Mở các mô hình mở trong Google Colab và Kaggle
Khi bạn truy cập trang mô hình trên Hugging Face Hub, bạn sẽ thấy nút “Google Colab”/ “Kaggle” mới trong menu thả xuống “Use this model”. Nhấp vào nút này sẽ tạo ra một notebook sẵn sàng để chạy, chứa mã cơ bản để tải và kiểm tra mô hình. Điều này rất lý tưởng cho việc nguyên mẫu nhanh, kiểm tra suy luận hoặc các thí nghiệm tinh chỉnh — tất cả đều không cần rời khỏi trình duyệt của bạn.

Người dùng cũng có thể truy cập một notebook sẵn sàng để chạy bằng cách thêm /colab vào URL của model card. Ví dụ, với model Gemma 3 4B IT mới nhất, notebook Colab tương ứng có thể được truy cập bằng cách lấy URL của model card: https://huggingface.co/google/gemma-3-4b-it
Và sau đó thêm /colab vào cuối: https://huggingface.co/google/gemma-3-4b-it/colab
và tương tự cho kaggle: https://huggingface.co/google/gemma-3-4b-it/kaggle
Nếu kho mô hình có chứa tệp notebook.ipynb, chúng tôi sẽ sử dụng tệp này cho Colab và Kaggle thay vì nội dung notebook được tạo tự động. Các tác giả mô hình có thể cung cấp các ví dụ được tùy chỉnh, các hướng dẫn chi tiết hoặc các trường hợp sử dụng nâng cao, đồng thời vẫn tận dụng được tính năng tích hợp Colab chỉ với một cú nhấp chuột. NousResearch/Genstruct-7B là một ví dụ như vậy.

Hiển thị các notebook Jupyter .ipynb trên Hub
Bên trong, các tệp Jupyter Notebook (thường được chia sẻ với phần mở rộng .ipynb) là các tệp JSON. Mặc dù có thể xem trực tiếp các tệp này, nhưng đây không phải là định dạng được thiết kế để con người đọc. Hub hỗ trợ hiển thị các notebook được lưu trữ trên Hub. Điều này có nghĩa là các notebook sẽ được hiển thị ở định dạng dễ đọc cho con người.

Notebooks sẽ được hiển thị khi được bao gồm trong bất kỳ loại kho lưu trữ nào trên Hub. Điều này bao gồm các model, datasets và Spaces.
Chạy trong Google Colab
Google Colab là môi trường Jupyter Notebook miễn phí, không yêu cầu cài đặt và chạy hoàn toàn trên đám mây. Đây là cách tuyệt vời để chạy Jupyter Notebook mà không cần cài đặt bất kỳ thứ gì trên máy cục bộ của bạn.
Tất cả các tệp .ipynb được lưu trữ trên Hub đều tự động có nút “Open in Colab”. Điều này cho phép bạn mở notebook trong Colab chỉ với một cú nhấp chuột.
Update on GitHub