Repolode
huggingface

huggingface/huggingface_hub

Hugging Face Hub의 저장소를 다운로드하고 업로드하며 관리하는 공식 CLI(hf) 및 Python 클라이언트입니다.

스타
3,990
포크
1,285
열린 이슈
185
마지막 커밋
12시간 전

어떤 프로젝트인가요?

huggingface_hub는 머신러닝 모델, 데이터셋, Spaces를 호스팅하는 플랫폼인 Hugging Face Hub의 공식 Python 라이브러리이자 명령줄 도구입니다. Python 코드나 터미널에서 파일 다운로드 및 업로드, 저장소 생성 및 관리, Hub 검색, 배포된 모델의 추론 실행, Hugging Face 인프라에서 작업 실행을 할 수 있습니다.

이 패키지는 두 가지 인터페이스를 제공합니다. 독립 실행형 스크립트나 pip로 설치할 수 있는 셸용 hf CLI와 hf_hub_download, snapshot_download, upload_file, upload_folder 같은 함수가 포함된 Python API입니다. 다운로드한 파일은 로컬 캐시 폴더에 저장되므로 다시 불러올 때 재다운로드하지 않습니다.

CLI는 코딩 에이전트에서 사용할 수 있도록 설계되었으며, Claude Code, Codex, Cursor 같은 에이전트용으로 생성된 명령어 레퍼런스 스킬도 설치할 수 있습니다.

핵심 기능

  • 01개별 파일이나 저장소 전체를 로컬 캐시에 다운로드합니다.
  • 02모델, 데이터셋, Spaces에 파일이나 폴더를 업로드합니다.
  • 03Python이나 터미널에서 Hub 저장소를 생성하고 관리합니다.
  • 04Hub에서 모델, 데이터셋, Spaces를 검색합니다.
  • 05배포된 모델에서 추론을 실행하고 Hugging Face 인프라에서 작업을 시작합니다.
  • 06비대화형 환경을 포함해 Hub 액세스 토큰으로 인증합니다.

활용 사례

  • 학습 또는 추론 파이프라인에 사전 학습된 모델 가중치를 다운로드합니다.
  • 학습 스크립트에서 모델 체크포인트나 데이터셋을 Hub에 게시합니다.
  • 터미널이나 CI 작업에서 로컬 폴더를 Hub 스토리지 버킷과 동기화합니다.
  • 코딩 에이전트가 hf CLI를 통해 Hub 저장소와 상호작용하도록 합니다.

빠른 시작

  1. 1

    hf CLI 설치하기(macOS 및 Linux)

    curl -LsSf https://hf.co/cli/install.sh | bash
  2. 2

    Hub에 로그인하기

    hf auth login
  3. 3

    모델 다운로드하기

    hf download Qwen/Qwen3-0.6B

사용 전 알아둘 점

  • 비공개 리포지토리를 업로드하거나 관리하려면 Hugging Face 계정과 토큰이 필요합니다.

토픽

자주 묻는 질문

huggingface_hub은(는) 무엇인가요?
Hugging Face Hub의 저장소를 다운로드하고 업로드하며 관리하는 공식 CLI(hf) 및 Python 클라이언트입니다. huggingface_hub는 머신러닝 모델, 데이터셋, Spaces를 호스팅하는 플랫폼인 Hugging Face Hub의 공식 Python 라이브러리이자 명령줄 도구입니다. Python 코드나 터미널에서 파일 다운로드 및 업로드, 저장소 생성 및 관리, Hub 검색, 배포된 모델의 추론 실행, Hugging Face 인프라에서 작업 실행을 할 수 있습니다.
huggingface_hub은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
huggingface_hub은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
huggingface_hub은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. huggingface_hub의 마지막 커밋은 2026년 10월 19일입니다.
huggingface_hub은(는) 어디에 사용할 수 있나요?
학습 또는 추론 파이프라인에 사전 학습된 모델 가중치를 다운로드합니다. 학습 스크립트에서 모델 체크포인트나 데이터셋을 Hub에 게시합니다. 터미널이나 CI 작업에서 로컬 폴더를 Hub 스토리지 버킷과 동기화합니다. 코딩 에이전트가 hf CLI를 통해 Hub 저장소와 상호작용하도록 합니다.
huggingface_hub는 어떻게 설치하나요?
hf CLI 설치하기(macOS 및 Linux): curl -LsSf https://hf.co/cli/install.sh | bash Hub에 로그인하기: hf auth login 모델 다운로드하기: hf download Qwen/Qwen3-0.6B
huggingface_hub은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/huggingface/huggingface_hub

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트