허깅페이스 Hub의 Jupyter Notebooks
허깅페이스 Hub의 Jupyter Notebooks
Jupyter notebook은 머신러닝과 데이터 과학에서 코드와 데이터 분석을 공유하는 데 매우 인기 있는 형식이에요. 코드, 시각화, 텍스트를 담을 수 있는 인터랙티브 문서랍니다. Hub의 모델 페이지에서는 Google Colab이나 Kaggle로 바로 열 수 있는 버튼도 제공해요.
출처: 문서
본문
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을 붙이면:
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 notebooks 렌더링하기
내부적으로 Jupyter Notebook 파일(보통 .ipynb 확장자로 공유)은 JSON 파일이에요. 직접 보는 것도 가능하지만 사람이 읽도록 만들어진 형식은 아니에요. Hub는 Hub에서 호스팅된 노트북에 대한 렌더링 지원이 있어요. 즉 노트북이 사람이 읽을 수 있는 형식으로 표시된답니다.
노트북은 Hub의 어떤 유형의 저장소에든 포함되면 렌더링돼요. 모델, 데이터셋, Spaces가 모두 해당돼요.
Google Colab에서 실행
Google Colab은 설정이 필요 없고 완전히 클라우드에서 실행되는 무료 Jupyter Notebook 환경이에요. 로컬 머신에 아무것도 설치하지 않고 Jupyter 노트북을 실행하는 좋은 방법이랍니다.
Hub에서 호스팅된 모든 .ipynb 파일에는 자동으로 "Open in Colab" 버튼이 부여돼요. 한 번의 클릭으로 Colab에서 노트북을 열 수 있어요.
더 알아보기 (Learn more)
- 모델 페이지의 "Use this model"에서 Colab/Kaggle 노트북을 바로 열 수 있어요.
- 모델 저장소에
notebook.ipynb를 넣으면 자동 생성 대신 그 노트북을 사용해요.