hf 소개: 더 빠르고 친근한 Hugging Face CLI

우리는 오랫동안 기다려온 품질 개선 사항을很高兴하게 발표합니다: Hugging Face CLI 는 공식적으로 huggingface-cli 에서 hf 로 이름이 변경되었습니다.

!

그렇다면... 왜 이 변화인가요?

huggingface-cli 를 입력하는 것은 항상 빨리 낡아갑니다. 더 중요한 것은, 새로운 기능 (업로드, 다운로드, 캐시 관리, 리포지토리 관리 등) 이 추가됨에 따라 CLI 의 명령어 구조가 엉망이 되었습니다. CLI 를 다시 이름 붙이는 것은 명령어를 더 명확하고 일관된 형식으로 재구성할 기회를 제공합니다.

우리는 바퀴를 다시 발명하지 않고 잘 알려진 CLI 패턴을 따르기로 결정했습니다: hf <resource> <action>. 이 예측 가능한 문법은 Hugging Face CLI 를 더 사용 용이하고 발견하기 쉽게 만들며, 또한 향후 기능의 무대를 마련합니다.

새로운 CLI 를 시작하려면 최신 huggingface_hub 버전을 설치해야 합니다:

pip install -U huggingface_hub

그리고 터미널 세션을 다시 로드하세요. 설치가 성공적으로 완료되었는지 테스트하려면 hf version 을 실행하세요:

➜ hf version
huggingface_hub version: 0.34.0

다음으로, hf --help 로 새로운 문법을 탐색해 보겠습니다:

➜ hf --help
usage: hf <command> [<args>]
positional arguments:
...

우리가 볼 수 있듯이, 명령어는 "리소스" (hf auth, hf cache, hf repo 등) 로 그룹화됩니다. 또한 가장 많이 사용되는 명령어로 예상되므로 루트 수준에서 hf upload 와 hf download 를 표출합니다.

아무든 명령어 그룹으로 더 깊게 들어가려면 단순히 --help 를 붙여넣으세요:

➜ hf auth --help
usage: hf <command> [<args>] auth [-h] {login,logout,whoami,switch,list} ...
positional arguments:
...

huggingface-cli 에 익숙하다면 대부분의 명령어는 친숙하게 보일 것입니다. 가장 큰 변화는 인증에 영향을 줍니다:

huggingface-cli login
# became
hf auth login

huggingface-cli whoami
# became
hf auth whoami

huggingface-cli logout
# became
hf auth logout

모든 auth 명령어는 기존 hf auth switch(다른 로컬 프로필 간 전환) 와 hf auth list(로컬 프로필 목록 표시) 와 함께 그룹화되었습니다.

유령 huggingface-cli 는 여전히 활성화되어 완전히 기능적입니다. 우리는 전환을 용이하게 하기 위해 그것을 유지합니다. 유령 CLI 의 명령어를 사용한다면, 새로운 CLI 등가체로 안내하는 경고 메시지를 보게 됩니다:

➜ huggingface-cli whoami
⚠️ Warning: 'huggingface-cli whoami' is deprecated. Use 'hf auth whoami' instead.
Wauplin
...

우리는 첫 번째 전용 명령어를 보내지 않을 수 없었습니다: hf jobs.

Hugging Face Jobs 는 Hugging Face 인프라를 사용하여 선택한 하드웨어 맛으로 모든 스크립트 또는 Docker 이미지를 실행할 수 있는 새로운 서비스입니다. 청구는 "사용량 기반" (pay-as-you-go) 으로, 사용된 초당만 지불합니다. 첫 번째 명령어를 시작하는 방법은 다음과 같습니다:

# A10G GPU 에서 "nvidia-smi" 실행
hf jobs run --flavor=a10g-small ubuntu nvidia-smi

CLI 는 Docker 의 친숙한 명령어에 크게 영감을 받았습니다:

➜ hf jobs --help
usage: hf <command> [<args>] jobs [-h] {inspect,logs,ps,run,cancel,uv} ...
positional arguments:
...

Jobs 에 대해 더 많이 배우려면 가이드를 읽으세요.

Hugging Face Jobs 는 Pro 사용자 및 Team 또는 Enterprise 조직에만 제공됩니다. 시작하기 위해 계획을 업그레이드하세요!