# Hugging Face Hub의 Jupyter Notebooks

[Jupyter notebooks](https://jupyter.org/)는 기계 학습과 데이터 과학 분야에서 코드와 데이터 분석을 공유하는 데 매우 인기 있는 형식입니다. 코드, 시각화, 텍스트를 포함할 수 있는 인터랙티브 문서입니다.

## Google Colab 및 Kaggle에서 오픈 모델 열기

Hugging Face Hub에서 모델 페이지를 방문하면 “Use this model” 드롭다운에 새로운 “Google Colab”/“Kaggle” 버튼을 확인할 수 있습니다. 이 버튼을 클릭하면 모델을 로드하고 테스트하는 기본 코드가 포함된 바로 실행할 수 있는 노트북이 생성됩니다. 이는 브라우저에서 벗어나지 않고도 빠른 프로토타이핑, 추론 테스트 또는 파인튜닝 실험을 수행하는 데 이상적입니다.

![Google Colab and Kaggle option for models on the Hub](https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/blog/hf-google-colab/gemma3-4b-it-dark.png)

사용자는 모델 카드 URL에 /colab을 추가하여 바로 실행할 수 있는 노트북에 접근할 수도 있습니다. 예를 들어, 최신 Gemma 3 4B IT 모델의 경우, 모델 카드 URL인 https://huggingface.co/google/gemma-3-4b-it에서 해당 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](https://huggingface.co/NousResearch/Genstruct-7B)가 그러한 예시입니다.

![](https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/blog/hf-google-colab/genstruct-notebook-dark.png)

## Hub에서 .ipynb Jupyter 노트북 렌더링

Jupyter Notebook 파일(보통 `.ipynb` 확장자를 가짐)은 내부적으로 JSON 파일입니다. 이러한 파일을 직접 보는 것은 가능하지만, 사람이 읽도록 설계된 형식은 아닙니다. Hub에는 Hub에 호스팅된 Notebook에 대한 렌더링 지원 기능이 있습니다. 즉, Notebook은 사람이 읽기 쉬운 형식으로 표시됩니다.

![Before and after notebook rendering](https://huggingface.co/blog/assets/135_notebooks-hub/before_after_notebook_rendering.png)

Notebooks는 Hub의 모든 유형의 저장소(모델, 데이터셋, Spaces 포함)에 포함되면 렌더링됩니다.

### Google Colab에서 실행

[Google Colab](https://colab.google/)는 설정이 필요 없이 클라우드에서 완전히 실행되는 무료 Jupyter Notebook 환경입니다. 로컬 머신에 아무것도 설치하지 않고 Jupyter Notebook을 실행하는 데 매우 좋은 방법입니다.

Hub에 호스팅된 모든 .ipynb 파일에는 자동으로 "Colab에서 열기" 버튼이 제공됩니다. 이를 통해 클릭 한 번으로 Colab에서 노트북을 열 수 있습니다.