huggingface_hub.login()를 노트북에서 자동화하는 방법[pe]
huggingface_hub.login()를 노트북에서 자동화하는 방법[pe]
Colab에서 huggingface_hub.login()을 매번 손으로 치지 않고 자동화하려면,
“토큰은 안전하게 숨겨 두고, 노트북 첫 셀에서 자동으로 불러와 로그인”하는 패턴을 쓰면 된다.[dev]
아래는 가장 실용적인 방법 2가지다.
1. Colab Secrets + 자동 로그인 코드 (가장 추천)
1단계: HF_TOKEN을 시크릿으로 저장
Hugging Face 토큰 생성 페이지 이동
https://huggingface.co/settings/tokens 에서 토큰 생성.[huggingface]
Colab 왼쪽 사이드바 → 열쇠 아이콘(Secrets) 클릭.[dev]
“+ Add new secret”
Name:
HF_TOKENValue: 방금 복사한 토큰 값 붙여넣기 → 저장.[dev]
이제 이 계정의 모든 노트북에서 HF_TOKEN을 불러 쓸 수 있다.[dev]
2단계: 노트북 첫 셀에 자동 로그인 코드 넣기
python!pip install -q huggingface_hub from huggingface_hub import login from google.colab import userdata HF_TOKEN = userdata.get("HF_TOKEN") if HF_TOKEN: login(token=HF_TOKEN, add_to_git_credential=False) print("✅ Hugging Face 자동 로그인 완료") else: print("❌ HF_TOKEN 시크릿이 없습니다. Colab Secrets에 먼저 저장하세요.")
userdata.get("HF_TOKEN")가 시크릿에서 토큰을 읽어 온다.[dev]login(token=HF_TOKEN, ...)방식은 토큰을 코드에 직접 적지 않고,
환경에서 불러와 한 번에 로그인해 준다.[huggingface]
이 셀만 맨 위에서 한 번 실행하면, 뒤에 나오는 from transformers import AutoModel 같은 코드들은 알아서 인증을 사용한다.[huggingface]
2. 환경변수(HF_TOKEN) 기반 완전 자동화
Colab 대신 로컬 노트북이나, “토큰 파일을 이미 저장해 둔 환경”에서는
코드 안에 토큰 변수도 안 쓰고 로그인만 호출할 수도 있다.[github]
1단계: 환경변수 HF_TOKEN 설정 (예: 로컬, 혹은 Colab의 os.environ)
pythonimport os os.environ["HF_TOKEN"] = "hf_로_시작하는_토큰값" # Colab에선 이 방식은 공유 노트북에 쓰지 않는 게 안전
혹은 셸에서
bashexport HF_TOKEN=hf_xxx...
2단계: login()을 토큰 없이 호출
pythonfrom huggingface_hub import login import os token = os.getenv("HF_TOKEN", None) if token: login(token=token) else: login() # 환경에 저장된 기본 토큰이나 캐시 파일을 사용하려 시도[web:37][web:41]
huggingface_hub는 환경변수, 캐시 파일(~/.cache/huggingface/token) 등에서 토큰을 찾아 자동으로 사용한다.[github]Colab 노트북을 다른 사람과 공유할 경우, 토큰을
os.environ[...]에 직접 하드코딩하는 방식은 유출 위험 때문에 피하는 것이 좋다.[huggingface]
3. 최소 코드 예시 (한 줄 자동 로그인 패턴)
Colab에서 HF_TOKEN 시크릿만 잘 설정해 두었다면, 다음처럼 한 줄로도 쓸 수 있다.[dev]
pythonfrom huggingface_hub import login from google.colab import userdata login(token=userdata.get("HF_TOKEN"))
이렇게 해두고, 템플릿 노트북의 첫 셀에 항상 이 코드를 복사해 쓰면
“열자마자 자동 로그인 → 아래 셀에서 바로 모델 다운로드” 흐름이 된다.
정리하면,
Hugging Face 공식 문서는
login(token=...)로 토큰을 직접 인자로 넘기는 방식은, 반드시 안전한 저장소에서 불러와 사용할 것을 권장하고,[huggingface]Colab에서는 그 “안전한 저장소” 역할을 Secrets +
google.colab.userdata가 해준다.[dev]
따라서 “Colab Secrets + 첫 셀 자동 로그인 코드” 조합이 가장 깔끔하고 재사용성이 높다.
관련된
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()를 노트북에서 자동화하는 방법
관련된
Colab에서 HF_TOKEN을 안전하게 저장하는 방법
Hugging Face 토큰 권한(Read vs Write) 차이
Colab Secrets 대신 환경변수로 토큰 설정하는 법
토큰 없이 공개 모델만 사용하는 방법과 한계
huggingface_hub.login()를 노트북에서 자동화하는 방법
댓글
댓글 쓰기