Chào `hf`- CLI Hugging Face nhanh hơn, thân thiện hơn ✨
Giới thiệu một CLI mới cho Hugging Face nhanh hơn và thân thiện hơn.
- 4 min read
Xin chào hf: Hugging Face CLI nhanh hơn, thân thiện hơn ✨
Chúng tôi rất vui mừng thông báo một cải tiến chất lượng cuộc sống được chờ đợi từ lâu: Hugging Face CLI đã chính thức được đổi tên từ huggingface-cli thành hf!
Vậy… tại sao lại có sự thay đổi này?
Việc gõ huggingface-cli liên tục sẽ nhanh chóng trở nên nhàm chán. Quan trọng hơn, cấu trúc lệnh của CLI trở nên lộn xộn khi các tính năng mới được thêm vào theo thời gian (tải lên, tải xuống, quản lý bộ nhớ cache, quản lý kho lưu trữ, v.v.). Đổi tên CLI là một cơ hội để sắp xếp lại các lệnh thành một định dạng rõ ràng, nhất quán hơn.
Chúng tôi quyết định không phát minh lại bánh xe và thay vào đó tuân theo một mẫu CLI nổi tiếng: hf <tài nguyên> <hành động>. Cú pháp dễ đoán này làm cho Hugging Face CLI trở nên tiện dụng và dễ khám phá hơn, đồng thời tạo tiền đề cho các tính năng sắp tới.
Bắt đầu
Để bắt đầu sử dụng CLI mới, bạn cần cài đặt phiên bản huggingface_hub mới nhất:
pip install -U huggingface_hub
và tải lại phiên terminal của bạn. Để kiểm tra cài đặt đã hoàn tất thành công, hãy chạy hf version:
➜ hf version
huggingface_hub version: 0.34.0
Tiếp theo, hãy khám phá cú pháp mới với hf --help:
➜ hf --help
usage: hf <command> [<args>]
positional arguments:
{auth,cache,download,jobs,repo,repo-files,upload,upload-large-folder,env,version,lfs-enable-largefiles,lfs-multipart-upload}
hf command helpers
auth Manage authentication (login, logout, etc.).
cache Manage local cache directory.
download Download files from the Hub
jobs Run and manage Jobs on the Hub.
repo Manage repos on the Hub.
repo-files Manage files in a repo on the Hub.
upload Upload a file or a folder to the Hub. Recommended for single-commit uploads.
upload-large-folder
Upload a large folder to the Hub. Recommended for resumable uploads.
env Print information about the environment.
version Print information about the hf version.
options:
-h, --help show this help message and exit
Như chúng ta có thể thấy, các lệnh được nhóm theo “tài nguyên” (hf auth, hf cache, hf repo, v.v.). Chúng tôi cũng đưa ra hf upload và hf download ở cấp gốc vì chúng dự kiến sẽ là các lệnh được sử dụng nhiều nhất.
Để tìm hiểu sâu hơn về bất kỳ nhóm lệnh nào, chỉ cần thêm --help:
➜ hf auth --help
usage: hf <command> [<args>] auth [-h] {login,logout,whoami,switch,list} ...
positional arguments:
{login,logout,whoami,switch,list}
Authentication subcommands
login Log in using a token from huggingface.co/settings/tokens
logout Log out
whoami Find out which huggingface.co account you are logged in as.
switch Switch between access tokens
list List all stored access tokens
options:
-h, --help show this help message and exit
🔀 Di chuyển
Nếu bạn đã quen với huggingface-cli, hầu hết các lệnh sẽ trông quen thuộc. Thay đổi lớn nhất ảnh hưởng đến xác thực:
huggingface-cli login
# trở thành
hf auth login
huggingface-cli whoami
# trở thành
hf auth whoami
huggingface-cli logout
# trở thành
hf auth logout
Tất cả các lệnh auth đã được nhóm lại với hf auth switch hiện có (để chuyển đổi giữa các hồ sơ cục bộ khác nhau) và hf auth list (để liệt kê các hồ sơ cục bộ).
CLI huggingface-cli kế thừa vẫn hoạt động và đầy đủ chức năng. Chúng tôi giữ nó lại để giúp việc chuyển đổi dễ dàng hơn. Nếu bạn sử dụng bất kỳ lệnh nào từ CLI kế thừa, bạn sẽ thấy một cảnh báo hướng bạn đến tương đương CLI mới:
➜ huggingface-cli whoami
⚠️ Warning: 'huggingface-cli whoami' is deprecated. Use 'hf auth whoami' instead.
Wauplin
orgs: huggingface,competitions,hf-internal-testing,templates,HF-test-lab,Gradio-Themes,autoevaluate,HuggingFaceM4,HuggingFaceH4,open-source-metrics,sd-concepts-library,hf-doc-build,hf-accelerate,HFSmolCluster,open-llm-leaderboard,pbdeeplinks,discord-community,llhf,sllhf,mt-metrics,DDUF,hf-inference,changelog,tiny-agents
Thêm một điều nữa… 💥 hf jobs
Chúng tôi không thể cưỡng lại việc phát hành lệnh chuyên dụng đầu tiên của mình: hf jobs.
Hugging Face Jobs là một dịch vụ mới cho phép bạn chạy bất kỳ tập lệnh hoặc ảnh Docker nào trên Cơ sở hạ tầng Hugging Face bằng cách sử dụng hương vị phần cứng bạn chọn. Thanh toán là “trả tiền theo mức sử dụng”, có nghĩa là bạn chỉ trả tiền cho số giây bạn sử dụng. Đây là cách khởi chạy lệnh đầu tiên của bạn:
# Run "nvidia-smi" on an A10G GPU
hf jobs run --flavor=a10g-small ubuntu nvidia-smi
CLI được lấy cảm hứng rất nhiều từ các lệnh quen thuộc của Docker:
➜ hf jobs --help
usage: hf <command> [<args>] jobs [-h] {inspect,logs,ps,run,cancel,uv} ...
positional arguments:
{inspect,logs,ps,run,cancel,uv}
huggingface.co jobs related commands
inspect Display detailed information on one or more Jobs
logs Fetch the logs of a Job
ps List Jobs
run Run a Job
cancel Cancel a Job
uv Run UV scripts (Python with inline dependencies) on HF infrastructure
options:
-h, --help show this help message and exit
Tìm hiểu thêm về Jobs bằng cách đọc hướng dẫn.
Hugging Face Jobs chỉ khả dụng cho người dùng Pro và các tổ chức Team hoặc Enterprise. Nâng cấp gói của bạn để bắt đầu!
Link bài viết gốc
- Tags:
- Ai
- July 25, 2025
- Huggingface.co