Hugging Face CLI 업데이트: hf 명령어로 전환

Hugging Face는 공식적으로 huggingface-cli를 hf로 이름을 변경했으며, 보다 인체공학적이고 탐색하기 쉬운 재구성된 명령 구조를 도입했습니다. 이번 업데이트는 사용자가 Hub와 상호작용하는 방식을 간소화함과 동시에, Hugging Face 인프라에서 스크립트와 Docker 이미지를 실행할 수 있는 새로운 서비스 hf jobs를 소개합니다.

새로운 명령 구조 및 구문

hf CLI는 예측 가능한 hf <resource> <action> 문법을 채택했습니다. 이 재구성은 이전의 일관성 부족한 명령 구조에서 벗어나, 명령이 관리하는 리소스별로 그룹화되는 보다 직관적인 형식으로 전환됩니다.

핵심 명령 그룹

대부분의 기능이 이제 특정 리소스 헤딩 아래에 조직되었습니다. 주요 명령 그룹은 다음과 같습니다:

  • hf auth: 인증을 관리하며, 로그인, 로그아웃 및 액세스 토큰 전환을 포함합니다.
  • hf cache: 로컬 캐시 디렉터리를 처리합니다.
  • hf repo: Hub의 저장소를 관리합니다.
  • hf repo-files: 저장소 내 파일을 관리합니다.
  • hf upload 및 hf download: 사용 빈도가 높아 루트 레벨에 그대로 유지됩니다.

설치 및 검증

새 CLI를 사용하려면 사용자는 huggingface_hub 라이브러리를 설치하거나 업데이트해야 합니다:

pip install -U huggingface_hub

설치가 성공했는지는 hf version을 실행하여 확인할 수 있으며, 이는 huggingface_hub 버전(예: 0.34.0)을 반환합니다.

huggingface-cli에서 마이그레이션

레거시 huggingface-cli는 원활한 전환을 위해 여전히 작동하지만 이제는 사용 중단되었습니다. 레거시 명령을 사용하면 새로운 hf 명령으로 안내하는 경고가 표시됩니다.

인증 변경 사항

마이그레이션 중 가장 중요한 변화는 인증 명령에 영향을 미칩니다. 매핑 예시는 다음과 같습니다:

  • huggingface-cli login → hf auth login
  • huggingface-cli whoami → hf auth whoami
  • huggingface-cli logout → hf auth logout

hf jobs 소개

hf jobs는 사용자가 사용량 기반 과금 모델로 Hugging Face 인프라에서 스크립트나 Docker 이미지를 실행할 수 있게 하는 새로운 서비스입니다. 이 서비스는 Pro 사용자와 팀 또는 엔터프라이즈 조직에만 독점적으로 제공됩니다.

기능 및 명령 세트

hf jobs 명령 세트는 Docker CLI에서 영감을 받았으며, 특정 하드웨어 종류(예: A10G GPU)에서 작업을 실행할 수 있게 합니다.

Example Command:

hf jobs run --flavor=a10g-small ubuntu nvidia-smi

Available hf jobs Subcommands:

  • run: 작업을 실행합니다.
  • ps: 활성 작업을 나열합니다.
  • logs: 특정 작업의 로그를 가져옵니다.
  • inspect: 하나 이상의 작업에 대한 상세 정보를 표시합니다.
  • cancel: 작업을 취소합니다.
  • uv: HF 인프라에서 UV를 사용해 인라인 종속성을 포함한 파이썬 스크립트를 실행합니다.

Sources