Hub documentation
Hugging Face Hub의 Jupyter Notebooks
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 모델의 경우, 모델 카드 URL https://huggingface.co/google/gemma-3-4b-it에 /colab을 추가하여 해당 Colab 노트북에 도달할 수 있습니다.
그리고 /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에 호스팅된 Notebook에 대한 렌더링 지원 기능이 있습니다. 즉, Notebook은 사람이 읽기 쉬운 형식으로 표시됩니다.

Notebooks는 Hub의 모든 유형의 저장소(모델, 데이터셋, Spaces 포함)에 포함되면 렌더링됩니다.
Google Colab에서 실행
Google Colab는 설정이 필요 없이 클라우드에서 완전히 실행되는 무료 Jupyter Notebook 환경입니다. 로컬 머신에 아무것도 설치하지 않고 Jupyter Notebook을 실행하는 데 매우 좋은 방법입니다.
Hub에 호스팅된 모든 .ipynb 파일에는 자동으로 “Colab에서 열기” 버튼이 제공됩니다. 이를 통해 클릭 한 번으로 Colab에서 노트북을 열 수 있습니다.
Update on GitHub