기초부터 응용 알고리즘까지 다루며 저장소에 PyTorch 구현을 제공하는 강화 학습 입문서
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
hf CLI 설치하기(macOS 및 Linux)
curl -LsSf https://hf.co/cli/install.sh | bash - 2
Hub에 로그인하기
hf auth login - 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 통계는 매일 갱신됩니다.
관련 프로젝트
처음부터 구현하며 배우는 ML 과정: NumPy 딥러닝 프레임워크와 Pyodide로 채점하는 브라우저 코딩 문제 350개 이상
Unity ML-Agents Toolkit은 강화 학습과 모방 학습으로 AI 에이전트를 훈련하는 환경을 제공합니다.
코드북 조회 트랜스포머로 사진과 동영상의 흐리거나 품질이 낮고 손상된 얼굴을 복원하는 Python 도구
단일 YAML 설정으로 LLM을 미세 조정하고 후속 학습하는 CLI 도구로, 저VRAM 소비자용 GPU에서도 학습할 수 있습니다.
의료 영상 데이터 딥러닝을 위한 PyTorch 기반 오픈소스 프레임워크