huggingface_hub 패키지 개요 — 인증·CLI·HfFileSystem
huggingface_hub 패키지 개요
huggingface_hub는 저장소 CRUD를 넘어서 허브를 개발 파이프라인에 통합하는 다양한 도구를 갖춘 SDK예요.
주요 구성
- 인증(Authentication):
HfApi인스턴스에 토큰을 넘기거나,huggingface-cli login으로 자격 증명을 저장해 써요. - CLI:
hf명령으로 저장소·파일·인증을 터미널에서 다뤄요 (hf repos ls,hf download등). - HfFileSystem: 허브를 파일시스템처럼(
hf://user/repo/path) 접근하게 해 줘서, 로컬 파일처럼 스트리밍하거나 copy할 수 있어요. - Inference / Inference Endpoints: API를 호출하거나 엔드포인트를 관리하는 클라이언트.
- Jobs / Webhooks / Collections / Search: 대규모 허브 운영 기능들.
언제 뭘 쓰면 좋을까요
- 학습·추론 코드에서 모델을 불러온다 →
snapshot_download/hf_hub_download - 모델을 배포한다 →
HfApi.upload_folder또는hf upload - 파이프라인 단계를 자동화한다 → CLI + 환경변수(예:
HF_TOKEN)
버전별로 API가 바뀔 수 있으니, 상세 시그니처는 각 레퍼런스 페이지를 확인해 주세요. 이 문서는 v1.x 기준으로 작성됐어요.