Colab 노트북에서 Hugging Face 인증 토큰 설정 방법[pe]
Colab 노트북에서 Hugging Face 인증 토큰 설정 방법[pe]
Colab에서 Hugging Face 인증 토큰(HF_TOKEN)을 설정하는 방법은 크게 두 가지 흐름으로 정리할 수 있다.
(1) Colab의 “Secrets(비밀값)” 기능에 저장하는 방법, (2) 노트북 안에서 직접 입력하는 방법이다.[pyimagesearch]
1단계: Hugging Face 토큰 만들기
브라우저에서 Hugging Face 로그인
“Create new token” 버튼 클릭 후 토큰 이름 지정(예:
HF_TOKEN).[pyimagesearch]권한은 일반적으로 “Read” 또는 “Read/Write” 중 필요한 수준으로 선택.[pyimagesearch]
생성된 토큰 값을 복사해 안전한 곳에 저장해 둔다.
이 창을 닫으면 토큰 값을 다시 볼 수 없으므로 꼭 복사해야 한다.[pyimagesearch]
2단계: Colab Secrets에 HF_TOKEN 저장하기 (추천 방식)
새 Colab 노트북 열기.
왼쪽 사이드바에서 “열쇠 아이콘(🔑, Secrets)” 클릭.[blog.winerva]
“+ 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단계: 간단 검증
아래와 같이 공개 모델 하나를 불러와서 에러 없이 동작하는지 테스트할 수 있다.
pythonfrom 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]
요약하면,
Hugging Face에서 토큰을 만들고,[pyimagesearch]
Colab의 Secrets에 이름
HF_TOKEN으로 저장한 뒤,[blog.winerva]노트북에서
userdata.get('HF_TOKEN')+login(hf_token)을 호출하면 깔끔하게 인증이 끝난다.[dev]
댓글
댓글 쓰기