Colab 노트북에서 Hugging Face 인증 토큰 설정 방법[pe]

Colab 노트북에서 Hugging Face 인증 토큰 설정 방법[pe]

 Colab에서 Hugging Face 인증 토큰(HF_TOKEN)을 설정하는 방법은 크게 두 가지 흐름으로 정리할 수 있다.

(1) Colab의 “Secrets(비밀값)” 기능에 저장하는 방법, (2) 노트북 안에서 직접 입력하는 방법이다.[pyimagesearch]​


1단계: Hugging Face 토큰 만들기

  1. 브라우저에서 Hugging Face 로그인

  2. “Create new token” 버튼 클릭 후 토큰 이름 지정(예: HF_TOKEN).[pyimagesearch]​

  3. 권한은 일반적으로 “Read” 또는 “Read/Write” 중 필요한 수준으로 선택.[pyimagesearch]​

  4. 생성된 토큰 값을 복사해 안전한 곳에 저장해 둔다.

    • 이 창을 닫으면 토큰 값을 다시 볼 수 없으므로 꼭 복사해야 한다.[pyimagesearch]​


2단계: Colab Secrets에 HF_TOKEN 저장하기 (추천 방식)

  1. 새 Colab 노트북 열기.

  2. 왼쪽 사이드바에서 “열쇠 아이콘(🔑, Secrets)” 클릭.[blog.winerva]​

  3. “+ Add new secret” 선택 후

    • Name(이름)에 HF_TOKEN 입력.[blog.winerva]​

    • Value(값)에 아까 복사한 Hugging Face 토큰 붙여넣기.

    • Notebook access(노트북에서 접근 허용) 토글을 켠 뒤 저장.[pyimagesearch]​

이렇게 하면 이후 같은 계정의 다른 Colab 노트북에서도 HF_TOKEN을 재사용할 수 있다.[blog.winerva]​


3단계: 노트북 코드에서 토큰 불러와 로그인하기

Colab 셀에 아래 코드를 입력해 실행한다.[dev]​

python
!pip install -q huggingface_hub from huggingface_hub import login from google.colab import userdata hf_token = userdata.get('HF_TOKEN') # Secrets에 저장한 값 불러오기 login(hf_token) print("Logged in to Hugging Face!")
  • userdata.get('HF_TOKEN')가 방금 저장한 시크릿을 가져온다.[dev]​

  • login(hf_token)이 실제 로그인 동작을 수행해 이후 transformers, diffusers 등에서 자동으로 인증을 사용한다.[dev]​


4단계: 간단 검증

아래와 같이 공개 모델 하나를 불러와서 에러 없이 동작하는지 테스트할 수 있다.

python
from huggingface_hub import whoami print(whoami()) # 계정 정보 출력되면 정상 로그인[web:31]

5단계: 대안 – 노트북에서 바로 입력(세션 한 번용)

시크릿 설정이 귀찮다면, 노트북에서 직접 토큰을 입력하는 방식도 있다.[learnhuggingface]​

python
!pip install -q huggingface_hub from huggingface_hub import notebook_login notebook_login() # 실행 후 나오는 입력창에 토큰 직접 붙여넣기[web:34]
  • 이 방식은 현재 세션이 종료되면 다시 입력해야 하지만, 테스트용으로는 간단하다.[d2wozrt205r2fu.cloudfront]​


요약하면,

  1. Hugging Face에서 토큰을 만들고,[pyimagesearch]​

  2. Colab의 Secrets에 이름 HF_TOKEN으로 저장한 뒤,[blog.winerva]​

  3. 노트북에서 userdata.get('HF_TOKEN') + login(hf_token)을 호출하면 깔끔하게 인증이 끝난다.[dev]​




관련된
MedGemma 설치를 위한 최소 시스템 요구사항은 무엇인가요
유튜브에서 초보자용 MedGemma 설치 영상 추천해 주세요
Colab에서 MedGemma 4B 실행하는 단계별 명령어는 무엇인가요
로컬 GPU 설정과 드라이버 설치 방법 가이드는 무엇인가요
MedGemma에 필요한 파이썬 패키지와 버전 목록을 알려주세요

관련된
Colab에서 MedGemma 4B 설치 방법 단계별 안내 영상
MedGemma 기본 사용법과 예제 시연 유튜브 강좌
로컬 GPU로 MedGemma 27B 실행하는 튜토리얼 영상
MedGemma Colab 데모에서 필요한 Hugging Face 설정 방법
의료 영상 예제로 MedGemma 테스트하는 초보자용 강의

관련된
Colab에서 MedGemma 4B 실행에 필요한 GPU와 요금은 어떻게 되나
Colab 무료 환경으로 MedGemma 4B 4B-pt를 돌릴 수 있는지
Colab 노트북에서 Hugging Face 인증 토큰 설정 방법
MedGemma 4B를 Colab에서 양자화된(4bit)로 설치하는 단계별 명령어
Colab에서 MedGemma 4B로 흉부 X레이 테스트하는 방법 영상 찾기 기준란 무엇인가

관련된
Colab에서 HF_TOKEN을 안전하게 저장하는 방법
Hugging Face 토큰 권한(Read vs Write) 차이
Colab Secrets 대신 환경변수로 토큰 설정하는 법
토큰 없이 공개 모델만 사용하는 방법과 한계
huggingface_hub.login()를 노트북에서 자동화하는 방법

댓글

이 블로그의 인기 게시물

히브리인, 이스라엘인, 유대인 성경 속 이름에 숨겨진 소름 돋는 비밀

작은 틈이 무너뜨린다 왜 우리는 ‘사소한 분열’을 극도로 경계해야 하는가

작은 틈이 무너뜨린다 왜 성경은 ‘분열의 시작’을 그렇게 경고하는가