hf

Hugging Face Hub CLI

Cách sử dụng:

$ hf [OPTIONS] [COMMAND] [ARGS]...

Tùy chọn:

• --skills: In hf-cli SKILL.md ra stdout (biệt danh của hf skills preview).
• --install-completion: Cài đặt completion cho shell hiện tại.
• --show-completion: Hiển thị completion cho shell hiện tại, để sao chép hoặc tùy chỉnh cài đặt.
• --help: Hiển thị thông báo này và thoát.

Lệnh:

• auth: Quản lý xác thực (đăng nhập, đăng xuất, v.v.).
• buckets: Các lệnh để tương tác với buckets.
• cache: Quản lý thư mục cache cục bộ.
• collections: Tương tác với các bộ sưu tập trên Hub.
• cp: Sao chép tệp giữa các đường dẫn cục bộ, kho và bucket.
• datasets: Tương tác với các bộ dữ liệu trên Hub.
• discussions: Quản lý các cuộc thảo luận và yêu cầu kéo (pull requests) trên Hub.
• download: Tải tệp từ Hub.
• endpoints: Quản lý Hugging Face Inference Endpoints.
• env: In thông tin về môi trường.
• extensions: Quản lý các phần mở rộng của CLI hf. [alias: ext]
• jobs: Chạy và quản lý Jobs trên Hub.
• lfs-enable-largefiles: Cấu hình kho của bạn để cho phép tải lên các tệp > 5GB.
• lfs-multipart-upload: Tác nhân chuyển giao tùy chỉnh nội bộ của git-lfs cho các bản tải lên đa phần.
• models: Tương tác với các mô hình trên Hub.
• papers: Tương tác với các bài báo trên Hub.
• repos: Quản lý các kho trên Hub.
• sandbox: Chạy và quản lý các sandbox thử nghiệm trên Hugging Face Jobs.
• skills: Quản lý kỹ năng cho các trợ lý AI.
• spaces: Tương tác với các space trên Hub.
• sync: Đồng bộ hóa tệp giữa thư mục cục bộ và một bucket.
• update: Cập nhật CLI hf lên phiên bản mới nhất.
• upload: Tải lên tệp hoặc thư mục lên Hub.
• version: In thông tin về phiên bản hf.
• webhooks: Quản lý webhooks trên Hub.

hf auth

Quản lý xác thực (đăng nhập, đăng xuất, v.v.).

Cách sử dụng:

$ hf auth [OPTIONS] COMMAND [ARGS]...

Tùy chọn:

• --help: Hiển thị thông báo này và thoát.

Lệnh:

• list: Liệt kê tất cả các access token đã lưu. [alias: ls]
• login: Đăng nhập từ trình duyệt của bạn, hoặc sử dụng token từ huggingface.co/settings/tokens.
• logout: Đăng xuất khỏi một token cụ thể.
• switch: Chuyển đổi giữa các access token.
• token: In token truy cập hiện tại ra stdout.
• whoami: Tìm hiểu tài khoản huggingface.co mà bạn đang đăng nhập.

hf auth list

Liệt kê tất cả các token truy cập đã lưu. [alias: ls]

Cách sử dụng:

$ hf auth list [OPTIONS]

Tùy chọn:

• --help: Hiển thị thông báo này và thoát.

Ví dụ $c hf auth list$

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf auth login

Đăng nhập từ trình duyệt của bạn, hoặc sử dụng token từ huggingface.co/settings/tokens.

Cách sử dụng:

$ hf auth login [OPTIONS]

Tùy chọn:

• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --add-to-git-credential / --no-add-to-git-credential: Lưu vào git credential helper. Chỉ hữu ích nếu bạn dự định chạy các lệnh git trực tiếp. [mặc định: no-add-to-git-credential]
• --force / --no-force: Buộc đăng nhập lại ngay cả khi đã đăng nhập. [mặc định: no-force]
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf auth login $ hf auth login —token $HF_TOKEN $ hf auth login —token $HF_TOKEN —add-to-git-credential $ hf auth login —force

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf auth logout

Đăng xuất khỏi một token cụ thể.

Cách sử dụng:

$ hf auth logout [OPTIONS]

Tùy chọn:

• --token-name TEXT: Tên của token để đăng xuất
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf auth logout $ hf auth logout —token-name my-token

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf auth switch

Chuyển đổi giữa các token truy cập.

Cách sử dụng:

$ hf auth switch [OPTIONS]

Tùy chọn:

• --token-name TEXT: Tên của token cần chuyển sang
• --add-to-git-credential / --no-add-to-git-credential: Lưu vào git credential helper. Chỉ hữu ích nếu bạn dự định chạy các lệnh git trực tiếp. [mặc định: no-add-to-git-credential]
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf auth switch $ hf auth switch —token-name my-token

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf auth token

In ra token truy cập hiện tại ra stdout.

Cách sử dụng:

$ hf auth token [OPTIONS]

Tùy chọn:

• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf auth token $ hf auth token | xargs curl -H ‘Authorization: Bearer {}’

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf auth whoami

Tìm hiểu tài khoản huggingface.co mà bạn đang đăng nhập.

Cách sử dụng:

$ hf auth whoami [OPTIONS]

Tùy chọn:

• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf auth whoami $ hf auth whoami —format json

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf buckets

Các lệnh để tương tác với các bucket.

Cách sử dụng:

$ hf buckets [OPTIONS] COMMAND [ARGS]...

Tùy chọn:

• --help: Hiển thị thông báo này và thoát.

Lệnh:

• cp: Sao chép tệp giữa các đường dẫn cục bộ, kho và bucket.
• create: Tạo một bucket mới.
• delete: Xóa một bucket.
• info: Lấy thông tin về một bucket.
• list: Liệt kê các bucket hoặc tệp trong một bucket. [biệt danh: ls]
• move: Di chuyển (đổi tên) một bucket sang tên hoặc namespace mới.
• remove: Xóa các tệp khỏi bucket. [alias: rm]
• settings: Cập nhật cài đặt bucket (tính khả dụng).
• sync: Đồng bộ hóa tệp giữa thư mục cục bộ và một bucket.

hf buckets cp

Sao chép tệp giữa các đường dẫn cục bộ, kho và bucket.

Xử lý tải lên (local/stdin -> repo/bucket), tải xuống (repo/bucket -> local/stdout) và sao chép từ xa đến từ xa (repo/bucket -> repo/bucket). Việc sao chép từ bucket sang repo và từ local sang local không được hỗ trợ. Đối với thư mục, hãy sử dụng hf upload/hf download (cho repos) hoặc hf buckets sync (cho buckets). Việc sao chép từ xa đến từ xa chỉ hoạt động trong cùng một khu vực lưu trữ (https://huggingface.co/docs/hub/storage-regions).

Cách sử dụng:

$ hf buckets cp [OPTIONS] SRC [DST]

Tham số:

• SRC: Nguồn: tệp cục bộ, URI hf:// (kho hoặc bucket), hoặc - cho stdin. [bắt buộc]
• [DST]: Điểm đến: đường dẫn cục bộ, URI hf:// (kho hoặc bucket), hoặc - cho stdout.

Tùy chọn:

• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf buckets cp hf://buckets/username/my-bucket/config.json config.json $ hf buckets cp hf://buckets/username/my-bucket/data.csv data/ $ hf buckets cp hf://buckets/username/my-bucket/config.json - $ hf buckets cp model.safetensors hf://buckets/username/my-bucket/model.safetensors $ hf buckets cp config.json hf://buckets/username/my-bucket/logs/ $ hf buckets cp - hf://buckets/username/my-bucket/config.json $ hf buckets cp hf://buckets/username/my-bucket/data.csv hf://buckets/username/dest-bucket/ $ hf buckets cp hf://buckets/username/source-bucket/logs/ hf://buckets/username/dest-bucket/logs/

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf buckets create

Tạo một bucket mới.

Cách sử dụng:

$ hf buckets create [OPTIONS] BUCKET_ID

Tham số:

• BUCKET_ID: Bucket ID: bucket_name, namespace/bucket_name, hoặc hf://buckets/namespace/bucket_name [bắt buộc]

Tùy chọn:

• --private: Tạo một bucket riêng tư.
• --region [us|eu]: Vùng cloud để tạo bucket. Có thể là ‘us’ hoặc ‘eu’. Yêu cầu gói Team trở lên.
• --exist-ok: Không gây ra lỗi nếu bucket đã tồn tại.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf buckets create my-bucket $ hf buckets create user/my-bucket $ hf buckets create hf://buckets/user/my-bucket $ hf buckets create user/my-bucket —private $ hf buckets create user/my-bucket —exist-ok $ hf buckets create user/my-bucket —region us

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf buckets delete

Xóa một bucket.

Thao tác này sẽ xóa toàn bộ bucket và tất cả nội dung bên trong. Sử dụng hf buckets rm để xóa từng tệp riêng lẻ.

Cách sử dụng:

$ hf buckets delete [OPTIONS] BUCKET_ID

Tham số:

• BUCKET_ID: ID của Bucket: namespace/bucket_name hoặc hf://buckets/namespace/bucket_name [bắt buộc]

Tùy chọn:

• -y, --yes: Bỏ qua lời nhắc xác nhận.
• --missing-ok: Không báo lỗi nếu bucket không tồn tại.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf buckets delete user/my-bucket $ hf buckets delete hf://buckets/user/my-bucket $ hf buckets delete user/my-bucket —yes $ hf buckets delete user/my-bucket —missing-ok

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf buckets info

Lấy thông tin về một bucket.

Cách sử dụng:

$ hf buckets info [OPTIONS] BUCKET_ID

Tham số:

• BUCKET_ID: ID của Bucket: namespace/bucket_name hoặc hf://buckets/namespace/bucket_name [bắt buộc]

Tùy chọn:

• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf buckets info user/my-bucket $ hf buckets info hf://buckets/user/my-bucket

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf buckets list

Liệt kê các bucket hoặc tệp trong một bucket. [alias: ls]

Khi được gọi không có đối số hoặc với một namespace, liệt kê các bucket. Khi được gọi với một ID bucket (namespace/bucket_name), liệt kê các tệp trong bucket.

Cách sử dụng:

$ hf buckets list [OPTIONS] [ARGUMENT]

Tham số:

• [ARGUMENT]: Namespace (người dùng hoặc tổ chức) để liệt kê các bucket, hoặc ID của bucket (namespace/bucket_name(/prefix) hoặc hf://buckets/…) để liệt kê các tệp.

Tùy chọn:

• -h, --human-readable: Hiển thị kích thước ở định dạng dễ đọc.
• --tree: Liệt kê các tệp theo định dạng cây (chỉ dùng để liệt kê tệp).
• -R, --recursive: Liệt kê các tệp đệ quy (chỉ dùng để liệt kê tệp).
• --search TEXT: Câu truy vấn tìm kiếm.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf buckets list $ hf buckets list huggingface $ hf buckets list —search “my-prefix” $ hf buckets list user/my-bucket $ hf buckets list user/my-bucket -R $ hf buckets list user/my-bucket -h $ hf buckets list user/my-bucket —tree $ hf buckets list user/my-bucket —tree -h $ hf buckets list hf://buckets/user/my-bucket $ hf buckets list user/my-bucket/sub -R

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf buckets move

Di chuyển (đổi tên) một bucket sang tên hoặc namespace mới.

Cách sử dụng:

$ hf buckets move [OPTIONS] FROM_ID TO_ID

Tham số:

• FROM_ID: ID của bucket nguồn: namespace/bucket_name hoặc hf://buckets/namespace/bucket_name [bắt buộc]
• TO_ID: ID của bucket đích: namespace/bucket_name hoặc hf://buckets/namespace/bucket_name [bắt buộc]

Tùy chọn:

• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf buckets move user/old-bucket user/new-bucket $ hf buckets move user/my-bucket my-org/my-bucket $ hf buckets move hf://buckets/user/old-bucket hf://buckets/user/new-bucket

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf buckets remove

Xóa các tệp khỏi một bucket. [alias: rm]

Để xóa toàn bộ bucket, hãy sử dụng hf buckets delete thay thế.

Cách sử dụng:

$ hf buckets remove [OPTIONS] ARGUMENT

Tham số:

• ARGUMENT: Đường dẫn bucket: namespace/bucket_name/path hoặc hf://buckets/namespace/bucket_name/path. Khi dùng —recursive, namespace/bucket_name cũng được chấp nhận để nhắm đến tất cả các tệp. [bắt buộc]

Tùy chọn:

• -R, --recursive: Xóa đệ quy các tệp dưới tiền tố đã cho.
• -y, --yes: Bỏ qua lời nhắc xác nhận.
• --dry-run: Xem trước những gì sẽ bị xóa mà không thực sự xóa.
• --include TEXT: Chỉ bao gồm các tệp khớp với mẫu (có thể chỉ định nhiều mẫu). Yêu cầu —recursive.
• --exclude TEXT: Loại trừ các tệp khớp với mẫu (có thể chỉ định nhiều mẫu). Yêu cầu —recursive.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf buckets remove user/my-bucket/file.txt $ hf buckets rm hf://buckets/user/my-bucket/file.txt $ hf buckets rm user/my-bucket/logs/ —recursive $ hf buckets rm user/my-bucket —recursive —include “*.tmp” $ hf buckets rm user/my-bucket/data/ —recursive —dry-run

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf buckets settings

Cập nhật cài đặt bucket (tính năng hiển thị).

Cách sử dụng:

$ hf buckets settings [OPTIONS] BUCKET_ID

Tham số:

• BUCKET_ID: ID của Bucket: namespace/bucket_name hoặc hf://buckets/namespace/bucket_name [bắt buộc]

Tùy chọn:

• --private: Đặt bucket ở chế độ riêng tư.
• --public: Làm cho bucket công khai.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf buckets settings user/my-bucket —private $ hf buckets settings user/my-bucket —public $ hf buckets settings hf://buckets/user/my-bucket —private

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf buckets sync

Đồng bộ hóa tệp giữa thư mục cục bộ và một bucket.

Cách sử dụng:

$ hf buckets sync [OPTIONS] [SOURCE] [DEST]

Tham số:

• [SOURCE]: Đường dẫn nguồn: thư mục cục bộ hoặc hf://buckets/namespace/bucket_name(/prefix)
• [DEST]: Đường dẫn đích: thư mục cục bộ hoặc hf://buckets/namespace/bucket_name(/prefix)

Tùy chọn:

• --delete / --no-delete: Xóa các tệp đích không có trong nguồn. [mặc định: no-delete]
• --ignore-times: Bỏ qua các tệp chỉ dựa trên kích thước, bỏ qua thời gian sửa đổi.
• --ignore-sizes: Bỏ qua các tệp chỉ dựa trên thời gian sửa đổi, bỏ qua kích thước.
• --plan TEXT: Lưu kế hoạch đồng bộ vào tệp JSONL để xem xét thay vì thực thi.
• --apply TEXT: Áp dụng tệp kế hoạch đã lưu trước đó.
• --dry-run: In kế hoạch đồng bộ ra stdout dưới dạng JSONL mà không thực thi.
• --include TEXT: Bao gồm các tệp khớp với mẫu (có thể chỉ định nhiều mẫu).
• --exclude TEXT: Loại trừ các tệp khớp với mẫu (có thể chỉ định nhiều mẫu).
• --filter-from TEXT: Đọc các mẫu bao gồm/loại trừ từ tệp.
• --existing: Bỏ qua việc tạo các tệp mới trên máy nhận (chỉ cập nhật các tệp hiện có).
• --ignore-existing: Bỏ qua việc cập nhật các tệp đã tồn tại trên máy nhận (chỉ tạo tệp mới).
• -v, --verbose: Hiển thị nhật ký chi tiết kèm lý do.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf buckets sync ./data hf://buckets/user/my-bucket $ hf buckets sync hf://buckets/user/my-bucket ./data $ hf buckets sync ./data hf://buckets/user/my-bucket —delete $ hf buckets sync hf://buckets/user/my-bucket ./data —include ”.safetensors” —exclude ”.tmp” $ hf buckets sync ./data hf://buckets/user/my-bucket —plan sync-plan.jsonl $ hf buckets sync —apply sync-plan.jsonl $ hf buckets sync ./data hf://buckets/user/my-bucket —dry-run $ hf buckets sync ./data hf://buckets/user/my-bucket —dry-run | jq .

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf cache

Quản lý thư mục bộ nhớ đệm cục bộ.

Cách sử dụng:

$ hf cache [OPTIONS] COMMAND [ARGS]...

Tùy chọn:

• --help: Hiển thị thông báo này và thoát.

Lệnh:

• list: Liệt kê các kho hoặc phiên bản đã được lưu trong bộ nhớ đệm. [biệt danh: ls]
• prune: Xóa các bản sửa đổi đã tách rời và các lượt tải xuống chưa hoàn tất khỏi bộ nhớ đệm.
• rm: Xóa các kho, phiên bản hoặc tệp đã được lưu trong bộ nhớ đệm.
• verify: Xác minh các mã kiểm tra cho một bản sửa đổi kho duy nhất từ bộ nhớ đệm hoặc thư mục cục bộ.

hf cache list

Liệt kê các kho hoặc bản sửa đổi đã được lưu trong bộ nhớ đệm. [biệt danh: ls]

Cách sử dụng:

$ hf cache list [OPTIONS]

Tùy chọn:

• --cache-dir TEXT: Thư mục cache để quét (mặc định là cache của Hugging Face).
• --revisions / --no-revisions: Bao gồm các bản sửa đổi trong kết quả đầu ra thay vì các kho đã được tổng hợp. [mặc định: no-revisions]
• -f, --filter TEXT: Lọc các mục (ví dụ: ‘size>1GB’, ‘type=model’, ‘accessed>7d’). Có thể sử dụng nhiều lần.
• --sort [accessed|accessed:asc|accessed:desc|modified|modified:asc|modified:desc|name|name:asc|name:desc|size|size:asc|size:desc]: Sắp xếp các mục theo khóa. Các khóa được hỗ trợ: ‘accessed’, ‘modified’, ‘name’, ‘size’. Thêm ‘:asc’ hoặc ‘:desc’ để đặt rõ thứ tự (ví dụ: ‘modified:asc’). Mặc định: ‘accessed’, ‘modified’, ‘size’ mặc định là ‘desc’ (mới nhất/lớn nhất trước); ‘name’ mặc định là ‘asc’ (theo bảng chữ cái).
• --limit INTEGER: Giới hạn số lượng kết quả được trả về. Chỉ trả về N mục hàng đầu sau khi sắp xếp.
• --show-warnings / --no-show-warnings: Hiển thị các cảnh báo về sự không nhất quán của bộ nhớ đệm. [mặc định: no-show-warnings]
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf cache ls $ hf cache ls —revisions $ hf cache ls —filter “size>1GB” —limit 20 $ hf cache ls —format json

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf cache prune

Xóa các bản sửa đổi đã tách rời và các lượt tải xuống chưa hoàn tất khỏi bộ nhớ đệm.

Cách sử dụng:

$ hf cache prune [OPTIONS]

Tùy chọn:

• --cache-dir TEXT: Thư mục cache để quét (mặc định là cache của Hugging Face).
• -y, --yes: Bỏ qua lời nhắc xác nhận.
• --dry-run / --no-dry-run: Xem trước các thao tác xóa mà không thực sự xóa bất kỳ thứ gì. [mặc định: no-dry-run]
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf cache prune $ hf cache prune —dry-run

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf cache rm

Xóa các kho, phiên bản hoặc tệp đã được lưu trong bộ nhớ đệm.

Cách sử dụng:

$ hf cache rm [OPTIONS] TARGETS...

Tham số:

• TARGETS...: Một hoặc nhiều repo ID (ví dụ: model/bert-base-uncased), URI hf:// (repo hoặc file), hoặc revision hash cần xóa. [bắt buộc]

Tùy chọn:

• --cache-dir TEXT: Thư mục cache để quét (mặc định là cache của Hugging Face).
• -y, --yes: Bỏ qua lời nhắc xác nhận.
• --dry-run / --no-dry-run: Xem trước các thao tác xóa mà không thực sự xóa bất kỳ thứ gì. [mặc định: no-dry-run]
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf cache rm model/gpt2 $ hf cache rm hf://models/openai-community/gpt2 $ hf cache rm hf://models/openai-community/gpt2/model.safetensors $ hf cache rm <revision_hash> $ hf cache rm model/gpt2 —dry-run $ hf cache rm model/gpt2 —yes

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf cache verify

Xác minh các mã kiểm tra cho một bản sửa đổi kho duy nhất từ bộ nhớ đệm hoặc một thư mục cục bộ.

Ví dụ:

• Xác nhận bản sửa chính trong bộ nhớ đệm: hf cache verify gpt2
• Xác minh bản sửa đổi cụ thể: hf cache verify gpt2 --revision refs/pr/1
• Xác minh bộ dữ liệu: hf cache verify karpathy/fineweb-edu-100b-shuffle --repo-type dataset
• Xác nhận thư mục cục bộ: hf cache verify deepseek-ai/DeepSeek-OCR --local-dir /path/to/repo

Cách sử dụng:

$ hf cache verify [OPTIONS] REPO_ID

Tham số:

• REPO_ID: ID của kho (ví dụ username/repo-name hoặc spaces/username/repo-name). [bắt buộc]

Tùy chọn:

• --type, --repo-type [model|dataset|space|kernel]: Kiểu kho (model, dataset, space hoặc kernel). [mặc định: model]
• --revision TEXT: id của bản sửa đổi Git, có thể là tên nhánh, thẻ hoặc mã băm của commit.
• --cache-dir TEXT: Thư mục cache để sử dụng khi xác minh các tệp từ cache (mặc định là cache của Hugging Face).
• --local-dir TEXT: Nếu được đặt, xác minh các tệp trong thư mục này thay vì trong bộ nhớ đệm.
• --fail-on-missing-files: Lỗi nếu một số tệp tồn tại trên máy chủ từ xa nhưng thiếu ở máy cục bộ.
• --fail-on-extra-files: Lỗi nếu một số tệp tồn tại cục bộ nhưng không có trong bản sửa đổi từ xa.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf cache verify gpt2 $ hf cache verify gpt2 —revision refs/pr/1 $ hf cache verify my-dataset —repo-type dataset

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf collections

Tương tác với các bộ sưu tập trên Hub.

Cách sử dụng:

$ hf collections [OPTIONS] COMMAND [ARGS]...

Tùy chọn:

• --help: Hiển thị thông báo này và thoát.

Lệnh:

• add-item: Thêm một mục vào bộ sưu tập.
• create: Tạo một bộ sưu tập mới trên Hub.
• delete: Xóa một bộ sưu tập khỏi Hub.
• delete-item: Xóa một mục khỏi bộ sưu tập.
• info: Lấy thông tin về một bộ sưu tập trên Hub.
• list: Liệt kê các bộ sưu tập trên Hub. [alias: ls]
• update: Cập nhật metadata của một collection trên Hub.
• update-item: Cập nhật một mục trong bộ sưu tập.

hf collections add-item

Thêm một mục vào bộ sưu tập.

Cách sử dụng:

$ hf collections add-item [OPTIONS] COLLECTION_SLUG ITEM_ID ITEM_TYPE:{model|dataset|space|paper|collection|bucket}

Tham số:

• COLLECTION_SLUG: slug của bộ sưu tập (ví dụ: ‘username/collection-slug’). [bắt buộc]
• ITEM_ID: ID của mục cần thêm (repo_id cho repos, paper ID cho papers). [bắt buộc]
• ITEM_TYPE:{model|dataset|space|paper|collection|bucket}: Loại mục (model, dataset, space, paper, collection, hoặc bucket). [bắt buộc]

Tùy chọn:

• --note TEXT: Ghi chú đính kèm cho mục (tối đa 500 ký tự).
• --exists-ok / --no-exists-ok: Không gây ra lỗi nếu mục đã có trong bộ sưu tập. [mặc định: no-exists-ok]
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf collections add-item username/my-collection moonshotai/kimi-k2 model $ hf collections add-item username/my-collection Qwen/DeepPlanning dataset —note “Useful dataset” $ hf collections add-item username/my-collection Tongyi-MAI/Z-Image space

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf collections create

Tạo một bộ sưu tập mới trên Hub.

Cách sử dụng:

$ hf collections create [OPTIONS] TITLE

Tham số:

• TITLE: Tiêu đề của bộ sưu tập. [bắt buộc]

Tùy chọn:

• --namespace TEXT: Namespace (tên người dùng hoặc tổ chức). Mặc định là người dùng đã xác thực.
• --description TEXT: Mô tả cho bộ sưu tập (tối đa 150 ký tự).
• --private / --no-private: Tạo bộ sưu tập riêng tư. [mặc định: no-private]
• --exists-ok / --no-exists-ok: Không gây ra lỗi nếu bộ sưu tập đã tồn tại. [mặc định: no-exists-ok]
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf collections create “My Models” $ hf collections create “My Models” —description “A collection of my favorite models” —private $ hf collections create “Org Collection” —namespace my-org

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf collections delete

Xóa một bộ sưu tập khỏi Hub.

Cách sử dụng:

$ hf collections delete [OPTIONS] COLLECTION_SLUG

Tham số:

• COLLECTION_SLUG: slug của bộ sưu tập (ví dụ: ‘username/collection-slug’). [bắt buộc]

Tùy chọn:

• --missing-ok / --no-missing-ok: Không gây ra lỗi nếu bộ sưu tập không tồn tại. [mặc định: no-missing-ok]
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf collections delete username/my-collection $ hf collections delete username/my-collection —missing-ok

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf collections delete-item

Xóa một mục khỏi bộ sưu tập.

Cách sử dụng:

$ hf collections delete-item [OPTIONS] COLLECTION_SLUG ITEM_OBJECT_ID

Tham số:

• COLLECTION_SLUG: slug của bộ sưu tập (ví dụ: ‘username/collection-slug’). [bắt buộc]
• ITEM_OBJECT_ID: ID của mục trong bộ sưu tập (lấy từ trường item_object_id được trả về bởi ‘hf collections info’. [bắt buộc]

Tùy chọn:

• --missing-ok / --no-missing-ok: Không gây ra lỗi nếu mục không tồn tại. [mặc định: no-missing-ok]
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

hf collections info

Lấy thông tin về một bộ sưu tập trên Hub.

Cách sử dụng:

$ hf collections info [OPTIONS] COLLECTION_SLUG

Tham số:

• COLLECTION_SLUG: slug của bộ sưu tập (ví dụ: ‘username/collection-slug’). [bắt buộc]

Tùy chọn:

• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf collections info username/my-collection-slug

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf collections list

Liệt kê các bộ sưu tập trên Hub. [alias: ls]

Cách sử dụng:

$ hf collections list [OPTIONS]

Tùy chọn:

• --owner TEXT: Lọc theo tên người dùng hoặc tên tổ chức của chủ sở hữu.
• --item TEXT: Lọc các bộ sưu tập chứa một mục cụ thể (ví dụ: “models/gpt2”, “datasets/squad”, “papers/2311.12983”).
• --sort [lastModified|trending|upvotes]: Sắp xếp kết quả theo thời gian sửa đổi gần nhất, xu hướng hoặc lượt bình chọn.
• --limit INTEGER: Giới hạn số lượng kết quả. [mặc định: 10]
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf collections ls $ hf collections ls —owner nvidia $ hf collections ls —item models/teknium/OpenHermes-2.5-Mistral-7B —limit 10

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf collections update

Cập nhật metadata của một collection trên Hub.

Cách sử dụng:

$ hf collections update [OPTIONS] COLLECTION_SLUG

Tham số:

• COLLECTION_SLUG: slug của bộ sưu tập (ví dụ: ‘username/collection-slug’). [bắt buộc]

Tùy chọn:

• --title TEXT: Tiêu đề mới cho bộ sưu tập.
• --description TEXT: Mô tả mới cho bộ sưu tập (tối đa 150 ký tự).
• --position INTEGER: Vị trí mới của bộ sưu tập trong danh sách của chủ sở hữu.
• --private / --no-private: Xác định xem bộ sưu tập có nên là riêng tư hay không.
• --theme TEXT: Màu chủ đề cho bộ sưu tập (ví dụ: ‘green’, ‘blue’).
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf collections update username/my-collection —title “New Title” $ hf collections update username/my-collection —description “Updated description” $ hf collections update username/my-collection —private —theme green

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf collections update-item

Cập nhật một mục trong bộ sưu tập.

Cách sử dụng:

$ hf collections update-item [OPTIONS] COLLECTION_SLUG ITEM_OBJECT_ID

Tham số:

• COLLECTION_SLUG: slug của bộ sưu tập (ví dụ: ‘username/collection-slug’). [bắt buộc]
• ITEM_OBJECT_ID: ID của mục trong bộ sưu tập (từ trường ‘item_object_id’, không phải repo_id). [bắt buộc]

Tùy chọn:

• --note TEXT: Ghi chú mới cho mục (tối đa 500 ký tự).
• --position INTEGER: Vị trí mới của mục trong bộ sưu tập.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf collections update-item username/my-collection ITEM_OBJECT_ID —note “Updated note” $ hf collections update-item username/my-collection ITEM_OBJECT_ID —position 0

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf cp

Sao chép tệp giữa các đường dẫn cục bộ, kho và bucket.

Xử lý tải lên (local/stdin -> repo/bucket), tải xuống (repo/bucket -> local/stdout) và sao chép từ xa đến từ xa (repo/bucket -> repo/bucket). Việc sao chép từ bucket sang repo và từ local sang local không được hỗ trợ. Đối với thư mục, hãy sử dụng hf upload/hf download (cho repos) hoặc hf buckets sync (cho buckets). Việc sao chép từ xa đến từ xa chỉ hoạt động trong cùng một khu vực lưu trữ (https://huggingface.co/docs/hub/storage-regions).

Cách sử dụng:

$ hf cp [OPTIONS] SRC [DST]

Tham số:

• SRC: Nguồn: tệp cục bộ, URI hf:// (kho hoặc bucket), hoặc - cho stdin. [bắt buộc]
• [DST]: Điểm đến: đường dẫn cục bộ, URI hf:// (kho hoặc bucket), hoặc - cho stdout.

Tùy chọn:

• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf cp hf://username/my-model/config.json $ hf cp hf://username/my-model/config.json ./config.json $ hf cp hf://datasets/username/my-dataset/data.csv ./data/ $ hf cp hf://buckets/username/my-bucket/config.json - $ hf cp ./model.safetensors hf://username/my-model/model.safetensors $ hf cp ./config.json hf://buckets/username/my-bucket/logs/ $ hf cp - hf://buckets/username/my-bucket/config.json $ hf cp hf://username/source-model/ hf://username/dest-model/ $ hf cp hf://datasets/username/my-dataset/processed/ hf://buckets/username/my-bucket/processed/ $ hf cp hf://buckets/username/my-bucket/logs/ hf://buckets/username/archive-bucket/ # copies contents only

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf datasets

Tương tác với các bộ dữ liệu trên Hub.

Cách sử dụng:

$ hf datasets [OPTIONS] COMMAND [ARGS]...

Tùy chọn:

• --help: Hiển thị thông báo này và thoát.

Lệnh:

• card: Lấy thẻ dữ liệu (README) của một bộ dữ liệu trên Hub.
• info: Lấy thông tin về một bộ dữ liệu trên Hub.
• leaderboard: Liệt kê điểm của các mô hình từ bảng xếp hạng bộ dữ liệu.
• list: Liệt kê các bộ dữ liệu trên Hub, hoặc các tệp trong kho bộ dữ liệu. [biệt danh: ls]
• parquet: Danh sách các URL tệp parquet có sẵn cho một bộ dữ liệu.
• sql: Thực thi truy vấn SQL thô bằng DuckDB trên các URL parquet của dataset.

hf datasets card

Lấy thẻ dataset (README) cho một dataset trên Hub.

Cách sử dụng:

$ hf datasets card [OPTIONS] DATASET_ID

Tham số:

• DATASET_ID: ID của bộ dữ liệu (ví dụ: username/repo-name). [bắt buộc]

Tùy chọn:

• --metadata: Chỉ xuất metadata từ thẻ.
• --text: Chỉ xuất phần thân văn bản (không có metadata).
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf datasets card HuggingFaceFW/fineweb $ hf datasets card HuggingFaceFW/fineweb —metadata $ hf datasets card HuggingFaceFW/fineweb —metadata —format json $ hf datasets card HuggingFaceFW/fineweb —text

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf datasets info

Lấy thông tin về một bộ dữ liệu trên Hub.

Cách sử dụng:

$ hf datasets info [OPTIONS] DATASET_ID

Tham số:

• DATASET_ID: ID của bộ dữ liệu (ví dụ: username/repo-name). [bắt buộc]

Tùy chọn:

• --revision TEXT: id của bản sửa đổi Git, có thể là tên nhánh, thẻ hoặc mã băm của commit.
• --expand TEXT: Các thuộc tính được phân tách bằng dấu phẩy để trả về. Khi được sử dụng, chỉ các thuộc tính được liệt kê (và id) sẽ được trả về. Ví dụ: ‘—expand=downloads,likes,tags’. Hợp lệ: author, cardData, citation, createdAt, description, disabled, downloads, downloadsAllTime, gated, lastModified, likes, mainSize, paperswithcode_id, private, resourceGroup, sha, siblings, tags, trendingScore, usedStorage.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf datasets info HuggingFaceFW/fineweb $ hf datasets info my-dataset —expand downloads,likes,tags

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf datasets leaderboard

Liệt kê điểm của các mô hình từ bảng xếp hạng bộ dữ liệu. Lệnh này giúp tìm các mô hình tốt nhất cho một tác vụ hoặc so sánh các mô hình theo điểm chuẩn. Sử dụng ‘hf datasets ls —filter benchmark:official’ để liệt kê các bảng xếp hạng có sẵn.

Cách sử dụng:

$ hf datasets leaderboard [OPTIONS] DATASET_ID

Tham số:

• DATASET_ID: ID của bộ dữ liệu benchmark (ví dụ: SWE-bench/SWE-bench_Verified). [bắt buộc]

Tùy chọn:

• --limit INTEGER: Giới hạn số lượng kết quả. [mặc định: 20]
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf datasets leaderboard SWE-bench/SWE-bench_Verified $ hf datasets leaderboard SWE-bench/SWE-bench_Verified —limit 5 —format json $ hf datasets ls —filter benchmark:official # list available leaderboards

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf datasets list

Liệt kê các bộ dữ liệu trên Hub, hoặc các tệp trong kho bộ dữ liệu. [alias: ls]

Khi được gọi không có đối số, liệt kê các bộ dữ liệu trên Hub. Khi được gọi với một ID bộ dữ liệu, liệt kê các tệp trong kho bộ dữ liệu đó.

Cách sử dụng:

$ hf datasets list [OPTIONS] [REPO_ID]

Tham số:

• [REPO_ID]: Dataset ID (ví dụ: username/repo-name) để liệt kê các tệp từ đó. Nếu bỏ qua, sẽ liệt kê các dataset.

Tùy chọn:

• --search TEXT: Câu truy vấn tìm kiếm.
• --author TEXT: Lọc theo tác giả hoặc tổ chức.
• --filter TEXT: Lọc theo thẻ (ví dụ: ‘text-classification’). Có thể sử dụng nhiều lần.
• --sort [created_at|downloads|last_modified|likes|trending_score]: Sắp xếp kết quả.
• --limit INTEGER: Giới hạn số lượng kết quả. [mặc định: 30]
• --expand TEXT: Các thuộc tính được phân tách bằng dấu phẩy để trả về. Khi được sử dụng, chỉ các thuộc tính được liệt kê (và id) sẽ được trả về. Ví dụ: ‘—expand=downloads,likes,tags’. Hợp lệ: author, cardData, citation, createdAt, description, disabled, downloads, downloadsAllTime, gated, lastModified, likes, mainSize, paperswithcode_id, private, resourceGroup, sha, siblings, tags, trendingScore, usedStorage.
• -h, --human-readable: Hiển thị kích thước ở định dạng dễ đọc (chỉ áp dụng khi liệt kê tệp).
• --tree: Liệt kê các tệp theo định dạng cây (chỉ dùng để liệt kê tệp).
• -R, --recursive: Liệt kê các tệp đệ quy (chỉ dùng để liệt kê tệp).
• --revision TEXT: id của bản sửa đổi Git, có thể là tên nhánh, thẻ hoặc mã băm của commit.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf datasets ls $ hf datasets ls —sort downloads —limit 10 $ hf datasets ls —search “code” $ hf datasets ls —filter benchmark:official $ hf datasets ls HuggingFaceFW/fineweb $ hf datasets ls HuggingFaceFW/fineweb -R $ hf datasets ls HuggingFaceFW/fineweb —tree -h

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf datasets parquet

Liệt kê các URL tệp parquet có sẵn cho một tập dữ liệu.

Cách sử dụng:

$ hf datasets parquet [OPTIONS] DATASET_ID

Tham số:

• DATASET_ID: ID của bộ dữ liệu (ví dụ: username/repo-name). [bắt buộc]

Tùy chọn:

• --subset TEXT: Lọc các mục parquet theo subset/config.
• --split TEXT: Lọc các mục parquet theo split.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf datasets parquet cfahlgren1/hub-stats $ hf datasets parquet cfahlgren1/hub-stats —subset models $ hf datasets parquet cfahlgren1/hub-stats —split train $ hf datasets parquet cfahlgren1/hub-stats —format json

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf datasets sql

Thực thi truy vấn SQL thô bằng DuckDB trên các URL parquet của dataset.

Cách sử dụng:

$ hf datasets sql [OPTIONS] SQL

Tham số:

• SQL: Truy vấn SQL thô cần thực thi. [bắt buộc]

Tùy chọn:

• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf datasets sql “SELECT COUNT() AS rows FROM read_parquet(’https://huggingface.co/api/datasets/cfahlgren1/hub-stats/parquet/models/train/0.parquet’)” $ hf datasets sql “SELECT FROM read_parquet(’https://huggingface.co/api/datasets/cfahlgren1/hub-stats/parquet/models/train/0.parquet’) LIMIT 5” —format json

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf discussions

Quản lý các cuộc thảo luận và yêu cầu kéo (pull requests) trên Hub.

Cách sử dụng:

$ hf discussions [OPTIONS] COMMAND [ARGS]...

Tùy chọn:

• --help: Hiển thị thông báo này và thoát.

Lệnh:

• close: Đóng một cuộc thảo luận hoặc pull request.
• comment: Bình luận về một cuộc thảo luận hoặc pull request.
• create: Tạo một cuộc thảo luận hoặc pull request mới trên một repo.
• diff: Hiển thị diff của một pull request.
• edit: Chỉnh sửa một bình luận hiện có trên một cuộc thảo luận hoặc pull request.
• info: Lấy thông tin về một cuộc thảo luận hoặc pull request.
• list: Liệt kê các cuộc thảo luận và pull request trên một repo. [alias: ls]
• merge: Hợp nhất một pull request.
• rename: Đổi tên một cuộc thảo luận hoặc pull request.
• reopen: Mở lại một cuộc thảo luận hoặc pull request đã đóng.

hf discussions close

Đóng một cuộc thảo luận hoặc pull request.

Cách sử dụng:

$ hf discussions close [OPTIONS] REPO_ID NUM

Tham số:

• REPO_ID: ID của kho (ví dụ username/repo-name hoặc spaces/username/repo-name). [bắt buộc]
• NUM: Số của cuộc thảo luận hoặc pull request. [bắt buộc]

Tùy chọn:

• --comment TEXT: Một bình luận tùy chọn để đăng khi đóng.
• -y, --yes: Bỏ qua lời nhắc xác nhận.
• --type, --repo-type [model|dataset|space|kernel]: Kiểu kho (model, dataset, space hoặc kernel). [mặc định: model]
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf discussions close username/my-model 5 $ hf discussions close username/my-model 5 —comment “Đóng vì đã được giải quyết.”

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf discussions comment

Bình luận về một cuộc thảo luận hoặc pull request.

Cách sử dụng:

$ hf discussions comment [OPTIONS] REPO_ID NUM

Tham số:

• REPO_ID: ID của kho (ví dụ username/repo-name hoặc spaces/username/repo-name). [bắt buộc]
• NUM: Số của cuộc thảo luận hoặc pull request. [bắt buộc]

Tùy chọn:

• --body TEXT: Nội dung bình luận (hỗ trợ Markdown).
• --body-file PATH: Đọc chú thích từ một tệp. Sử dụng ’-’ cho stdin.
• --attach TEXT: Nối tệp hình ảnh, video hoặc âm thanh, dưới dạng ‘FILE’ hoặc ‘FILE#alt text’. Tham chiếu ‘’ trong nội dung sẽ được thay thế bằng tệp đã tải lên, các tệp khác sẽ được thêm vào. Có thể sử dụng nhiều lần.
• --type, --repo-type [model|dataset|space|kernel]: Kiểu kho (model, dataset, space hoặc kernel). [mặc định: model]
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf discussions comment username/my-model 5 —body “Thanks for reporting!” $ hf discussions comment username/my-model 5 —body “LGTM!” $ hf discussions comment username/my-model 5 —body “Here is a demo:” —attach demo.mp4

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf discussions create

Tạo một cuộc thảo luận hoặc pull request mới trên một repo.

Cách sử dụng:

$ hf discussions create [OPTIONS] REPO_ID

Tham số:

• REPO_ID: ID của kho (ví dụ username/repo-name hoặc spaces/username/repo-name). [bắt buộc]

Tùy chọn:

• --title TEXT: Tiêu đề của cuộc thảo luận hoặc pull request. [bắt buộc]
• --body TEXT: Mô tả (hỗ trợ Markdown).
• --body-file PATH: Đọc mô tả từ một tệp. Sử dụng ’-’ cho stdin.
• --pull-request, --pr: Tạo một pull request thay vì một discussion.
• --attach TEXT: Nối tệp hình ảnh, video hoặc âm thanh, dưới dạng ‘FILE’ hoặc ‘FILE#alt text’. Tham chiếu ‘’ trong nội dung sẽ được thay thế bằng tệp đã tải lên, các tệp khác sẽ được thêm vào. Có thể sử dụng nhiều lần.
• --type, --repo-type [model|dataset|space|kernel]: Kiểu kho (model, dataset, space hoặc kernel). [mặc định: model]
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf discussions create username/my-model —title “Bug report” $ hf discussions create username/my-model —title “Feature request” —body “Please add X” $ hf discussions create username/my-model —title “Fix typo” —pull-request $ hf discussions create username/my-dataset —type dataset —title “Data quality issue” $ hf discussions create username/my-model —title “Fix rendering” —pr —attach “./before.png#Before the fix” —attach ./after.png

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf discussions diff

Hiển thị diff của một pull request.

Cách sử dụng:

$ hf discussions diff [OPTIONS] REPO_ID NUM

Tham số:

• REPO_ID: ID của kho (ví dụ username/repo-name hoặc spaces/username/repo-name). [bắt buộc]
• NUM: Số của cuộc thảo luận hoặc pull request. [bắt buộc]

Tùy chọn:

• --type, --repo-type [model|dataset|space|kernel]: Kiểu kho (model, dataset, space hoặc kernel). [mặc định: model]
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $c hf discussions diff username/my-model 5$

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf discussions edit

Chỉnh sửa một bình luận hiện có trên một cuộc thảo luận hoặc yêu cầu kéo (pull request).

Cách sử dụng:

$ hf discussions edit [OPTIONS] REPO_ID NUM COMMENT_ID

Tham số:

• REPO_ID: ID của kho (ví dụ username/repo-name hoặc spaces/username/repo-name). [bắt buộc]
• NUM: Số của cuộc thảo luận hoặc pull request. [bắt buộc]
• COMMENT_ID: ID của bình luận cần chỉnh sửa (xem ‘hf discussions info … —format json’). [bắt buộc]

Tùy chọn:

• --body TEXT: Nội dung bình luận mới (hỗ trợ Markdown).
• --body-file PATH: Đọc bình luận mới từ một tệp. Sử dụng ’-’ cho stdin.
• --attach TEXT: Nối tệp hình ảnh, video hoặc âm thanh, dưới dạng ‘FILE’ hoặc ‘FILE#alt text’. Tham chiếu ‘’ trong nội dung sẽ được thay thế bằng tệp đã tải lên, các tệp khác sẽ được thêm vào. Có thể sử dụng nhiều lần.
• --type, --repo-type [model|dataset|space|kernel]: Kiểu kho (model, dataset, space hoặc kernel). [mặc định: model]
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf discussions edit username/my-model 5 abc123 —body “Updated comment.” $ hf discussions edit username/my-model 5 abc123 —body-file fixed.md $ hf discussions edit username/my-model 5 abc123 —body “Fixed: ” —attach ./after.png

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf discussions info

Lấy thông tin về một cuộc thảo luận hoặc yêu cầu kéo (pull request).

Cách sử dụng:

$ hf discussions info [OPTIONS] REPO_ID NUM

Tham số:

• REPO_ID: ID của kho (ví dụ username/repo-name hoặc spaces/username/repo-name). [bắt buộc]
• NUM: Số của cuộc thảo luận hoặc pull request. [bắt buộc]

Tùy chọn:

• --type, --repo-type [model|dataset|space|kernel]: Kiểu kho (model, dataset, space hoặc kernel). [mặc định: model]
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf discussions info username/my-model 5 $ hf discussions info username/my-model 5 —format json

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf discussions list

Liệt kê các cuộc thảo luận và pull request trên một repo. [alias: ls]

Cách sử dụng:

$ hf discussions list [OPTIONS] REPO_ID

Tham số:

• REPO_ID: ID của kho (ví dụ username/repo-name hoặc spaces/username/repo-name). [bắt buộc]

Tùy chọn:

• -s, --status [open|closed|merged|draft|all]: Lọc theo trạng thái (open, closed, merged, draft, all). [mặc định: open]
• -k, --kind [all|discussion|pull_request]: Lọc theo loại (discussion, pull_request, all). [mặc định: all]
• --author TEXT: Lọc theo tác giả hoặc tổ chức.
• --limit INTEGER: Giới hạn số lượng kết quả. [mặc định: 30]
• --type, --repo-type [model|dataset|space|kernel]: Kiểu kho (model, dataset, space hoặc kernel). [mặc định: model]
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf discussions list username/my-model $ hf discussions list username/my-model —kind pull_request —status merged $ hf discussions list username/my-dataset —type dataset —status closed $ hf discussions list username/my-model —author alice —format json

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf discussions merge

Gộp một pull request.

Cách sử dụng:

$ hf discussions merge [OPTIONS] REPO_ID NUM

Tham số:

• REPO_ID: ID của kho (ví dụ username/repo-name hoặc spaces/username/repo-name). [bắt buộc]
• NUM: Số của cuộc thảo luận hoặc pull request. [bắt buộc]

Tùy chọn:

• --comment TEXT: Một bình luận tùy chọn để đăng khi hợp nhất.
• -y, --yes: Bỏ qua lời nhắc xác nhận.
• --type, --repo-type [model|dataset|space|kernel]: Kiểu kho (model, dataset, space hoặc kernel). [mặc định: model]
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf discussions merge username/my-model 5 $ hf discussions merge username/my-model 5 —comment “Merging, thanks!”

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf discussions đổi tên

Đổi tên một cuộc thảo luận hoặc pull request.

Cách sử dụng:

$ hf discussions rename [OPTIONS] REPO_ID NUM NEW_TITLE

Tham số:

• REPO_ID: ID của kho (ví dụ username/repo-name hoặc spaces/username/repo-name). [bắt buộc]
• NUM: Số của cuộc thảo luận hoặc pull request. [bắt buộc]
• NEW_TITLE: Tiêu đề mới. [bắt buộc]

Tùy chọn:

• --type, --repo-type [model|dataset|space|kernel]: Kiểu kho (model, dataset, space hoặc kernel). [mặc định: model]
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf discussions rename username/my-model 5 “Updated title”

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf discussions mở lại

Mở lại một cuộc thảo luận hoặc pull request đã đóng.

Cách sử dụng:

$ hf discussions reopen [OPTIONS] REPO_ID NUM

Tham số:

• REPO_ID: ID của kho (ví dụ username/repo-name hoặc spaces/username/repo-name). [bắt buộc]
• NUM: Số của cuộc thảo luận hoặc pull request. [bắt buộc]

Tùy chọn:

• --comment TEXT: Một bình luận tùy chọn để đăng khi mở lại.
• -y, --yes: Bỏ qua lời nhắc xác nhận.
• --type, --repo-type [model|dataset|space|kernel]: Kiểu kho (model, dataset, space hoặc kernel). [mặc định: model]
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf discussions reopen username/my-model 5 $ hf discussions reopen username/my-model 5 —comment “Mở lại để điều tra thêm.”

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf download

Tải tệp từ Hub.

Cách sử dụng:

$ hf download [OPTIONS] REPO_ID [FILENAMES]...

Tham số:

• REPO_ID: ID của kho (ví dụ username/repo-name hoặc spaces/username/repo-name). [bắt buộc]
• [FILENAMES]...: Các tệp cần tải xuống (ví dụ: config.json, data/metadata.jsonl).

Tùy chọn:

• --type, --repo-type [model|dataset|space|kernel]: Kiểu kho (model, dataset, space hoặc kernel). [mặc định: (model)]
• --revision TEXT: id của bản sửa đổi Git, có thể là tên nhánh, thẻ hoặc mã băm của commit.
• --include TEXT: Các mẫu Glob để bao gồm từ các tệp cần tải xuống. Ví dụ: *.json
• --exclude TEXT: Các mẫu Glob để loại trừ khỏi các tệp cần tải xuống.
• --cache-dir TEXT: Thư mục để lưu các tệp.
• --local-dir TEXT: Nếu được đặt, tệp đã tải xuống sẽ được đặt trong thư mục này. Xem https://huggingface.co/docs/huggingface_hub/guides/download#download-files-to-a-local-folder để biết thêm chi tiết.
• --force-download / --no-force-download: Nếu là True, các tệp sẽ được tải xuống ngay cả khi chúng đã được lưu trong bộ nhớ đệm. [mặc định: no-force-download]
• --dry-run / --no-dry-run: Nếu là True, thực hiện chạy thử mà không thực sự tải xuống tệp. [mặc định: no-dry-run]
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --max-workers INTEGER: Số lượng worker tối đa để sử dụng cho việc tải xuống các tệp. Mặc định là 8. [mặc định: 8]
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf download meta-llama/Llama-3.2-1B-Instruct $ hf download meta-llama/Llama-3.2-1B-Instruct config.json tokenizer.json $ hf download meta-llama/Llama-3.2-1B-Instruct —include ”.safetensors” —exclude ”.bin” $ hf download meta-llama/Llama-3.2-1B-Instruct —local-dir ./models/llama $ hf download HuggingFaceM4/FineVision art/ —repo-type dataset $ hf download hf://datasets/HuggingFaceH4/ultrachat_200k

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf endpoints

Quản lý Hugging Face Inference Endpoints.

Cách sử dụng:

$ hf endpoints [OPTIONS] COMMAND [ARGS]...

Tùy chọn:

• --help: Hiển thị thông báo này và thoát.

Lệnh:

• catalog: Tương tác với danh mục Inference Endpoints.
• delete: Xóa vĩnh viễn một Inference Endpoint.
• deploy: Triển khai một Inference Endpoint từ một kho Hub.
• describe: Lấy thông tin về một endpoint hiện có.
• hardware: Liệt kê phần cứng có sẵn để triển khai một Inference Endpoint.
• list: Liệt kê tất cả Inference Endpoints cho namespace được chỉ định. [alias: ls]
• list-catalog: Liệt kê các model có sẵn trong Model Catalog.
• pause: Tạm dừng một Inference Endpoint.
• resume: Tiếp tục một Inference Endpoint.
• scale-to-zero: Thu gọn một Inference Endpoint về không.
• update: Cập nhật một endpoint hiện có.

hf endpoints catalog

Tương tác với danh mục Inference Endpoints.

Cách sử dụng:

$ hf endpoints catalog [OPTIONS] COMMAND [ARGS]...

Tùy chọn:

• --help: Hiển thị thông báo này và thoát.

Lệnh:

• deploy: Triển khai Inference Endpoint từ Model Catalog.
• list: Liệt kê các model có sẵn trong Model Catalog. [alias: ls]

hf endpoints catalog deploy

Triển khai một Inference Endpoint từ Model Catalog.

Các model trong Catalog được triển khai thông qua một recipe: tổ hợp phần cứng và engine đã được kiểm thử cho chúng. Truyền —repo để triển khai recipe mặc định của một model, có thể thu hẹp thêm bằng —accelerator và —gguf-file, hoặc truyền —recipe để triển khai một recipe chính xác được liệt kê bởi hf endpoints catalog ls.

Cách sử dụng:

$ hf endpoints catalog deploy [OPTIONS]

Tùy chọn:

• --repo TEXT: Tên của kho mô hình liên quan đến Inference Endpoint (ví dụ: ‘openai/gpt-oss-120b’). Triển khai công thức mặc định của nó. Loại trừ lẫn nhau với —recipe.
• --recipe TEXT: id của công thức trong danh mục cần triển khai, như được liệt kê bởi ‘hf endpoints catalog ls’. Loại trừ lẫn nhau với —repo.
• --name TEXT: Tên endpoint.
• --accelerator [cpu|gpu|neuron]: Bộ tăng tốc phần cứng được sử dụng cho suy luận. Chỉ dùng với —repo.
• --gguf-file TEXT: Tệp GGUF cần triển khai, dành cho các mô hình có một công thức cho mỗi mức lượng tử hóa. Chỉ dùng với —repo.
• --namespace TEXT: Namespace liên quan đến Inference Endpoint. Mặc định là namespace của người dùng hiện tại.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf endpoints catalog deploy —repo meta-llama/Llama-3.2-1B-Instruct $ hf endpoints catalog deploy —recipe sizzling-biryani-g4xsi1ac

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf endpoints catalog list

Liệt kê các model có sẵn trong Model Catalog. [alias: ls]

Một dòng cho mỗi công thức, tức là cho mỗi cách triển khai mô hình đã được kiểm tra. Triển khai một công thức bằng hf endpoints catalog deploy --recipe <RECIPE_ID>.

Cách sử dụng:

$ hf endpoints catalog list [OPTIONS]

Tùy chọn:

• --accelerator [cpu|gpu|neuron]: Chỉ hiển thị các công thức chạy trên bộ tăng tốc này.
• --engine [llamacpp|sglang|tei|vllm]: Chỉ hiển thị các công thức chạy trên engine suy luận này.
• --license TEXT: Chỉ hiển thị các mô hình dưới giấy phép này (ví dụ: ‘Apache 2.0’).
• --task TEXT: Chỉ hiển thị các mô hình cho tác vụ này (ví dụ: ‘text-generation’).
• --search TEXT: Câu truy vấn tìm kiếm.
• --limit INTEGER: Giới hạn số lượng mô hình được trả về.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf endpoints catalog ls $ hf endpoints catalog ls —engine vllm

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf endpoints delete

Xóa vĩnh viễn một Inference Endpoint.

Cách sử dụng:

$ hf endpoints delete [OPTIONS] NAME

Tham số:

• NAME: Tên endpoint. [bắt buộc]

Tùy chọn:

• --namespace TEXT: Namespace liên quan đến Inference Endpoint. Mặc định là namespace của người dùng hiện tại.
• --yes: Bỏ qua các lời nhắc xác nhận.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf endpoints delete my-endpoint

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf endpoints deploy

Triển khai một Inference Endpoint từ một kho Hub.

Chạy hf endpoints hardware để liệt kê các tổ hợp hợp lệ của --vendor, --region, --accelerator, --instance-type và --instance-size.

Cách sử dụng:

$ hf endpoints deploy [OPTIONS] NAME

Tham số:

• NAME: Tên endpoint. [bắt buộc]

Tùy chọn:

• --repo TEXT: Tên của kho mô hình liên quan đến Inference Endpoint (ví dụ: ‘openai/gpt-oss-120b’). [bắt buộc]
• --framework TEXT: Khung machine learning được sử dụng cho mô hình (ví dụ: ‘vllm’). [bắt buộc]
• --accelerator TEXT: Bộ tăng tốc phần cứng được sử dụng cho suy luận (ví dụ: ‘cpu’). [bắt buộc]
• --instance-size TEXT: Kích thước hoặc loại instance được sử dụng để lưu trữ model (ví dụ: ‘x4’). [bắt buộc]
• --instance-type TEXT: Kiểu instance trên cloud nơi Inference Endpoint sẽ được triển khai (ví dụ: ‘intel-icl’). [bắt buộc]
• --region TEXT: Vùng cloud mà Inference Endpoint sẽ được tạo (ví dụ: ‘us-east-1’). [bắt buộc]
• --vendor TEXT: Nhà cung cấp đám mây hoặc nhà cung cấp nơi Inference Endpoint sẽ được lưu trữ (ví dụ: ‘aws’). [bắt buộc]
• --namespace TEXT: Namespace liên quan đến Inference Endpoint. Mặc định là namespace của người dùng hiện tại.
• --task TEXT: Nhiệm vụ để triển khai mô hình (ví dụ: ‘text-classification’).
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --min-replica INTEGER: Số lượng tối thiểu các bản sao (instance) cần duy trì chạy cho Inference Endpoint. [mặc định: 1]
• --max-replica INTEGER: Số lượng bản sao (instances) tối đa để mở rộng cho Inference Endpoint. [mặc định: 1]
• --scale-to-zero-timeout INTEGER: Thời lượng tính bằng phút trước khi một endpoint không hoạt động bị thu về mức không.
• --scaling-metric [pendingRequests|hardwareUsage]: Chỉ số tham chiếu để mở rộng.
• --scaling-threshold FLOAT: Ngưỡng của chỉ số scaling được sử dụng để kích hoạt việc tăng quy mô. Bỏ qua khi không cung cấp chỉ số scaling.
• --revision TEXT: id của bản sửa đổi Git, có thể là tên nhánh, thẻ hoặc mã băm của commit.
• --custom-image TEXT: URL của Docker image cho container để chạy (ví dụ: ‘nexagi/sglang:v0.5.12’). Yêu cầu ‘—framework custom’.
• --engine [custom|hf-serve|llamacpp|sglang|tei|tgi|tgi-neuron|vllm|vllm-neuron]: Ảnh engine được quản lý để chạy —custom-image với (ví dụ ‘vllm’). Mặc định là một container tùy ý.
• --health-route TEXT: Tuyến kiểm tra sức khỏe do container cung cấp (ví dụ: ‘/health’). Yêu cầu —custom-image.
• --port INTEGER: Cổng mà container lắng nghe (ví dụ: 30000). Yêu cầu —custom-image.
• --container-registry-username TEXT: Tên người dùng được sử dụng để xác thực với registry lưu trữ —custom-image.
• --container-registry-password TEXT: Mật khẩu tùy chọn được sử dụng để xác thực với registry lưu trữ —custom-image.
• --tensor-parallel-size INTEGER: Số lượng bộ tăng tốc để chia nhỏ một bản sao của mô hình (chỉ dành cho các engine vLLM và SGLang).
• --data-parallel-size INTEGER: Số bản sao mô hình cần chạy, mỗi bản trên một accelerator (chỉ dành cho engine vLLM).
• --container-command TEXT: Ghi đè entrypoint của container, dưới dạng chuỗi được đặt trong dấu nháy và tách thành các token (ví dụ: “python -m sglang.launch_server”).
• --container-args TEXT: Các đối số được thêm vào entrypoint của container, dưới dạng chuỗi có dấu nháy được tách thành các token (ví dụ: “—tp 8 —reasoning-parser qwen3”).
• -e, --env TEXT: Đặt các biến môi trường. Ví dụ —env ENV=value
• --env-file TEXT: Đọc một tệp chứa các biến môi trường. Sử dụng - để đọc chúng từ stdin.
• -s, --secrets TEXT: Đặt các biến môi trường bí mật. Nên dùng --secrets SECRET để đọc giá trị từ môi trường của bạn (ví dụ: --secrets HF_TOKEN để truyền token Hugging Face của bạn); --secrets SECRET=value sẽ lưu giá trị vào lịch sử shell của bạn.
• --secrets-file TEXT: Đọc một tệp chứa các biến môi trường bí mật. Sử dụng - để đọc chúng từ stdin.
• --type [public|authenticated|private]: Kiểu truy cập endpoint. Mặc định là ‘authenticated’ (được bảo vệ bằng token, có thể truy cập công khai).
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf endpoints deploy my-endpoint —repo gpt2 —framework pytorch … $ hf endpoints deploy my-endpoint —repo openai/gpt-oss-120b —framework custom —engine vllm —custom-image vllm/vllm-openai:v0.23.0 —tensor-parallel-size 8 …

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf endpoints describe

Lấy thông tin về một endpoint hiện có.

Cách sử dụng:

$ hf endpoints describe [OPTIONS] NAME

Tham số:

• NAME: Tên endpoint. [bắt buộc]

Tùy chọn:

• --namespace TEXT: Namespace liên quan đến Inference Endpoint. Mặc định là namespace của người dùng hiện tại.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf endpoints describe my-endpoint

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf endpoints hardware

Liệt kê phần cứng có sẵn để triển khai một Inference Endpoint.

Chỉ liệt kê phần cứng mà namespace có thể triển khai ngay bây giờ: trạng thái khả dụng và đủ hạn mức accelerator cho một replica. Sử dụng --all để liệt kê mọi tổ hợp mà API trả về.

Quota được tính theo từng namespace, vì vậy hãy truyền cùng một --namespace mà bạn sẽ truyền cho hf endpoints deploy. Giá được tính bằng USD, cho mỗi replica mỗi giờ.

Cách sử dụng:

$ hf endpoints hardware [OPTIONS]

Tùy chọn:

• --namespace TEXT: Namespace liên quan đến Inference Endpoint. Mặc định là namespace của người dùng hiện tại.
• --vendor TEXT: Chỉ hiển thị phần cứng do nhà cung cấp đám mây này lưu trữ (ví dụ: ‘aws’).
• --region TEXT: Chỉ hiển thị phần cứng có sẵn trong khu vực đám mây này (ví dụ: ‘us-east-1’).
• --accelerator TEXT: Chỉ hiển thị phần cứng có bộ tăng tốc này (ví dụ: ‘cpu’, ‘gpu’, ‘neuron’).
• --instance-type TEXT: Chỉ hiển thị phần cứng của loại instance này (ví dụ: ‘nvidia-l4’).
• -a, --all: Cũng hiển thị phần cứng không thể triển khai ngay bây giờ (không khả dụng, đã ngừng hỗ trợ hoặc vượt hạn mức).
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf endpoints hardware $ hf endpoints hardware —vendor aws —accelerator gpu

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf endpoints list

Liệt kê tất cả các Inference Endpoints cho namespace được chỉ định. [alias: ls]

Cách sử dụng:

$ hf endpoints list [OPTIONS]

Tùy chọn:

• --namespace TEXT: Namespace liên quan đến Inference Endpoint. Mặc định là namespace của người dùng hiện tại.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf endpoints ls $ hf endpoints ls —namespace my-org

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf endpoints list-catalog

Liệt kê các mô hình có sẵn trong Model Catalog.

Một dòng cho mỗi công thức, tức là cho mỗi cách triển khai mô hình đã được kiểm tra. Triển khai một công thức bằng hf endpoints catalog deploy --recipe <RECIPE_ID>.

Cách sử dụng:

$ hf endpoints list-catalog [OPTIONS]

Tùy chọn:

• --accelerator [cpu|gpu|neuron]: Chỉ hiển thị các công thức chạy trên bộ tăng tốc này.
• --engine [llamacpp|sglang|tei|vllm]: Chỉ hiển thị các công thức chạy trên engine suy luận này.
• --license TEXT: Chỉ hiển thị các mô hình dưới giấy phép này (ví dụ: ‘Apache 2.0’).
• --task TEXT: Chỉ hiển thị các mô hình cho tác vụ này (ví dụ: ‘text-generation’).
• --search TEXT: Câu truy vấn tìm kiếm.
• --limit INTEGER: Giới hạn số lượng mô hình được trả về.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

hf endpoints pause

Tạm dừng một Inference Endpoint.

Cách sử dụng:

$ hf endpoints pause [OPTIONS] NAME

Tham số:

• NAME: Tên endpoint. [bắt buộc]

Tùy chọn:

• --namespace TEXT: Namespace liên quan đến Inference Endpoint. Mặc định là namespace của người dùng hiện tại.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf endpoints pause my-endpoint

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf endpoints resume

Tiếp tục một Inference Endpoint.

Cách sử dụng:

$ hf endpoints resume [OPTIONS] NAME

Tham số:

• NAME: Tên endpoint. [bắt buộc]

Tùy chọn:

• --namespace TEXT: Namespace liên quan đến Inference Endpoint. Mặc định là namespace của người dùng hiện tại.
• --fail-if-already-running: Nếu True, phương thức sẽ gây ra lỗi nếu Inference Endpoint đã đang chạy.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $c hf endpoints resume my-endpoint$

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf endpoints scale-to-zero

Thang đo một Inference Endpoint về không.

Cách sử dụng:

$ hf endpoints scale-to-zero [OPTIONS] NAME

Tham số:

• NAME: Tên endpoint. [bắt buộc]

Tùy chọn:

• --namespace TEXT: Namespace liên quan đến Inference Endpoint. Mặc định là namespace của người dùng hiện tại.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf endpoints scale-to-zero my-endpoint

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf endpoints update

Cập nhật một endpoint hiện có.

Cách sử dụng:

$ hf endpoints update [OPTIONS] NAME

Tham số:

• NAME: Tên endpoint. [bắt buộc]

Tùy chọn:

• --namespace TEXT: Namespace liên quan đến Inference Endpoint. Mặc định là namespace của người dùng hiện tại.
• --repo TEXT: Tên của kho mô hình liên quan đến Inference Endpoint (ví dụ: ‘openai/gpt-oss-120b’).
• --accelerator TEXT: Bộ tăng tốc phần cứng được sử dụng cho suy luận (ví dụ: ‘cpu’).
• --instance-size TEXT: Kích thước hoặc loại instance được sử dụng để lưu trữ model (ví dụ: ‘x4’).
• --instance-type TEXT: Kiểu instance trên cloud mà Inference Endpoint sẽ được triển khai (ví dụ: ‘intel-icl’).
• --framework TEXT: Khung machine learning được sử dụng cho mô hình (ví dụ: ‘custom’).
• --revision TEXT: Phiên bản mô hình cụ thể để triển khai trên Inference Endpoint (ví dụ: ‘6c0e6080953db56375760c0471a8c5f2929baf11’).
• --task TEXT: Nhiệm vụ để triển khai mô hình (ví dụ: ‘text-classification’).
• --custom-image TEXT: URL của Docker image cho container cần chạy (ví dụ: ‘nexagi/sglang:v0.5.12’). Thay thế image đang được cấu hình trên endpoint thay vì vá (patch) nó, vì vậy hãy truyền kèm theo các cài đặt engine và container mà bạn muốn giữ lại, và chạy ‘hf endpoints describe NAME’ trước để xem chúng.
• --engine [custom|hf-serve|llamacpp|sglang|tei|tgi|tgi-neuron|vllm|vllm-neuron]: Ảnh engine được quản lý để chạy —custom-image với (ví dụ ‘vllm’). Mặc định là một container tùy ý.
• --health-route TEXT: Tuyến kiểm tra sức khỏe do container cung cấp (ví dụ: ‘/health’). Yêu cầu —custom-image.
• --port INTEGER: Cổng mà container lắng nghe (ví dụ: 30000). Yêu cầu —custom-image.
• --tensor-parallel-size INTEGER: Số lượng bộ tăng tốc để chia nhỏ một bản sao của mô hình (chỉ dành cho các engine vLLM và SGLang).
• --data-parallel-size INTEGER: Số bản sao mô hình cần chạy, mỗi bản trên một accelerator (chỉ dành cho engine vLLM).
• --container-command TEXT: Ghi đè entrypoint của container, dưới dạng chuỗi được đặt trong dấu nháy và tách thành các token (ví dụ: “python -m sglang.launch_server”). Thay thế giá trị hiện tại; truyền chuỗi rỗng để xóa nó.
• --container-args TEXT: Các đối số được thêm vào entrypoint của container, dưới dạng chuỗi có dấu nháy được tách thành các token (ví dụ: “—enable-auto-tool-choice —tool-call-parser lfm2”). Thay thế các đối số hiện đang được đặt trên endpoint thay vì thêm vào chúng, vì vậy hãy bao gồm các đối số bạn muốn giữ lại, chạy ‘hf endpoints describe NAME’ trước để xem chúng. Truyền một chuỗi rỗng để xóa chúng.
• --min-replica INTEGER: Số lượng tối thiểu các bản sao (instance) cần duy trì chạy cho Inference Endpoint.
• --max-replica INTEGER: Số lượng bản sao (instances) tối đa để mở rộng cho Inference Endpoint.
• --scale-to-zero-timeout INTEGER: Thời lượng tính bằng phút trước khi một endpoint không hoạt động bị thu về mức không.
• --scaling-metric [pendingRequests|hardwareUsage]: Chỉ số tham chiếu để mở rộng.
• --scaling-threshold FLOAT: Ngưỡng của chỉ số scaling được sử dụng để kích hoạt việc tăng quy mô. Bỏ qua khi không cung cấp chỉ số scaling.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf endpoints update my-endpoint —min-replica 2 $ hf endpoints update my-endpoint —tensor-parallel-size 8 $ hf endpoints update my-endpoint —container-args “—enable-auto-tool-choice —tool-call-parser lfm2”

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf env

In thông tin về môi trường.

Cách sử dụng:

$ hf env [OPTIONS]

Tùy chọn:

• --help: Hiển thị thông báo này và thoát.

hf extensions

Quản lý các phần mở rộng của CLI hf. [alias: ext]

Cảnh báo bảo mật: các phần mở rộng là các tệp thực thi hoặc gói Python của bên thứ ba. Chỉ cài đặt từ các nguồn mà bạn tin tưởng.

Cách sử dụng:

$ hf extensions [OPTIONS] COMMAND [ARGS]...

Tùy chọn:

• --help: Hiển thị thông báo này và thoát.

Lệnh:

• exec: Thực thi một phần mở rộng đã được cài đặt.
• install: Cài đặt một phần mở rộng từ kho GitHub công khai.
• list: Liệt kê các lệnh mở rộng đã cài đặt. [alias: ls]
• remove: Gỡ bỏ một tiện ích mở rộng đã cài đặt. [alias: rm]
• search: Tìm kiếm các extension có sẵn trên GitHub (được gắn thẻ ‘hf-extension’).
• update: Cập nhật phần mở rộng đã cài đặt lên phiên bản mới nhất.

hf extensions exec

Chạy một phần mở rộng đã cài đặt.

Cách sử dụng:

$ hf extensions exec [OPTIONS] NAME

Tham số:

• NAME: Tên phần mở rộng (có hoặc không có tiền tố hf-). [bắt buộc]

Tùy chọn:

• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf extensions exec claude — —help $ hf extensions exec claude —model zai-org/GLM-5

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf extensions install

Cài đặt một tiện ích mở rộng từ kho GitHub công khai.

Cảnh báo bảo mật: thao tác này sẽ cài đặt một tệp thực thi hoặc gói Python của bên thứ ba. Chỉ cài đặt từ các nguồn mà bạn tin tưởng.

Cách sử dụng:

$ hf extensions install [OPTIONS] REPO_ID

Tham số:

• REPO_ID: kho mở rộng GitHub ở định dạng [OWNER/]hf-<name>. [bắt buộc]

Tùy chọn:

• --force: Ghi đè nếu đã được cài đặt.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf extensions install hf-claude $ hf extensions install hanouticelina/hf-claude $ hf extensions install alvarobartt/hf-mem

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf extensions list

Liệt kê các lệnh extension đã cài đặt. [alias: ls]

Cách sử dụng:

$ hf extensions list [OPTIONS]

Tùy chọn:

• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf extensions list

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf extensions remove

Gỡ bỏ một tiện ích mở rộng đã cài đặt. [alias: rm]

Cách sử dụng:

$ hf extensions remove [OPTIONS] NAME

Tham số:

• NAME: Tên phần mở rộng cần xóa (có hoặc không có tiền tố hf-). [bắt buộc]

Tùy chọn:

• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf extensions remove claude

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf extensions search

Tìm kiếm các extension có sẵn trên GitHub (được gắn thẻ với chủ đề ‘hf-extension’).

Cách sử dụng:

$ hf extensions search [OPTIONS]

Tùy chọn:

• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf extensions search

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf extensions update

Cập nhật các extension đã cài đặt lên phiên bản mới nhất.

Cách sử dụng:

$ hf extensions update [OPTIONS] [NAME]

Tham số:

• [NAME]: Phần mở rộng cần cập nhật (có hoặc không có tiền tố hf-, tùy chọn dưới dạng OWNER/hf-<name>). Nếu bỏ trống, tất cả các phần mở rộng đã cài đặt sẽ được kiểm tra và những phần mở rộng cũ sẽ được cập nhật.

Tùy chọn:

• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf extensions update $ hf extensions update hf-claude $ hf extensions update alvarobartt/hf-mem

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf jobs

Chạy và quản lý các Job trên Hub.

Cách sử dụng:

$ hf jobs [OPTIONS] COMMAND [ARGS]...

Tùy chọn:

• --help: Hiển thị thông báo này và thoát.

Lệnh:

• cancel: Hủy một Job
• expose: Thay thế các cổng đã được phơi bày trên một Job đang chạy.
• hardware: Liệt kê các tùy chọn phần cứng khả dụng cho Jobs
• inspect: Hiển thị thông tin chi tiết về một hoặc nhiều Job
• labels: Cập nhật nhãn trên một Job.
• list: Liệt kê các công việc. [biệt danh: ls, ps]
• logs: Lấy nhật ký của một Job.
• rerun: Chạy một Job mới với spec của một Job hiện có.
• run: Chạy một Job.
• scheduled: Tạo và quản lý các Job được lên lịch trên Hub.
• ssh: Kết nối SSH vào một Job đang chạy.
• stats: Lấy thống kê và chỉ số về mức sử dụng tài nguyên của các Job.
• uv: Chạy các script UV (Python với các phụ thuộc inline) trên hạ tầng HF.
• wait: Chờ một hoặc nhiều Job đạt đến trạng thái cuối.

hf jobs cancel

Hủy một Job

Cách sử dụng:

$ hf jobs cancel [OPTIONS] JOB_ID

Tham số:

• JOB_ID: ID của tác vụ (hoặc ‘namespace/job_id’) [bắt buộc]

Tùy chọn:

• --namespace TEXT: Namespace nơi công việc sẽ được thực thi. Mặc định là namespace của người dùng hiện tại.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf jobs cancel <job_id>

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf jobs expose

Thay thế các cổng đã được công bố trên một Job đang chạy.

Cách sử dụng:

$ hf jobs expose [OPTIONS] JOB_ID [PORTS]...

Tham số:

• JOB_ID: ID của tác vụ (hoặc ‘namespace/job_id’) [bắt buộc]
• [PORTS]...: Các cổng cần phơi bày thông qua jobs proxy. Việc truy cập yêu cầu một HF token có quyền đọc đối với namespace của job.

Tùy chọn:

• --public INTEGER: Mở một cổng mà không cần xác thực. Lặp lại cờ này cho nhiều cổng. Không cần truyền thêm cổng như một đối số vị trí.
• --clear: Đóng tất cả các cổng đang mở.
• --namespace TEXT: Namespace nơi công việc sẽ được thực thi. Mặc định là namespace của người dùng hiện tại.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf jobs expose <job_id> 8000 $ hf jobs expose <job_id> 8000 —public 9000 $ hf jobs expose <job_id> —clear

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf jobs hardware

Liệt kê các tùy chọn phần cứng khả dụng cho Jobs

Cách sử dụng:

$ hf jobs hardware [OPTIONS]

Tùy chọn:

• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf jobs hardware

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf jobs inspect

Hiển thị thông tin chi tiết về một hoặc nhiều Job

Cách sử dụng:

$ hf jobs inspect [OPTIONS] JOB_IDS...

Tham số:

• JOB_IDS...: Các ID công việc cần kiểm tra (hoặc ‘namespace/job_id’) [bắt buộc]

Tùy chọn:

• --namespace TEXT: Namespace nơi công việc sẽ được thực thi. Mặc định là namespace của người dùng hiện tại.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf jobs inspect <job_id>

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf jobs labels

Cập nhật nhãn trên một Job. Truyền —label sẽ thay thế tất cả các nhãn hiện có; chỉ truyền —name sẽ giữ nguyên chúng.

Cách sử dụng:

$ hf jobs labels [OPTIONS] JOB_ID

Tham số:

• JOB_ID: ID của tác vụ (hoặc ‘namespace/job_id’) [bắt buộc]

Tùy chọn:

• --name TEXT: Đặt tên cho Job. Được lưu dưới dạng nhãn name. Tên không nhất thiết phải duy nhất. Mặc định là tên image hoặc script kèm theo một hash ngắn của cấu hình khởi chạy đã được phân giải.
• -l, --label TEXT: Đặt nhãn. Ví dụ —label KEY=VALUE hoặc —label LABEL
• --clear: Xóa tất cả nhãn khỏi công việc.
• --namespace TEXT: Namespace nơi công việc sẽ được thực thi. Mặc định là namespace của người dùng hiện tại.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf jobs labels <job_id> —name training-v2 $ hf jobs labels <job_id> —label env=prod —label team=ml $ hf jobs labels <job_id> —clear

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf jobs list | ls | ps

Liệt kê các công việc.

Sử dụng --status để lọc theo trạng thái (xem JobStage để biết các giá trị có thể) và --label để lọc theo nhãn key=value. Một Job phải khớp với mọi bộ lọc để được liệt kê.

Cách sử dụng:

$ hf jobs list | ls | ps [OPTIONS]

Tùy chọn:

• -a, --all: Hiển thị tất cả các Job (mặc định chỉ hiển thị các Job đang chạy và đang được lên lịch). Không thể kết hợp với —status.
• --status [COMPLETED|CANCELED|ERROR|DELETED|SCHEDULING|RUNNING]: Chỉ hiển thị các Job có trạng thái được chỉ định. Tách bằng dấu phẩy hoặc lặp lại, ví dụ --status running,scheduling.
• -l, --label TEXT: Chỉ hiển thị các Job có nhãn key=value được chỉ định. Lặp lại để yêu cầu nhiều nhãn, ví dụ: --label env=prod --label team=ml.
• --name TEXT: Chỉ hiển thị các Job có tên được chỉ định (lối tắt cho --label name=NAME).
• --limit INTEGER: Số lượng tối đa các Job cần hiển thị. Đặt thành 0 để hiển thị tất cả (không giới hạn). [mặc định: 100]
• --namespace TEXT: Namespace nơi công việc sẽ được thực thi. Mặc định là namespace của người dùng hiện tại.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf jobs ls $ hf jobs ls -a $ hf jobs ls —status running,scheduling $ hf jobs ls —name training-v2 $ hf jobs ls —label env=prod —label team=ml $ hf jobs ls —all —label hf-sandbox=1

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf jobs logs

Lấy nhật ký của một Job.

Mặc định, in ra các nhật ký hiện có và thoát (không chặn). Sử dụng —follow/-f để phát trực tiếp nhật ký theo thời gian thực cho đến khi việc hoàn thành. Sử dụng —tail/-n để giới hạn số dòng được trả về (phía máy chủ khi được hỗ trợ).

Lưu ý: lệnh sau sẽ thoát khi luồng nhật ký kết thúc, bất kể Job thành công hay thất bại. Chạy hf jobs inspect <job_id> để kiểm tra trạng thái cuối cùng.

Cách sử dụng:

$ hf jobs logs [OPTIONS] JOB_ID

Tham số:

• JOB_ID: ID của tác vụ (hoặc ‘namespace/job_id’) [bắt buộc]

Tùy chọn:

• -f, --follow: Theo dõi đầu ra của log (dòng chảy cho đến khi việc hoàn thành). Nếu không có cờ này, chỉ các log hiện có sẽ được in ra.
• -n, --tail INTEGER: Số dòng cần hiển thị từ cuối nhật ký. Khi kết hợp với —follow, bắt đầu phát trực tiếp từ N dòng cuối.
• --namespace TEXT: Namespace nơi công việc sẽ được thực thi. Mặc định là namespace của người dùng hiện tại.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf jobs logs <job_id> $ hf jobs logs -f <job_id> $ hf jobs logs —tail 20 <job_id> $ hf jobs logs -f —tail 100 <job_id>

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf jobs rerun

Chạy một Job mới với spec của một Job hiện có.

Cách sử dụng:

$ hf jobs rerun [OPTIONS] JOB_ID

Tham số:

• JOB_ID: ID của tác vụ (hoặc ‘namespace/job_id’) [bắt buộc]

Tùy chọn:

• -d, --detach: Chạy Job ở chế độ nền và in ra Job ID.
• --namespace TEXT: Namespace nơi công việc sẽ được thực thi. Mặc định là namespace của người dùng hiện tại.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf jobs rerun <job_id> $ hf jobs rerun —detach <job_id>

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf jobs run

Chạy một Job.

Cách sử dụng:

$ hf jobs run [OPTIONS] IMAGE COMMAND...

Tham số:

• IMAGE: Ảnh Docker cần sử dụng. [bắt buộc]
• COMMAND...: Lệnh cần chạy. [bắt buộc]

Tùy chọn:

• -e, --env TEXT: Đặt các biến môi trường. Ví dụ —env ENV=value
• -s, --secrets TEXT: Đặt các biến môi trường bí mật. Nên dùng --secrets SECRET để đọc giá trị từ môi trường của bạn (ví dụ: --secrets HF_TOKEN để truyền token Hugging Face của bạn); --secrets SECRET=value sẽ lưu giá trị vào lịch sử shell của bạn.
• --name TEXT: Đặt tên cho Job. Được lưu dưới dạng nhãn name. Tên không nhất thiết phải duy nhất. Mặc định là tên image hoặc script kèm theo một hash ngắn của cấu hình khởi chạy đã được phân giải.
• -l, --label TEXT: Đặt nhãn. Ví dụ —label KEY=VALUE hoặc —label LABEL
• -v, --volume TEXT: Gắn một hoặc nhiều volume. Định dạng: hf://[TYPE/]SOURCE:/MOUNT_PATH[:ro|:rw] hoặc LOCAL_DIR:/MOUNT_PATH[:ro|:rw]. TYPE là một trong các giá trị: models, datasets, spaces, buckets. Nếu bỏ qua, TYPE mặc định là models. models, datasets và spaces luôn được gắn ở chế độ chỉ đọc. buckets mặc định ở chế độ đọc+ghi. Nguồn là thư mục cục bộ sẽ được đồng bộ hóa trước tiên vào một bucket và mặc định được gắn ở chế độ chỉ đọc. Ví dụ: -v hf://datasets/org/ds:/data hoặc -v hf://buckets/org/b:/mnt:ro hoặc -v ./inputs:/inputs
• --env-file TEXT: Đọc một tệp chứa các biến môi trường. Sử dụng - để đọc chúng từ stdin.
• --secrets-file TEXT: Đọc một tệp chứa các biến môi trường bí mật. Sử dụng - để đọc chúng từ stdin.
• --flavor [cpu-basic|cpu-upgrade|cpu-performance|cpu-xl|t4-small|t4-medium|l4x1|l4x4|l40sx1|l40sx4|l40sx8|a10g-small|a10g-large|a10g-largex2|a10g-largex4|a100-large|a100x4|a100x8|h200|h200x2|h200x4|h200x8|rtx-pro-6000|rtx-pro-6000x2|rtx-pro-6000x4|rtx-pro-6000x8]: Flavor cho phần cứng. Chạy ‘hf jobs hardware’ để liệt kê các flavor khả dụng. Mặc định là cpu-basic.
• --timeout TEXT: Thời lượng tối đa: int với s (giây, mặc định), m (phút), h (giờ) hoặc d (ngày).
• --attempts INTEGER RANGE: Số lần thử tối đa, bao gồm lần chạy đầu tiên. Mặc định là 1. [x>=1]
• -d, --detach: Chạy Job ở chế độ nền và in ra Job ID.
• --dry-run: In cấu hình Job đã được phân giải mà không gửi Job.
• --expose INTEGER: Mở một cổng container thông qua jobs proxy. Lặp lại cờ này cho nhiều cổng (ví dụ: --expose 8000 --expose 8001). Mỗi cổng được mở sẽ có thể truy cập trên tên miền jobs công khai; việc truy cập yêu cầu một HF token có quyền đọc trong namespace của job.
• --expose-public INTEGER: Mở một cổng của container thông qua jobs proxy mà không cần xác thực. Lặp lại cờ này cho nhiều cổng. Không cần truyền thêm cổng với --expose.
• --ssh: Cho phép truy cập vào container của job qua SSH. Kết nối bằng hf jobs ssh <job_id>. Yêu cầu có khóa công khai SSH đã được đăng ký tại https://huggingface.co/settings/keys.
• --network-group TEXT: Tham gia một nhóm mạng. Các tác vụ trong cùng namespace và resource group chia sẻ một nhóm sẽ được đặt cùng nhau và có thể liên lạc với nhau trên mọi cổng. Bên trong mỗi thành viên, $HF_NETWORK_GROUP_HOSTNAME sẽ phân giải đến mọi thành viên. Chỉ gồm chữ cái thường, chữ số và dấu gạch ngang, tối đa 46 ký tự.
• --network-alias TEXT: Đăng ký một alias trong nhóm mạng. Các thành viên truy cập các job đã đăng ký alias đó tại ${HF_NETWORK_GROUP_PREFIX}<alias>. Lặp lại cờ này cho nhiều alias. Chỉ gồm chữ cái thường, chữ số và dấu gạch nối, tối đa 34 ký tự, duy nhất trong job. Yêu cầu --network-group.
• --resource-group-id TEXT: ID của nhóm tài nguyên để tạo Job. Được sử dụng để kiểm soát quyền truy cập vào các tài nguyên trong tổ chức và cho các tính năng gán chi phí/giới hạn chi tiêu.
• --namespace TEXT: Namespace nơi công việc sẽ được thực thi. Mặc định là namespace của người dùng hiện tại.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --format [agent|auto|human|json|quiet]: Định dạng đầu ra. Mặc định là ‘auto’, tự động chọn ‘agent’ hoặc ‘human’ dựa trên terminal.
• --json: Đầu ra JSON. Tương đương với ‘—format json’.
• -q, --quiet: Đầu ra ở chế độ im lặng (một ID trên mỗi dòng). Tương đương với ‘—format quiet’.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf jobs run —name hello-world python:3.12 python -c ‘print(“Hello!”)’ $ hf jobs run —detach python:3.12 python script.py $ hf jobs run -e FOO=foo python:3.12 python script.py $ hf jobs run —secrets HF_TOKEN python:3.12 python script.py $ hf jobs run -v hf://org/my-model:/data -v hf://buckets/org/b:/mnt python:3.12 python script.py

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf jobs scheduled

Tạo và quản lý các Job được lên lịch trên Hub.

Cách sử dụng:

$ hf jobs scheduled [OPTIONS] COMMAND [ARGS]...

Tùy chọn:

• --help: Hiển thị thông báo này và thoát.

Lệnh:

• delete: Xóa một Job đã lên lịch.
• inspect: Hiển thị thông tin chi tiết về một hoặc nhiều Job đã được lên lịch
• labels: Cập nhật nhãn trên một Job được lên lịch.
• list: Liệt kê các Job đã lên lịch. [alias: ls, ps]
• reschedule: Thay đổi thời điểm chạy của một Job đã được lên lịch.
• resume: Tiếp tục (hủy tạm dừng) một Job đã lên lịch.
• run: Lên lịch một Job.
• suspend: Tạm dừng (đóng băng) một Job đã lên lịch.
• trigger: Kích hoạt một Job được lên lịch để chạy ngay lập tức (không thay đổi lịch trình).
• uv: Lên lịch các script UV trên hạ tầng HF.

hf jobs scheduled delete

Xóa một Job đã lên lịch.

Cách sử dụng:

$ hf jobs scheduled delete [OPTIONS] SCHEDULED_JOB_ID

Tham số:

• SCHEDULED_JOB_ID: ID của Job được lên lịch (hoặc ‘namespace/scheduled_job_id’) [bắt buộc]

Tùy chọn:

• --namespace TEXT: Namespace nơi công việc sẽ được thực thi. Mặc định là namespace của người dùng hiện tại.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf jobs scheduled delete <id>

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf jobs scheduled inspect

Hiển thị thông tin chi tiết về một hoặc nhiều Job đã lên lịch

Cách sử dụng:

$ hf jobs scheduled inspect [OPTIONS] SCHEDULED_JOB_IDS...

Tham số:

• SCHEDULED_JOB_IDS...: Các ID Job được lên lịch cần kiểm tra (hoặc ‘namespace/scheduled_job_id’) [bắt buộc]

Tùy chọn:

• --namespace TEXT: Namespace nơi công việc sẽ được thực thi. Mặc định là namespace của người dùng hiện tại.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf jobs scheduled inspect <id>

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf jobs scheduled labels

Cập nhật nhãn trên một Job được lên lịch. Truyền —label sẽ thay thế tất cả các nhãn hiện có; chỉ truyền —name sẽ giữ nguyên chúng.

Cách sử dụng:

$ hf jobs scheduled labels [OPTIONS] SCHEDULED_JOB_ID

Tham số:

• SCHEDULED_JOB_ID: ID của Job được lên lịch (hoặc ‘namespace/scheduled_job_id’) [bắt buộc]

Tùy chọn:

• --name TEXT: Đặt tên cho Job. Được lưu dưới dạng nhãn name. Tên không nhất thiết phải duy nhất. Mặc định là tên image hoặc script kèm theo một hash ngắn của cấu hình khởi chạy đã được phân giải.
• -l, --label TEXT: Đặt nhãn. Ví dụ —label KEY=VALUE hoặc —label LABEL
• --clear: Xóa tất cả nhãn khỏi công việc đã lên lịch.
• --namespace TEXT: Namespace nơi công việc sẽ được thực thi. Mặc định là namespace của người dùng hiện tại.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf jobs scheduled labels <id> —name daily-script $ hf jobs scheduled labels <id> —label env=prod —label team=ml $ hf jobs scheduled labels <id> —clear

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf jobs scheduled list | ls | ps

Liệt kê các Job đã lên lịch.

Sử dụng --status để lọc theo trạng thái (active hoặc suspended) và --label để lọc theo nhãn key=value. Một Job được lên lịch phải khớp với mọi bộ lọc để được liệt kê.

Cách sử dụng:

$ hf jobs scheduled list | ls | ps [OPTIONS]

Tùy chọn:

• -a, --all: Hiển thị tất cả các Job đã lên lịch (mặc định ẩn các Job đang tạm dừng). Không thể kết hợp với —status.
• --status [active|suspended]: Chỉ hiển thị các Job đã lên lịch có trạng thái được chỉ định. Tách bằng dấu phẩy hoặc lặp lại, ví dụ --status suspended.
• -l, --label TEXT: Chỉ hiển thị các Job đã lên lịch có nhãn key=value được chỉ định. Lặp lại để yêu cầu nhiều nhãn, ví dụ --label env=prod --label team=ml.
• --name TEXT: Chỉ hiển thị các Job đã lên lịch có tên được chỉ định (lối tắt cho --label name=NAME).
• --namespace TEXT: Namespace nơi công việc sẽ được thực thi. Mặc định là namespace của người dùng hiện tại.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf jobs scheduled ls $ hf jobs scheduled ls -a $ hf jobs scheduled ls —status suspended $ hf jobs scheduled ls —name daily-script $ hf jobs scheduled ls —label env=prod —label team=ml

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf jobs scheduled reschedule

Thay đổi thời điểm chạy của một Job được lên lịch.

Cách sử dụng:

$ hf jobs scheduled reschedule [OPTIONS] SCHEDULED_JOB_ID SCHEDULE

Tham số:

• SCHEDULED_JOB_ID: ID của Job được lên lịch (hoặc ‘namespace/scheduled_job_id’) [bắt buộc]
• SCHEDULE: Một trong @annually, @yearly, @monthly, @weekly, @daily, @hourly, hoặc một biểu thức lịch CRON. [bắt buộc]

Tùy chọn:

• --namespace TEXT: Namespace nơi công việc sẽ được thực thi. Mặc định là namespace của người dùng hiện tại.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf jobs scheduled reschedule <id> “0 9 * * 1”

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf jobs scheduled resume

Tiếp tục (hủy tạm dừng) một Job đã lên lịch.

Cách sử dụng:

$ hf jobs scheduled resume [OPTIONS] SCHEDULED_JOB_ID

Tham số:

• SCHEDULED_JOB_ID: ID của Job được lên lịch (hoặc ‘namespace/scheduled_job_id’) [bắt buộc]

Tùy chọn:

• --namespace TEXT: Namespace nơi công việc sẽ được thực thi. Mặc định là namespace của người dùng hiện tại.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf jobs scheduled resume <id>

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf jobs scheduled run

Lên lịch một công việc.

Cách sử dụng:

$ hf jobs scheduled run [OPTIONS] SCHEDULE IMAGE COMMAND...

Tham số:

• SCHEDULE: Một trong @annually, @yearly, @monthly, @weekly, @daily, @hourly, hoặc một biểu thức lịch CRON. [bắt buộc]
• IMAGE: Ảnh Docker cần sử dụng. [bắt buộc]
• COMMAND...: Lệnh cần chạy. [bắt buộc]

Tùy chọn:

• --suspend / --no-suspend: Tạm dừng (pause) Job đã lên lịch
• --concurrency / --no-concurrency: Cho phép nhiều phiên bản của Job này chạy đồng thời
• -e, --env TEXT: Đặt các biến môi trường. Ví dụ —env ENV=value
• -s, --secrets TEXT: Đặt các biến môi trường bí mật. Nên dùng --secrets SECRET để đọc giá trị từ môi trường của bạn (ví dụ: --secrets HF_TOKEN để truyền token Hugging Face của bạn); --secrets SECRET=value sẽ lưu giá trị vào lịch sử shell của bạn.
• --name TEXT: Đặt tên cho Job. Được lưu dưới dạng nhãn name. Tên không nhất thiết phải duy nhất. Mặc định là tên image hoặc script kèm theo một hash ngắn của cấu hình khởi chạy đã được phân giải.
• -l, --label TEXT: Đặt nhãn. Ví dụ —label KEY=VALUE hoặc —label LABEL
• -v, --volume TEXT: Gắn một hoặc nhiều volume. Định dạng: hf://[TYPE/]SOURCE:/MOUNT_PATH[:ro|:rw] hoặc LOCAL_DIR:/MOUNT_PATH[:ro|:rw]. TYPE là một trong các giá trị: models, datasets, spaces, buckets. Nếu bỏ qua, TYPE mặc định là models. models, datasets và spaces luôn được gắn ở chế độ chỉ đọc. buckets mặc định ở chế độ đọc+ghi. Nguồn là thư mục cục bộ sẽ được đồng bộ hóa trước tiên vào một bucket và mặc định được gắn ở chế độ chỉ đọc. Ví dụ: -v hf://datasets/org/ds:/data hoặc -v hf://buckets/org/b:/mnt:ro hoặc -v ./inputs:/inputs
• --env-file TEXT: Đọc một tệp chứa các biến môi trường. Sử dụng - để đọc chúng từ stdin.
• --secrets-file TEXT: Đọc một tệp chứa các biến môi trường bí mật. Sử dụng - để đọc chúng từ stdin.
• --flavor [cpu-basic|cpu-upgrade|cpu-performance|cpu-xl|t4-small|t4-medium|l4x1|l4x4|l40sx1|l40sx4|l40sx8|a10g-small|a10g-large|a10g-largex2|a10g-largex4|a100-large|a100x4|a100x8|h200|h200x2|h200x4|h200x8|rtx-pro-6000|rtx-pro-6000x2|rtx-pro-6000x4|rtx-pro-6000x8]: Flavor cho phần cứng. Chạy ‘hf jobs hardware’ để liệt kê các flavor khả dụng. Mặc định là cpu-basic.
• --timeout TEXT: Thời lượng tối đa: int với s (giây, mặc định), m (phút), h (giờ) hoặc d (ngày).
• --attempts INTEGER RANGE: Số lần thử tối đa, bao gồm lần chạy đầu tiên. Mặc định là 1. [x>=1]
• --dry-run: In cấu hình Job đã được phân giải mà không gửi Job.
• --expose INTEGER: Mở một cổng container thông qua jobs proxy. Lặp lại cờ này cho nhiều cổng (ví dụ: --expose 8000 --expose 8001). Mỗi cổng được mở sẽ có thể truy cập trên tên miền jobs công khai; việc truy cập yêu cầu một HF token có quyền đọc trong namespace của job.
• --expose-public INTEGER: Mở một cổng của container thông qua jobs proxy mà không cần xác thực. Lặp lại cờ này cho nhiều cổng. Không cần truyền thêm cổng với --expose.
• --resource-group-id TEXT: ID của nhóm tài nguyên để tạo Job. Được sử dụng để kiểm soát quyền truy cập vào các tài nguyên trong tổ chức và cho các tính năng gán chi phí/giới hạn chi tiêu.
• --namespace TEXT: Namespace nơi công việc sẽ được thực thi. Mặc định là namespace của người dùng hiện tại.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --format [agent|auto|human|json|quiet]: Định dạng đầu ra. Mặc định là ‘auto’, tự động chọn ‘agent’ hoặc ‘human’ dựa trên terminal.
• --json: Đầu ra JSON. Tương đương với ‘—format json’.
• -q, --quiet: Đầu ra ở chế độ im lặng (một ID trên mỗi dòng). Tương đương với ‘—format quiet’.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf jobs scheduled run “0 0 * * *” —name daily-script python:3.12 python script.py

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf jobs scheduled suspend

Tạm dừng một Job đã lên lịch.

Cách sử dụng:

$ hf jobs scheduled suspend [OPTIONS] SCHEDULED_JOB_ID

Tham số:

• SCHEDULED_JOB_ID: ID của Job được lên lịch (hoặc ‘namespace/scheduled_job_id’) [bắt buộc]

Tùy chọn:

• --namespace TEXT: Namespace nơi công việc sẽ được thực thi. Mặc định là namespace của người dùng hiện tại.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf jobs scheduled suspend <id>

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf jobs scheduled trigger

Kích hoạt một Job được lên lịch để chạy ngay lập tức (không thay đổi lịch trình).

Cách sử dụng:

$ hf jobs scheduled trigger [OPTIONS] SCHEDULED_JOB_ID

Tham số:

• SCHEDULED_JOB_ID: ID của Job được lên lịch (hoặc ‘namespace/scheduled_job_id’) [bắt buộc]

Tùy chọn:

• --namespace TEXT: Namespace nơi công việc sẽ được thực thi. Mặc định là namespace của người dùng hiện tại.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf jobs scheduled trigger <id>

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf jobs scheduled uv

Lên lịch các script UV trên hạ tầng HF.

Cách sử dụng:

$ hf jobs scheduled uv [OPTIONS] COMMAND [ARGS]...

Tùy chọn:

• --help: Hiển thị thông báo này và thoát.

Lệnh:

• run: Chạy một kịch bản UV (tệp cục bộ hoặc URL) trên hạ tầng HF

hf jobs scheduled uv run

Chạy một kịch bản UV (tệp cục bộ hoặc URL) trên hạ tầng HF

Cách sử dụng:

$ hf jobs scheduled uv run [OPTIONS] SCHEDULE SCRIPT [SCRIPT_ARGS]...

Tham số:

• SCHEDULE: Một trong @annually, @yearly, @monthly, @weekly, @daily, @hourly, hoặc một biểu thức lịch CRON. [bắt buộc]
• SCRIPT: UV script để chạy (tệp cục bộ hoặc URL) [bắt buộc]
• [SCRIPT_ARGS]...: Các đối số cho script

Tùy chọn:

• --suspend / --no-suspend: Tạm dừng (pause) Job đã lên lịch
• --concurrency / --no-concurrency: Cho phép nhiều phiên bản của Job này chạy đồng thời
• --image TEXT: Sử dụng hình ảnh Docker tùy chỉnh có cài đặt uv.
• --flavor [cpu-basic|cpu-upgrade|cpu-performance|cpu-xl|t4-small|t4-medium|l4x1|l4x4|l40sx1|l40sx4|l40sx8|a10g-small|a10g-large|a10g-largex2|a10g-largex4|a100-large|a100x4|a100x8|h200|h200x2|h200x4|h200x8|rtx-pro-6000|rtx-pro-6000x2|rtx-pro-6000x4|rtx-pro-6000x8]: Flavor cho phần cứng. Chạy ‘hf jobs hardware’ để liệt kê các flavor khả dụng. Mặc định là cpu-basic.
• -e, --env TEXT: Đặt các biến môi trường. Ví dụ —env ENV=value
• -s, --secrets TEXT: Đặt các biến môi trường bí mật. Nên dùng --secrets SECRET để đọc giá trị từ môi trường của bạn (ví dụ: --secrets HF_TOKEN để truyền token Hugging Face của bạn); --secrets SECRET=value sẽ lưu giá trị vào lịch sử shell của bạn.
• --name TEXT: Đặt tên cho Job. Được lưu dưới dạng nhãn name. Tên không nhất thiết phải duy nhất. Mặc định là tên image hoặc script kèm theo một hash ngắn của cấu hình khởi chạy đã được phân giải.
• -l, --label TEXT: Đặt nhãn. Ví dụ —label KEY=VALUE hoặc —label LABEL
• -v, --volume TEXT: Gắn một hoặc nhiều volume. Định dạng: hf://[TYPE/]SOURCE:/MOUNT_PATH[:ro|:rw] hoặc LOCAL_DIR:/MOUNT_PATH[:ro|:rw]. TYPE là một trong các giá trị: models, datasets, spaces, buckets. Nếu bỏ qua, TYPE mặc định là models. models, datasets và spaces luôn được gắn ở chế độ chỉ đọc. buckets mặc định ở chế độ đọc+ghi. Nguồn là thư mục cục bộ sẽ được đồng bộ hóa trước tiên vào một bucket và mặc định được gắn ở chế độ chỉ đọc. Ví dụ: -v hf://datasets/org/ds:/data hoặc -v hf://buckets/org/b:/mnt:ro hoặc -v ./inputs:/inputs
• --env-file TEXT: Đọc một tệp chứa các biến môi trường. Sử dụng - để đọc chúng từ stdin.
• --secrets-file TEXT: Đọc một tệp chứa các biến môi trường bí mật. Sử dụng - để đọc chúng từ stdin.
• --timeout TEXT: Thời lượng tối đa: int với s (giây, mặc định), m (phút), h (giờ) hoặc d (ngày).
• --attempts INTEGER RANGE: Số lần thử tối đa, bao gồm lần chạy đầu tiên. Mặc định là 1. [x>=1]
• --dry-run: In cấu hình Job đã được phân giải mà không gửi Job.
• --expose INTEGER: Mở một cổng container thông qua jobs proxy. Lặp lại cờ này cho nhiều cổng (ví dụ: --expose 8000 --expose 8001). Mỗi cổng được mở sẽ có thể truy cập trên tên miền jobs công khai; việc truy cập yêu cầu một HF token có quyền đọc trong namespace của job.
• --expose-public INTEGER: Mở một cổng của container thông qua jobs proxy mà không cần xác thực. Lặp lại cờ này cho nhiều cổng. Không cần truyền thêm cổng với --expose.
• --resource-group-id TEXT: ID của nhóm tài nguyên để tạo Job. Được sử dụng để kiểm soát quyền truy cập vào các tài nguyên trong tổ chức và cho các tính năng gán chi phí/giới hạn chi tiêu.
• --namespace TEXT: Namespace nơi công việc sẽ được thực thi. Mặc định là namespace của người dùng hiện tại.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --with TEXT: Chạy với các gói đã cài đặt được chỉ định
• -p, --python TEXT: Trình thông dịch Python để sử dụng cho môi trường chạy
• --format [agent|auto|human|json|quiet]: Định dạng đầu ra. Mặc định là ‘auto’, tự động chọn ‘agent’ hoặc ‘human’ dựa trên terminal.
• --json: Đầu ra JSON. Tương đương với ‘—format json’.
• -q, --quiet: Đầu ra ở chế độ im lặng (một ID trên mỗi dòng). Tương đương với ‘—format quiet’.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf jobs scheduled uv run “0 0 * * ” —name daily-script script.py $ hf jobs scheduled uv run “0 0 * *” script.py —with pandas

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf jobs ssh

Sử dụng SSH để truy cập vào một Job đang chạy.

Nếu Job chưa chạy, sẽ chờ cho đến khi nó đạt trạng thái RUNNING trước khi kết nối. Yêu cầu Job phải được khởi động với SSH được bật (hf jobs run --ssh ...) và khóa công khai SSH của bạn phải được đăng ký tại https://huggingface.co/settings/keys.

Cách sử dụng:

$ hf jobs ssh [OPTIONS] JOB_ID

Tham số:

• JOB_ID: ID của tác vụ (hoặc ‘namespace/job_id’) [bắt buộc]

Tùy chọn:

• -i, --identity-file PATH: Đường dẫn đến tệp danh tính SSH (được chuyển tiếp đến ssh -i).
• --dry-run: In ra lệnh SSH thay vì thực thi nó.
• --namespace TEXT: Namespace nơi công việc sẽ được thực thi. Mặc định là namespace của người dùng hiện tại.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf jobs ssh <job_id> $ hf jobs ssh <job_id> —dry-run $ hf jobs ssh <job_id> -i ~/.ssh/id_ed25519

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf jobs stats

Lấy thống kê và chỉ số sử dụng tài nguyên của các Job.

Mặc định, in ra một bản chụp các thống kê hiện tại và thoát (không chặn). Sử dụng —follow/-f để hiển thị thống kê trực tiếp cho đến khi các Jobs hoàn tất.

Cách sử dụng:

$ hf jobs stats [OPTIONS] [JOB_IDS]...

Tham số:

• [JOB_IDS]...: Các ID công việc (hoặc ‘namespace/job_id’)

Tùy chọn:

• -f, --follow: Theo dõi đầu ra thống kê (xem trực tiếp cho đến khi các Jobs hoàn tất). Nếu không có cờ này, chỉ một bản chụp đơn lẻ được in ra.
• --namespace TEXT: Namespace nơi công việc sẽ được thực thi. Mặc định là namespace của người dùng hiện tại.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf jobs stats $ hf jobs stats <job_id> $ hf jobs stats -f <job_id>

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf jobs uv

Chạy các kịch bản UV (Python với các phụ thuộc inline) trên hạ tầng HF.

Cách sử dụng:

$ hf jobs uv [OPTIONS] COMMAND [ARGS]...

Tùy chọn:

• --help: Hiển thị thông báo này và thoát.

Lệnh:

• run: Chạy một kịch bản UV (tệp cục bộ hoặc URL) trên hạ tầng HF

hf jobs uv run

Chạy một kịch bản UV (tệp cục bộ hoặc URL) trên hạ tầng HF

Cách sử dụng:

$ hf jobs uv run [OPTIONS] SCRIPT [SCRIPT_ARGS]...

Tham số:

• SCRIPT: UV script để chạy (tệp cục bộ hoặc URL) [bắt buộc]
• [SCRIPT_ARGS]...: Các đối số cho script

Tùy chọn:

• --image TEXT: Sử dụng hình ảnh Docker tùy chỉnh có cài đặt uv.
• --flavor [cpu-basic|cpu-upgrade|cpu-performance|cpu-xl|t4-small|t4-medium|l4x1|l4x4|l40sx1|l40sx4|l40sx8|a10g-small|a10g-large|a10g-largex2|a10g-largex4|a100-large|a100x4|a100x8|h200|h200x2|h200x4|h200x8|rtx-pro-6000|rtx-pro-6000x2|rtx-pro-6000x4|rtx-pro-6000x8]: Flavor cho phần cứng. Chạy ‘hf jobs hardware’ để liệt kê các flavor khả dụng. Mặc định là cpu-basic.
• -e, --env TEXT: Đặt các biến môi trường. Ví dụ —env ENV=value
• -s, --secrets TEXT: Đặt các biến môi trường bí mật. Nên dùng --secrets SECRET để đọc giá trị từ môi trường của bạn (ví dụ: --secrets HF_TOKEN để truyền token Hugging Face của bạn); --secrets SECRET=value sẽ lưu giá trị vào lịch sử shell của bạn.
• --name TEXT: Đặt tên cho Job. Được lưu dưới dạng nhãn name. Tên không nhất thiết phải duy nhất. Mặc định là tên image hoặc script kèm theo một hash ngắn của cấu hình khởi chạy đã được phân giải.
• -l, --label TEXT: Đặt nhãn. Ví dụ —label KEY=VALUE hoặc —label LABEL
• -v, --volume TEXT: Gắn một hoặc nhiều volume. Định dạng: hf://[TYPE/]SOURCE:/MOUNT_PATH[:ro|:rw] hoặc LOCAL_DIR:/MOUNT_PATH[:ro|:rw]. TYPE là một trong các giá trị: models, datasets, spaces, buckets. Nếu bỏ qua, TYPE mặc định là models. models, datasets và spaces luôn được gắn ở chế độ chỉ đọc. buckets mặc định ở chế độ đọc+ghi. Nguồn là thư mục cục bộ sẽ được đồng bộ hóa trước tiên vào một bucket và mặc định được gắn ở chế độ chỉ đọc. Ví dụ: -v hf://datasets/org/ds:/data hoặc -v hf://buckets/org/b:/mnt:ro hoặc -v ./inputs:/inputs
• --env-file TEXT: Đọc một tệp chứa các biến môi trường. Sử dụng - để đọc chúng từ stdin.
• --secrets-file TEXT: Đọc một tệp chứa các biến môi trường bí mật. Sử dụng - để đọc chúng từ stdin.
• --timeout TEXT: Thời lượng tối đa: int với s (giây, mặc định), m (phút), h (giờ) hoặc d (ngày).
• --attempts INTEGER RANGE: Số lần thử tối đa, bao gồm lần chạy đầu tiên. Mặc định là 1. [x>=1]
• -d, --detach: Chạy Job ở chế độ nền và in ra Job ID.
• --dry-run: In cấu hình Job đã được phân giải mà không gửi Job.
• --expose INTEGER: Mở một cổng container thông qua jobs proxy. Lặp lại cờ này cho nhiều cổng (ví dụ: --expose 8000 --expose 8001). Mỗi cổng được mở sẽ có thể truy cập trên tên miền jobs công khai; việc truy cập yêu cầu một HF token có quyền đọc trong namespace của job.
• --expose-public INTEGER: Mở một cổng của container thông qua jobs proxy mà không cần xác thực. Lặp lại cờ này cho nhiều cổng. Không cần truyền thêm cổng với --expose.
• --ssh: Cho phép truy cập vào container của job qua SSH. Kết nối bằng hf jobs ssh <job_id>. Yêu cầu có khóa công khai SSH đã được đăng ký tại https://huggingface.co/settings/keys.
• --network-group TEXT: Tham gia một nhóm mạng. Các tác vụ trong cùng namespace và resource group chia sẻ một nhóm sẽ được đặt cùng nhau và có thể liên lạc với nhau trên mọi cổng. Bên trong mỗi thành viên, $HF_NETWORK_GROUP_HOSTNAME sẽ phân giải đến mọi thành viên. Chỉ gồm chữ cái thường, chữ số và dấu gạch ngang, tối đa 46 ký tự.
• --network-alias TEXT: Đăng ký một alias trong nhóm mạng. Các thành viên truy cập các job đã đăng ký alias đó tại ${HF_NETWORK_GROUP_PREFIX}<alias>. Lặp lại cờ này cho nhiều alias. Chỉ gồm chữ cái thường, chữ số và dấu gạch nối, tối đa 34 ký tự, duy nhất trong job. Yêu cầu --network-group.
• --resource-group-id TEXT: ID của nhóm tài nguyên để tạo Job. Được sử dụng để kiểm soát quyền truy cập vào các tài nguyên trong tổ chức và cho các tính năng gán chi phí/giới hạn chi tiêu.
• --namespace TEXT: Namespace nơi công việc sẽ được thực thi. Mặc định là namespace của người dùng hiện tại.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --with TEXT: Chạy với các gói đã cài đặt được chỉ định
• -p, --python TEXT: Trình thông dịch Python để sử dụng cho môi trường chạy
• --format [agent|auto|human|json|quiet]: Định dạng đầu ra. Mặc định là ‘auto’, tự động chọn ‘agent’ hoặc ‘human’ dựa trên terminal.
• --json: Đầu ra JSON. Tương đương với ‘—format json’.
• -q, --quiet: Đầu ra ở chế độ im lặng (một ID trên mỗi dòng). Tương đương với ‘—format quiet’.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf jobs uv run —name my-script my_script.py $ hf jobs uv run —detach my_script.py $ hf jobs uv run —flavor a10g-small ml_training.py $ hf jobs uv run —with transformers train.py $ hf jobs uv run -v hf://org/my-model:/data -v hf://buckets/org/b:/mnt script.py $ hf jobs uv run —dry-run script.py

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf jobs wait

Chờ một hoặc nhiều Job đạt đến trạng thái cuối.

Chặn cho đến khi mọi Job hoàn tất, sau đó thoát với mã 0 nếu tất cả Job hoàn thành thành công, hoặc mã thoát khác 0 nếu có Job bị hủy, gặp lỗi hoặc bị xóa.

Tất cả các Job phải thuộc cùng một namespace.

Cách sử dụng:

$ hf jobs wait [OPTIONS] JOB_IDS...

Tham số:

• JOB_IDS...: Các ID công việc cần chờ (hoặc ‘namespace/job_id’). [bắt buộc]

Tùy chọn:

• --timeout TEXT: Thời gian chờ tối đa: int với s (giây, mặc định), m (phút), h (giờ) hoặc d (ngày).
• --namespace TEXT: Namespace nơi công việc sẽ được thực thi. Mặc định là namespace của người dùng hiện tại.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf jobs wait <job_id> $ hf jobs wait <job_id_1> <job_id_2> $ hf jobs ls -q | xargs hf jobs wait

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf lfs-enable-largefiles

Cấu hình kho của bạn để cho phép tải lên các tệp > 5GB.

Lệnh này thiết lập git-lfs để sử dụng tác nhân chuyển multipart tùy chỉnh, cho phép tải lên các tệp lớn một cách hiệu quả theo từng phần.

Cách sử dụng:

$ hf lfs-enable-largefiles [OPTIONS] PATH

Tham số:

• PATH: Đường dẫn cục bộ đến kho bạn muốn cấu hình. [bắt buộc]

Tùy chọn:

• --help: Hiển thị thông báo này và thoát.

hf lfs-multipart-upload

Tác nhân chuyển giao tùy chỉnh git-lfs nội bộ cho các bản tải lên nhiều phần.

Hàm này triển khai giao thức chuyển dữ liệu tùy chỉnh cho các bản tải lên dạng nhiều phần (multipart) của git-lfs. Xử lý việc tải lên các tệp lớn lên Hugging Face Hub theo từng khối (chunked uploads).

Cách sử dụng:

$ hf lfs-multipart-upload [OPTIONS]

Tùy chọn:

• --help: Hiển thị thông báo này và thoát.

hf models

Tương tác với các mô hình trên Hub.

Cách sử dụng:

$ hf models [OPTIONS] COMMAND [ARGS]...

Tùy chọn:

• --help: Hiển thị thông báo này và thoát.

Lệnh:

• card: Lấy thẻ mô hình (README) của một mô hình trên Hub.
• info: Lấy thông tin về một model trên Hub.
• list: Liệt kê các model trên Hub, hoặc các file trong một repo model. [alias: ls]

hf models card

Lấy thẻ mô hình (README) của một mô hình trên Hub.

Cách sử dụng:

$ hf models card [OPTIONS] MODEL_ID

Tham số:

• MODEL_ID: ID của mô hình (ví dụ: username/repo-name). [bắt buộc]

Tùy chọn:

• --metadata: Chỉ xuất metadata từ thẻ.
• --text: Chỉ xuất phần thân văn bản (không có metadata).
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf models card google/gemma-4-31B-it $ hf models card google/gemma-4-31B-it —metadata $ hf models card google/gemma-4-31B-it —metadata —format json $ hf models card google/gemma-4-31B-it —text

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf models info

Lấy thông tin về một mô hình trên Hub.

Cách sử dụng:

$ hf models info [OPTIONS] MODEL_ID

Tham số:

• MODEL_ID: ID của mô hình (ví dụ: username/repo-name). [bắt buộc]

Tùy chọn:

• --revision TEXT: id của bản sửa đổi Git, có thể là tên nhánh, thẻ hoặc mã băm của commit.
• --expand TEXT: Các thuộc tính được phân tách bằng dấu phẩy để trả về. Khi được sử dụng, chỉ các thuộc tính được liệt kê (và id) sẽ được trả về. Ví dụ: ‘—expand=downloads,likes,tags’. Hợp lệ: author, baseModels, cardData, childrenModelCount, config, createdAt, disabled, downloads, downloadsAllTime, evalResults, gated, gguf, inference, inferenceProviderMapping, lastModified, library_name, likes, mask_token, model-index, pipeline_tag, private, resourceGroup, safetensors, sha, siblings, spaces, tags, transformersInfo, trendingScore, usedStorage, widgetData.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf models info meta-llama/Llama-3.2-1B-Instruct $ hf models info Qwen/Qwen3.5-9B —expand downloads,likes,tags

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf models list

Liệt kê các model trên Hub, hoặc các file trong một repo model. [alias: ls]

Khi được gọi không có đối số, liệt kê các model trên Hub. Khi được gọi với một model ID, liệt kê các file trong repo model đó.

Cách sử dụng:

$ hf models list [OPTIONS] [REPO_ID]

Tham số:

• [REPO_ID]: Model ID (ví dụ: username/repo-name) để liệt kê các tệp từ đó. Nếu bị bỏ qua, sẽ liệt kê các model.

Tùy chọn:

• --search TEXT: Câu truy vấn tìm kiếm.
• --author TEXT: Lọc theo tác giả hoặc tổ chức.
• --filter TEXT: Lọc theo thẻ (ví dụ: ‘text-classification’). Có thể sử dụng nhiều lần.
• --pipeline-tag TEXT: Lọc theo pipeline tag (nhiệm vụ chính tắc), ví dụ ‘summarization’.
• --gated / --no-gated: Lọc theo trạng thái có kiểm soát. ‘—gated’ chỉ cho các mục có kiểm soát, ‘—no-gated’ chỉ cho các mục không có kiểm soát.
• --apps TEXT: Lọc theo ứng dụng có thể chạy mô hình, ví dụ ‘ollama’ hoặc ‘vllm’.
• --num-parameters TEXT: Lọc theo số lượng tham số, ví dụ ‘min:6B,max:128B’.
• --inference-provider [baseten|cerebras|cohere|deepinfra|fal-ai|featherless-ai|fireworks-ai|groq|hf-inference|novita|nscale|openai|ovhcloud|publicai|replicate|scaleway|together|wavespeed|zai-org]: Lọc theo nhà cung cấp suy luận (inference provider) đang phục vụ mô hình, ví dụ ‘fireworks-ai’.
• --warm: Chỉ liệt kê các mô hình hiện đang được phục vụ bởi ít nhất một nhà cung cấp suy luận.
• --sort [created_at|downloads|last_modified|likes|trending_score]: Sắp xếp kết quả.
• --limit INTEGER: Giới hạn số lượng kết quả. [mặc định: 30]
• --expand TEXT: Các thuộc tính được phân tách bằng dấu phẩy để trả về. Khi được sử dụng, chỉ các thuộc tính được liệt kê (và id) sẽ được trả về. Ví dụ: ‘—expand=downloads,likes,tags’. Hợp lệ: author, baseModels, cardData, childrenModelCount, config, createdAt, disabled, downloads, downloadsAllTime, evalResults, gated, gguf, inference, inferenceProviderMapping, lastModified, library_name, likes, mask_token, model-index, pipeline_tag, private, resourceGroup, safetensors, sha, siblings, spaces, tags, transformersInfo, trendingScore, usedStorage, widgetData.
• -h, --human-readable: Hiển thị kích thước ở định dạng dễ đọc (chỉ áp dụng khi liệt kê tệp).
• --tree: Liệt kê các tệp theo định dạng cây (chỉ dùng để liệt kê tệp).
• -R, --recursive: Liệt kê các tệp đệ quy (chỉ dùng để liệt kê tệp).
• --revision TEXT: id của bản sửa đổi Git, có thể là tên nhánh, thẻ hoặc mã băm của commit.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf models ls —sort downloads —limit 10 $ hf models ls —search “llama” —author meta-llama $ hf models ls —pipeline-tag text-generation —warm $ hf models ls —num-parameters min:6B,max:128B —sort likes $ hf models ls —no-gated —author google $ hf models ls —apps llama.cpp —apps vllm $ hf models ls —inference-provider fireworks-ai —sort downloads $ hf models ls —warm —search llama $ hf models ls meta-llama/Llama-3.2-1B-Instruct $ hf models ls meta-llama/Llama-3.2-1B-Instruct -R $ hf models ls meta-llama/Llama-3.2-1B-Instruct —tree -h

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf papers

Tương tác với các bài báo trên Hub.

Cách sử dụng:

$ hf papers [OPTIONS] COMMAND [ARGS]...

Tùy chọn:

• --help: Hiển thị thông báo này và thoát.

Lệnh:

• info: Lấy thông tin về một bài báo trên Hub.
• list: Liệt kê các bài báo hàng ngày trên Hub. [alias: ls]
• read: Đọc một bài báo dưới dạng markdown.
• search: Tìm kiếm các bài báo trên Hub.

hf papers info

Lấy thông tin về một bài báo trên Hub.

Cách sử dụng:

$ hf papers info [OPTIONS] PAPER_ID

Tham số:

• PAPER_ID: ID của bài báo trên arXiv (ví dụ: ‘2502.08025’). [bắt buộc]

Tùy chọn:

• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf papers info 2601.15621

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf papers list

Liệt kê các bài báo hàng ngày trên Hub. [alias: ls]

Cách sử dụng:

$ hf papers list [OPTIONS]

Tùy chọn:

• --date TEXT: Ngày ở định dạng ISO (YYYY-MM-DD) hoặc ‘today’.
• --week TEXT: tuần ISO để lọc, ví dụ ‘2025-W09’.
• --month TEXT: Tháng để lọc theo định dạng ISO (YYYY-MM), ví dụ ‘2025-02’.
• --submitter TEXT: Lọc theo tên người dùng của người gửi.
• --sort [publishedAt|trending]: Sắp xếp kết quả.
• --limit INTEGER: Giới hạn số lượng kết quả. [mặc định: 50]
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf papers ls $ hf papers ls —sort trending $ hf papers ls —date 2025-01-23 $ hf papers ls —week 2025-W09 $ hf papers ls —submitter akhaliq $ hf papers ls —format json

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf papers read

Đọc một bài báo dưới dạng markdown.

Cách sử dụng:

$ hf papers read [OPTIONS] PAPER_ID

Tham số:

• PAPER_ID: ID của bài báo trên arXiv (ví dụ: ‘2502.08025’). [bắt buộc]

Tùy chọn:

• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf papers read 2601.15621

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf papers search

Tìm kiếm các bài báo trên Hub.

Cách sử dụng:

$ hf papers search [OPTIONS] QUERY

Tham số:

• QUERY: Chuỗi truy vấn tìm kiếm. [bắt buộc]

Tùy chọn:

• --limit INTEGER: Giới hạn số lượng kết quả. [mặc định: 20]
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf papers search “vision language” $ hf papers search “attention mechanism” —limit 10 $ hf papers search “diffusion” —format json

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf repos

Quản lý kho trên Hub.

Cách sử dụng:

$ hf repos [OPTIONS] COMMAND [ARGS]...

Tùy chọn:

• --help: Hiển thị thông báo này và thoát.

Lệnh:

• branch: Quản lý các nhánh cho một kho trên Hub.
• cp: Sao chép tệp giữa các đường dẫn cục bộ, kho và bucket.
• create: Tạo một kho mới trên Hub.
• delete: Xóa một kho (repo) khỏi Hub.
• delete-files: Xóa các tệp khỏi kho trên Hub.
• duplicate: Sao chép một kho trên Hub (mô hình, bộ dữ liệu hoặc Space).
• list: Liệt kê tất cả các kho (models, datasets, spaces, buckets) kèm thông tin lưu trữ. [alias: ls]
• move: Di chuyển một kho lưu trữ từ một namespace sang namespace khác.
• settings: Cập nhật cài đặt của một kho lưu trữ.
• tag: Quản lý thẻ cho một kho trên Hub.

hf repos branch

Quản lý các nhánh cho một kho trên Hub.

Cách sử dụng:

$ hf repos branch [OPTIONS] COMMAND [ARGS]...

Tùy chọn:

• --help: Hiển thị thông báo này và thoát.

Lệnh:

• create: Tạo một nhánh mới cho một kho trên Hub.
• delete: Xóa một nhánh khỏi kho trên Hub.

hf repos branch create

Tạo một nhánh mới cho một kho trên Hub.

Cách sử dụng:

$ hf repos branch create [OPTIONS] REPO_ID BRANCH

Tham số:

• REPO_ID: ID của kho (ví dụ username/repo-name hoặc spaces/username/repo-name). [bắt buộc]
• BRANCH: Tên của nhánh cần tạo. [bắt buộc]

Tùy chọn:

• --revision TEXT: id của bản sửa đổi Git, có thể là tên nhánh, thẻ hoặc mã băm của commit.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --type, --repo-type [model|dataset|space|kernel]: Kiểu kho (model, dataset, space hoặc kernel). [mặc định: model]
• --exist-ok / --no-exist-ok: Nếu đặt thành True, sẽ không gây ra lỗi nếu nhánh đã tồn tại. [mặc định: no-exist-ok]
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf repos branch create my-model dev $ hf repos branch create my-model dev —revision abc123

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf repos branch delete

Xóa một nhánh khỏi kho trên Hub.

Cách sử dụng:

$ hf repos branch delete [OPTIONS] REPO_ID BRANCH

Tham số:

• REPO_ID: ID của kho (ví dụ username/repo-name hoặc spaces/username/repo-name). [bắt buộc]
• BRANCH: Tên của nhánh cần xóa. [bắt buộc]

Tùy chọn:

• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --type, --repo-type [model|dataset|space|kernel]: Kiểu kho (model, dataset, space hoặc kernel). [mặc định: model]
• --help: Hiển thị thông báo này và thoát.

Ví dụ $c hf repos branch delete my-model dev

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf repos cp

Sao chép tệp giữa các đường dẫn cục bộ, kho và bucket.

Xử lý tải lên (local/stdin -> repo/bucket), tải xuống (repo/bucket -> local/stdout) và sao chép từ xa đến từ xa (repo/bucket -> repo/bucket). Việc sao chép từ bucket sang repo và từ local sang local không được hỗ trợ. Đối với thư mục, hãy sử dụng hf upload/hf download (cho repos) hoặc hf buckets sync (cho buckets). Việc sao chép từ xa đến từ xa chỉ hoạt động trong cùng một khu vực lưu trữ (https://huggingface.co/docs/hub/storage-regions).

Cách sử dụng:

$ hf repos cp [OPTIONS] SRC [DST]

Tham số:

• SRC: Nguồn: tệp cục bộ, URI hf:// (kho hoặc bucket), hoặc - cho stdin. [bắt buộc]
• [DST]: Điểm đến: đường dẫn cục bộ, URI hf:// (kho hoặc bucket), hoặc - cho stdout.

Tùy chọn:

• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf repos cp hf://username/my-model/config.json config.json $ hf repos cp hf://datasets/username/my-dataset/data.csv data/ $ hf repos cp hf://username/my-model/config.json - $ hf repos cp model.safetensors hf://username/my-model/model.safetensors $ hf repos cp config.json hf://username/my-model/logs/ $ hf repos cp - hf://username/my-model/config.json $ hf repos cp hf://username/source-model/config.json hf://username/dest-model/config.json $ hf repos cp hf://datasets/username/my-dataset/processed/ hf://datasets/username/dest-dataset/processed/ $ hf repos cp hf://username/my-model/logs/ hf://username/archive-model/logs/

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf repos create

Tạo một kho mới trên Hub.

Cách sử dụng:

$ hf repos create [OPTIONS] REPO_ID

Tham số:

• REPO_ID: ID của kho (ví dụ username/repo-name hoặc spaces/username/repo-name). [bắt buộc]

Tùy chọn:

• --type, --repo-type [model|dataset|space|kernel]: Kiểu kho (model, dataset, space hoặc kernel). [mặc định: model]
• --sdk, --space-sdk TEXT: Kiểu Hugging Face Spaces SDK. Bắt buộc khi —type được đặt thành ‘space’.
• --template TEXT: Tạo một Space từ một mẫu chính thức. Truyền id của kho mẫu (ví dụ: ‘SpacesExamples/jupyterlab’) hoặc tên ngắn của nó (ví dụ: ‘JupyterLab’). Liệt kê các mẫu khả dụng bằng hf spaces templates. Chỉ dành cho Spaces.
• --private / --no-private: Xác định có tạo kho riêng tư hay không nếu kho chưa tồn tại trên Hub. Tham số này bị bỏ qua nếu kho đã tồn tại.
• --public: Xác định xem có công khai kho hay không. Bỏ qua nếu kho đã tồn tại.
• --protected: Xác định xem có bảo vệ Space hay không (chỉ dành cho Spaces). Bỏ qua nếu kho đã tồn tại.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --exist-ok / --no-exist-ok: Không gây ra lỗi nếu kho đã tồn tại. [mặc định: no-exist-ok]
• --resource-group-id TEXT: Nhóm tài nguyên để tạo kho. Nhóm tài nguyên chỉ khả dụng cho các tổ chức Enterprise Hub.
• --region [us|eu]: Vùng cloud để tạo kho. Có thể là ‘us’ hoặc ‘eu’. Yêu cầu gói Team trở lên.
• --flavor [cpu-basic|cpu-upgrade|zero-a10g|t4-small|t4-medium|l4x1|l4x4|l40sx1|l40sx4|l40sx8|a10g-small|a10g-large|a10g-largex2|a10g-largex4|a100-large|a100x4|a100x8|rtx-pro-6000|rtx-pro-6000x2|rtx-pro-6000x4|rtx-pro-6000x8]: Loại phần cứng của Space (ví dụ: ‘cpu-basic’, ‘t4-medium’, ‘l4x4’). Chỉ dành cho Spaces.
• --sleep-time INTEGER: Số giây không hoạt động trước khi Space được đưa vào trạng thái ngủ. Sử dụng -1 để tắt. Chỉ dành cho Spaces.
• -s, --secrets TEXT: Đặt các biến môi trường bí mật. Nên dùng --secrets SECRET để đọc giá trị từ môi trường của bạn (ví dụ: --secrets HF_TOKEN để truyền token Hugging Face của bạn); --secrets SECRET=value sẽ lưu giá trị vào lịch sử shell của bạn.
• --secrets-file TEXT: Đọc một tệp chứa các biến môi trường bí mật. Sử dụng - để đọc chúng từ stdin.
• -e, --env TEXT: Đặt các biến môi trường. Ví dụ —env ENV=value
• --env-file TEXT: Đọc một tệp chứa các biến môi trường. Sử dụng - để đọc chúng từ stdin.
• -v, --volume TEXT: Gắn một hoặc nhiều volume. Định dạng: hf://[TYPE/]SOURCE:/MOUNT_PATH[:ro]. TYPE là một trong các giá trị: models, datasets, spaces, buckets. Nếu bỏ qua, TYPE mặc định là models. models, datasets và spaces luôn được gắn ở chế độ chỉ đọc. buckets mặc định ở chế độ đọc+ghi. Ví dụ: -v hf://org/m:/data hoặc -v hf://datasets/org/ds:/data hoặc -v hf://buckets/org/b:/mnt:ro
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf repos create my-model $ hf repos create my-dataset —repo-type dataset —private $ hf repos create my-space —type space —sdk gradio —flavor t4-medium —secrets HF_TOKEN -e THEME=dark —protected $ hf repos create my-jupyterlab —type space —template SpacesExamples/jupyterlab $ hf repos create my-space —type space —sdk gradio -v hf://org/my-model:/models -v hf://buckets/org/b:/data $ hf repos create my-model —region us

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf repos delete

Xóa một kho (repo) khỏi Hub. Đây là một thao tác không thể hoàn tác.

Cách sử dụng:

$ hf repos delete [OPTIONS] REPO_ID

Tham số:

• REPO_ID: ID của kho (ví dụ username/repo-name hoặc spaces/username/repo-name). [bắt buộc]

Tùy chọn:

• --type, --repo-type [model|dataset|space|kernel]: Kiểu kho (model, dataset, space hoặc kernel). [mặc định: model]
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --missing-ok / --no-missing-ok: Nếu được đặt thành True, sẽ không gây ra lỗi nếu kho không tồn tại. [mặc định: no-missing-ok]
• -y, --yes: Tự động trả lời Có cho các câu hỏi.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf repos delete my-model

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf repos delete-files

Xóa tệp khỏi một kho trên Hub.

Cách sử dụng:

$ hf repos delete-files [OPTIONS] REPO_ID PATTERNS...

Tham số:

• REPO_ID: ID của kho (ví dụ username/repo-name hoặc spaces/username/repo-name). [bắt buộc]
• PATTERNS...: Các mẫu glob để khớp với các tệp cần xóa. Dựa trên fnmatch, ’*’ khớp với các tệp đệ quy. [bắt buộc]

Tùy chọn:

• --type, --repo-type [model|dataset|space|kernel]: Kiểu kho (model, dataset, space hoặc kernel). [mặc định: model]
• --revision TEXT: id của bản sửa đổi Git, có thể là tên nhánh, thẻ hoặc mã băm của commit.
• --commit-message TEXT: Tóm tắt / tiêu đề / dòng đầu tiên của commit được tạo.
• --commit-description TEXT: Mô tả của commit được tạo.
• --create-pr / --no-create-pr: Xác định có tạo một Pull Request mới cho các thay đổi này hay không. [mặc định: no-create-pr]
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf repos delete-files my-model file.txt $ hf repos delete-files my-model “*.json” $ hf repos delete-files my-model folder/

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf repos duplicate

Nhân bản một kho trên Hub (mô hình, bộ dữ liệu hoặc Space).

Cách sử dụng:

$ hf repos duplicate [OPTIONS] FROM_ID [TO_ID]

Tham số:

• FROM_ID: ID của kho (ví dụ: username/repo-name hoặc spaces/username/repo-name). [bắt buộc]
• [TO_ID]: ID của kho đích (ví dụ: myorg/my-copy). Mặc định là namespace của bạn với cùng tên kho.

Tùy chọn:

• --type, --repo-type [model|dataset|space|kernel]: Kiểu kho (model, dataset, space hoặc kernel). [mặc định: model]
• --private / --no-private: Xác định có tạo kho riêng tư hay không nếu kho chưa tồn tại trên Hub. Tham số này bị bỏ qua nếu kho đã tồn tại.
• --public: Xác định xem có công khai kho hay không. Bỏ qua nếu kho đã tồn tại.
• --protected: Xác định xem có bảo vệ Space hay không (chỉ dành cho Spaces). Bỏ qua nếu kho đã tồn tại.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --exist-ok / --no-exist-ok: Không gây ra lỗi nếu kho đã tồn tại. [mặc định: no-exist-ok]
• --resource-group-id TEXT: Nhóm tài nguyên để tạo kho mới. Nhóm tài nguyên chỉ khả dụng cho các tổ chức Enterprise Hub.
• --flavor [cpu-basic|cpu-upgrade|zero-a10g|t4-small|t4-medium|l4x1|l4x4|l40sx1|l40sx4|l40sx8|a10g-small|a10g-large|a10g-largex2|a10g-largex4|a100-large|a100x4|a100x8|rtx-pro-6000|rtx-pro-6000x2|rtx-pro-6000x4|rtx-pro-6000x8]: Loại phần cứng của Space (ví dụ: ‘cpu-basic’, ‘t4-medium’, ‘l4x4’). Chỉ dành cho Spaces.
• --sleep-time INTEGER: Số giây không hoạt động trước khi Space được đưa vào trạng thái ngủ. Sử dụng -1 để tắt. Chỉ dành cho Spaces.
• -s, --secrets TEXT: Đặt các biến môi trường bí mật. Nên dùng --secrets SECRET để đọc giá trị từ môi trường của bạn (ví dụ: --secrets HF_TOKEN để truyền token Hugging Face của bạn); --secrets SECRET=value sẽ lưu giá trị vào lịch sử shell của bạn.
• --secrets-file TEXT: Đọc một tệp chứa các biến môi trường bí mật. Sử dụng - để đọc chúng từ stdin.
• -e, --env TEXT: Đặt các biến môi trường. Ví dụ —env ENV=value
• --env-file TEXT: Đọc một tệp chứa các biến môi trường. Sử dụng - để đọc chúng từ stdin.
• -v, --volume TEXT: Gắn một hoặc nhiều volume. Định dạng: hf://[TYPE/]SOURCE:/MOUNT_PATH[:ro]. TYPE là một trong các giá trị: models, datasets, spaces, buckets. Nếu bỏ qua, TYPE mặc định là models. models, datasets và spaces luôn được gắn ở chế độ chỉ đọc. buckets mặc định ở chế độ đọc+ghi. Ví dụ: -v hf://org/m:/data hoặc -v hf://datasets/org/ds:/data hoặc -v hf://buckets/org/b:/mnt:ro
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf repos duplicate openai/gdpval —type dataset $ hf repos duplicate multimodalart/dreambooth-training my-dreambooth —type space —flavor l4x4 —secrets HF_TOKEN —private $ hf repos duplicate org/my-space my-space —type space -v hf://org/my-model:/models -v hf://buckets/org/b:/data

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf repos list

Liệt kê tất cả các kho (mô hình, bộ dữ liệu, spaces, buckets) kèm thông tin lưu trữ. [biệt danh: ls]

Cách sử dụng:

$ hf repos list [OPTIONS]

Tùy chọn:

• --namespace TEXT: Tên tổ chức. Nếu không được cung cấp, sẽ liệt kê các kho cho người dùng đã xác thực.
• --type, --repo-type [model|dataset|space|bucket]: Lọc theo loại kho (model, dataset, space hoặc bucket).
• --search TEXT: Câu truy vấn tìm kiếm.
• --limit INTEGER: Giới hạn số lượng kết quả. [mặc định: 30]
• --explore: Khám phá các kho lưu trữ của bạn như một thành phố 3D tương tác.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf repos ls $ hf repos ls —explore $ hf repos ls —namespace my-org —search bert

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf repos move

Di chuyển một kho lưu trữ từ một namespace sang namespace khác.

Cách sử dụng:

$ hf repos move [OPTIONS] FROM_ID TO_ID

Tham số:

• FROM_ID: ID của kho (ví dụ: username/repo-name hoặc spaces/username/repo-name). [bắt buộc]
• TO_ID: ID của kho (ví dụ username/repo-name hoặc spaces/username/repo-name). [bắt buộc]

Tùy chọn:

• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --type, --repo-type [model|dataset|space|kernel]: Kiểu kho (model, dataset, space hoặc kernel). [mặc định: model]
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf repos move old-namespace/my-model new-namespace/my-model

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf repos settings

Cập nhật cài đặt của một kho lưu trữ.

Cách sử dụng:

$ hf repos settings [OPTIONS] REPO_ID

Tham số:

• REPO_ID: ID của kho (ví dụ username/repo-name hoặc spaces/username/repo-name). [bắt buộc]

Tùy chọn:

• --gated [auto|manual|false]: Trạng thái có kiểm soát của kho.
• --private / --no-private: Xác định có tạo kho riêng tư hay không nếu kho chưa tồn tại trên Hub. Tham số này bị bỏ qua nếu kho đã tồn tại.
• --public: Xác định xem có công khai kho hay không. Bỏ qua nếu kho đã tồn tại.
• --protected: Xác định xem có bảo vệ Space hay không (chỉ dành cho Spaces). Bỏ qua nếu kho đã tồn tại.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --type, --repo-type [model|dataset|space|kernel]: Kiểu kho (model, dataset, space hoặc kernel). [mặc định: model]
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf repos settings my-model —private $ hf repos settings my-model —gated auto $ hf repos settings my-space —repo-type space —protected

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf repos tag

Quản lý thẻ cho một kho trên Hub.

Cách sử dụng:

$ hf repos tag [OPTIONS] COMMAND [ARGS]...

Tùy chọn:

• --help: Hiển thị thông báo này và thoát.

Lệnh:

• create: Tạo một thẻ cho một kho.
• delete: Xóa một thẻ cho kho.
• list: Liệt kê các thẻ cho một kho. [biệt danh: ls]

hf repos tag create

Tạo một thẻ cho một kho.

Cách sử dụng:

$ hf repos tag create [OPTIONS] REPO_ID TAG

Tham số:

• REPO_ID: ID của kho (ví dụ username/repo-name hoặc spaces/username/repo-name). [bắt buộc]
• TAG: Tên của thẻ cần tạo. [bắt buộc]

Tùy chọn:

• -m, --message TEXT: Mô tả của thẻ cần tạo.
• --revision TEXT: id của bản sửa đổi Git, có thể là tên nhánh, thẻ hoặc mã băm của commit.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --type, --repo-type [model|dataset|space|kernel]: Kiểu kho (model, dataset, space hoặc kernel). [mặc định: model]
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf repos tag create my-model v1.0 $ hf repos tag create my-model v1.0 -m “First release”

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf repos tag delete

Xóa một thẻ cho một kho.

Cách sử dụng:

$ hf repos tag delete [OPTIONS] REPO_ID TAG

Tham số:

• REPO_ID: ID của kho (ví dụ username/repo-name hoặc spaces/username/repo-name). [bắt buộc]
• TAG: Tên của thẻ cần xóa. [bắt buộc]

Tùy chọn:

• -y, --yes: Tự động trả lời Có cho các câu hỏi
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --type, --repo-type [model|dataset|space|kernel]: Kiểu kho (model, dataset, space hoặc kernel). [mặc định: model]
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf repos tag delete my-model v1.0

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf repos tag list

Liệt kê các thẻ cho một kho. [alias: ls]

Cách sử dụng:

$ hf repos tag list [OPTIONS] REPO_ID

Tham số:

• REPO_ID: ID của kho (ví dụ username/repo-name hoặc spaces/username/repo-name). [bắt buộc]

Tùy chọn:

• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --type, --repo-type [model|dataset|space|kernel]: Kiểu kho (model, dataset, space hoặc kernel). [mặc định: model]
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf repos tag list my-model

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf sandbox

Chạy và quản lý các sandbox thử nghiệm trên Hugging Face Jobs.

Cách sử dụng:

$ hf sandbox [OPTIONS] COMMAND [ARGS]...

Tùy chọn:

• --help: Hiển thị thông báo này và thoát.

Lệnh:

• cp: Sao chép tệp giữa máy cục bộ và sandbox (kiểu docker).
• create: Tạo một sandbox: mặc định là một VM chuyên dụng, hoặc một VM dùng chung giá rẻ với --pool.
• exec: Chạy một lệnh trong sandbox, truyền trực tiếp kết quả đầu ra.
• kill: Kết thúc một sandbox, toàn bộ host dùng chung, hoặc tất cả (—all).
• pool: Làm ấm các pool VM host và khởi tạo các sandbox chia sẻ thử nghiệm cho các workload nằm trong cùng một ranh giới tin cậy.
• process: Liệt kê và dừng các tiến trình nền đang chạy trong sandbox.
• spawn: Khởi chạy một lệnh chạy dài trong nền và trả về pid của nó (không chờ).

hf sandbox cp

Sao chép tệp giữa máy cục bộ và sandbox (kiểu docker).

Cách sử dụng:

$ hf sandbox cp [OPTIONS] SRC DST

Tham số:

• SRC: Nguồn: một đường dẫn cục bộ hoặc <sandbox_id>:<path>. [bắt buộc]
• DST: Điểm đến: một đường dẫn cục bộ hoặc <sandbox_id>:<path>. [bắt buộc]

Tùy chọn:

• --namespace TEXT: Namespace nơi công việc sẽ được thực thi. Mặc định là namespace của người dùng hiện tại.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf sandbox cp data.csv <sandbox_id>:/data/data.csv $ hf sandbox cp <sandbox_id>:/app/result.json result.json

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf sandbox create

Tạo một sandbox: mặc định là một VM chuyên dụng, hoặc một VM dùng chung giá rẻ với --pool.

Env và idle-timeout áp dụng cho sandbox ở cả hai chế độ. Khi dùng --pool, image và flavor được lấy từ pool, nên việc truyền chúng ở đây sẽ gây lỗi; --secrets cũng bị từ chối vì sandbox trong pool không có kênh secrets mã hóa (hãy dùng --env). Hãy định nghĩa pool trước bằng hf sandbox pool create.

Cách sử dụng:

$ hf sandbox create [OPTIONS] [IMAGE]

Tham số:

• [IMAGE]: Ảnh Docker (cần /bin/sh).

Tùy chọn:

• --pool TEXT: Khởi tạo một sandbox chia sẻ giá rẻ trong pool này (từ hf sandbox pool create).
• --flavor [cpu-basic|cpu-upgrade|cpu-performance|cpu-xl|t4-small|t4-medium|l4x1|l4x4|l40sx1|l40sx4|l40sx8|a10g-small|a10g-large|a10g-largex2|a10g-largex4|a100-large|a100x4|a100x8|h200|h200x2|h200x4|h200x8|rtx-pro-6000|rtx-pro-6000x2|rtx-pro-6000x4|rtx-pro-6000x8]: Flavor cho phần cứng. Chạy ‘hf jobs hardware’ để liệt kê các flavor khả dụng. Mặc định là cpu-basic.
• --idle-timeout TEXT: Tự động kết thúc sandbox sau khoảng thời gian không hoạt động này (ví dụ: ‘10m’). Mặc định là 10m.
• -e, --env TEXT: Đặt các biến môi trường. Ví dụ —env ENV=value
• -s, --secrets TEXT: Đặt các biến môi trường bí mật. Nên dùng --secrets SECRET để đọc giá trị từ môi trường của bạn (ví dụ: --secrets HF_TOKEN để truyền token Hugging Face của bạn); --secrets SECRET=value sẽ lưu giá trị vào lịch sử shell của bạn.
• -l, --label TEXT: Đặt nhãn. Ví dụ —label KEY=VALUE hoặc —label LABEL
• --env-file TEXT: Đọc một tệp chứa các biến môi trường. Sử dụng - để đọc chúng từ stdin.
• --secrets-file TEXT: Đọc một tệp chứa các biến môi trường bí mật. Sử dụng - để đọc chúng từ stdin.
• -v, --volume TEXT: Gắn một hoặc nhiều volume. Định dạng: hf://[TYPE/]SOURCE:/MOUNT_PATH[:ro]. TYPE là một trong các giá trị: models, datasets, spaces, buckets. Nếu bỏ qua, TYPE mặc định là models. models, datasets và spaces luôn được gắn ở chế độ chỉ đọc. buckets mặc định ở chế độ đọc+ghi. Ví dụ: -v hf://org/m:/data hoặc -v hf://datasets/org/ds:/data hoặc -v hf://buckets/org/b:/mnt:ro
• --namespace TEXT: Namespace nơi công việc sẽ được thực thi. Mặc định là namespace của người dùng hiện tại.
• --forward-hf-token: Chèn token HF của bạn dưới dạng HF_TOKEN trong sandbox.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf sandbox create $ hf sandbox create ubuntu:24.04 $ hf sandbox create —flavor a10g-small $ hf sandbox create —label controller-run=run-42 $ hf sandbox create —pool pool-ab12cd34ef56 —env LOG_LEVEL=debug

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf sandbox exec

Chạy một lệnh trong sandbox, truyền trực tiếp kết quả đầu ra. Kết thúc với mã thoát của lệnh.

Để bắt đầu một lệnh chạy lâu trong nền thay vì chờ nó hoàn thành, hãy sử dụng hf sandbox spawn.

Cách sử dụng:

$ hf sandbox exec [OPTIONS] SANDBOX_ID COMMAND...

Tham số:

• SANDBOX_ID: id của sandbox như được in ra bởi hf sandbox create. [bắt buộc]
• COMMAND...: Lệnh cần chạy. [bắt buộc]

Tùy chọn:

• -w, --workdir TEXT: Thư mục làm việc.
• -e, --env TEXT: Đặt các biến môi trường. Ví dụ —env ENV=value
• --env-file TEXT: Đọc một tệp chứa các biến môi trường. Sử dụng - để đọc chúng từ stdin.
• --timeout FLOAT: Kết thúc lệnh sau số giây này.
• --namespace TEXT: Namespace nơi công việc sẽ được thực thi. Mặc định là namespace của người dùng hiện tại.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf sandbox exec <sandbox_id> — python -c “print(42)” $ hf sandbox exec -w /app <sandbox_id> — pytest -x

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf sandbox kill

Kết thúc một sandbox, một host chia sẻ hoàn chỉnh, hoặc tất cả (—all).

Cách sử dụng:

$ hf sandbox kill [OPTIONS] [SANDBOX_ID]

Tham số:

• [SANDBOX_ID]: id của sandbox hoặc host cần kết thúc.

Tùy chọn:

• --all: Kết thúc mọi sandbox và host trong namespace.
• -y, --yes: Tự động trả lời Có cho các lời nhắc.
• --namespace TEXT: Namespace nơi công việc sẽ được thực thi. Mặc định là namespace của người dùng hiện tại.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf sandbox kill <sandbox_id> $ hf sandbox kill <host_id> # kết thúc toàn bộ host chia sẻ (tất cả các sandbox của nó) $ hf sandbox kill —all

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf sandbox pool

Duy trì các nhóm máy ảo host ở trạng thái sẵn sàng và khởi tạo các sandbox chia sẻ thử nghiệm cho các khối lượng công việc nằm trong cùng một ranh giới tin cậy.

Cách sử dụng:

$ hf sandbox pool [OPTIONS] COMMAND [ARGS]...

Tùy chọn:

• --help: Hiển thị thông báo này và thoát.

Lệnh:

• create: Khởi tạo một pool: khởi động một host VM ngay bây giờ, được gắn thẻ để có thể tìm thấy sau này bằng pool id của nó.
• delete: Kết thúc mọi host VM của một pool (và do đó kết thúc tất cả các sandbox của nó). [alias: rm]
• ls: Liệt kê các pool sandbox đang chạy (được nhóm từ các VM host của chúng). [biệt danh: list]

hf sandbox pool create

Làm nóng một pool: khởi động một host VM ngay bây giờ, được gắn thẻ để có thể tìm thấy nó sau này bằng pool id của nó.

Cách sử dụng:

$ hf sandbox pool create [OPTIONS] [IMAGE]

Tham số:

• [IMAGE]: Ảnh Docker cho các máy chủ (cần /bin/sh).

Tùy chọn:

• --flavor [cpu-basic|cpu-upgrade|cpu-performance|cpu-xl|t4-small|t4-medium|l4x1|l4x4|l40sx1|l40sx4|l40sx8|a10g-small|a10g-large|a10g-largex2|a10g-largex4|a100-large|a100x4|a100x8|h200|h200x2|h200x4|h200x8|rtx-pro-6000|rtx-pro-6000x2|rtx-pro-6000x4|rtx-pro-6000x8]: Flavor cho phần cứng. Chạy ‘hf jobs hardware’ để liệt kê các flavor khả dụng. Mặc định là cpu-basic.
• --per-host INTEGER RANGE: Số lượng sandbox được đóng gói trên mỗi VM host (mặc định là 50). [mặc định: 50; x>=1]
• --max-hosts INTEGER RANGE: Giới hạn tùy chọn về số lượng VM host. [x>=1]
• --idle-timeout TEXT: Tắt một host khi nó không có sandbox nào trong khoảng thời gian này (ví dụ: ‘10m’). Mặc định là 10m.
• --namespace TEXT: Namespace nơi công việc sẽ được thực thi. Mặc định là namespace của người dùng hiện tại.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf sandbox pool create $ hf sandbox pool create python:3.12 —flavor cpu-basic $ hf sandbox pool create —per-host 50 —idle-timeout 30m

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf sandbox pool delete

Kết thúc mọi VM host của một pool (và do đó kết thúc tất cả các sandbox của nó). [alias: rm]

Cách sử dụng:

$ hf sandbox pool delete [OPTIONS] POOL_ID

Tham số:

• POOL_ID: Id của pool cần xóa. [bắt buộc]

Tùy chọn:

• -y, --yes: Tự động trả lời Có cho các lời nhắc.
• --namespace TEXT: Namespace nơi công việc sẽ được thực thi. Mặc định là namespace của người dùng hiện tại.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf sandbox pool delete <pool_id>

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf sandbox pool ls

Liệt kê các pool sandbox đang chạy (được nhóm từ các VM host của chúng). [alias: list]

Cách sử dụng:

$ hf sandbox pool ls [OPTIONS]

Tùy chọn:

• --namespace TEXT: Namespace nơi công việc sẽ được thực thi. Mặc định là namespace của người dùng hiện tại.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf sandbox pool ls

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf sandbox process

Liệt kê và dừng các tiến trình nền đang chạy trong một sandbox.

Cách sử dụng:

$ hf sandbox process [OPTIONS] COMMAND [ARGS]...

Tùy chọn:

• --help: Hiển thị thông báo này và thoát.

Lệnh:

• kill: Dừng một tiến trình nền đang chạy trong sandbox.
• ls: Liệt kê các tiến trình nền đang chạy trong một sandbox (được khởi tạo bằng hf sandbox spawn). [alias: list]

hf sandbox process kill

Dừng một tiến trình nền đang chạy trong một sandbox.

Cách sử dụng:

$ hf sandbox process kill [OPTIONS] SANDBOX_ID PID

Tham số:

• SANDBOX_ID: id của sandbox như được in ra bởi hf sandbox create. [bắt buộc]
• PID: PID được in ra bởi hf sandbox process ls. [bắt buộc]

Tùy chọn:

• --namespace TEXT: Namespace nơi công việc sẽ được thực thi. Mặc định là namespace của người dùng hiện tại.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf sandbox process kill <sandbox_id> <pid>

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf sandbox process ls

Liệt kê các tiến trình nền đang chạy trong một sandbox (được khởi chạy bằng hf sandbox spawn). [alias: list]

Cách sử dụng:

$ hf sandbox process ls [OPTIONS] SANDBOX_ID

Tham số:

• SANDBOX_ID: id của sandbox như được in ra bởi hf sandbox create. [bắt buộc]

Tùy chọn:

• --namespace TEXT: Namespace nơi công việc sẽ được thực thi. Mặc định là namespace của người dùng hiện tại.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf sandbox process ls <sandbox_id>

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf sandbox spawn

Bắt đầu một lệnh chạy dài trong nền và trả về pid của nó (không chờ).

Liệt kê các tiến trình của một sandbox bằng hf sandbox process ls và dừng một tiến trình bằng hf sandbox process kill.

Cách sử dụng:

$ hf sandbox spawn [OPTIONS] SANDBOX_ID COMMAND...

Tham số:

• SANDBOX_ID: id của sandbox như được in ra bởi hf sandbox create. [bắt buộc]
• COMMAND...: Lệnh cần chạy ở chế độ nền. [bắt buộc]

Tùy chọn:

• -w, --workdir TEXT: Thư mục làm việc.
• -e, --env TEXT: Đặt các biến môi trường. Ví dụ —env ENV=value
• --env-file TEXT: Đọc một tệp chứa các biến môi trường. Sử dụng - để đọc chúng từ stdin.
• --namespace TEXT: Namespace nơi công việc sẽ được thực thi. Mặc định là namespace của người dùng hiện tại.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf sandbox spawn <sandbox_id> — python -m http.server 8000 $ hf sandbox spawn -w /app <sandbox_id> — uvicorn app:app

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf skills

Quản lý kỹ năng cho các trợ lý AI.

Cách sử dụng:

$ hf skills [OPTIONS] COMMAND [ARGS]...

Tùy chọn:

• --help: Hiển thị thông báo này và thoát.

Lệnh:

• add: Cài đặt một kỹ năng Hugging Face cho trợ lý AI.
• list: Liệt kê các kỹ năng có sẵn từ chợ Hugging Face. [alias: ls]
• preview: In ra hf-cli SKILL.md đã tạo ra stdout.
• update: Cập nhật các kỹ năng thị trường Hugging Face đã cài đặt.

hf skills add

Cài đặt một kỹ năng Hugging Face cho trợ lý AI.

Skill mặc định hf-cli được tạo cục bộ từ phiên bản CLI đã cài đặt; các skill khác được tải xuống từ Hugging Face marketplace. Vị trí mặc định là trong thư mục hiện tại (.agents/skills) hoặc ở cấp người dùng (~/.agents/skills). Skill cũng được tạo symlink vào thư mục skills của Claude Code (.claude/skills hoặc ~/.claude/skills, tuân theo CLAUDE_CONFIG_DIR nếu được đặt), trừ khi sử dụng --dest.

Cách sử dụng:

$ hf skills add [OPTIONS] [NAME]

Tham số:

• [NAME]: Tên kỹ năng trên Marketplace.

Tùy chọn:

• -g, --global: Cài đặt toàn cục (ở cấp người dùng) thay vì trong thư mục dự án hiện tại.
• --dest PATH: Cài đặt vào một thư mục đích tùy chỉnh (đường dẫn đến thư mục skills).
• --force: Ghi đè các kỹ năng hiện có trong thư mục đích.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf skills add $ hf skills add huggingface-gradio —dest=~/my-skills $ hf skills add —global $ hf skills add huggingface-gradio —global

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf skills list

Liệt kê các kỹ năng có sẵn từ chợ Hugging Face. [alias: ls]

Cách sử dụng:

$ hf skills list [OPTIONS]

Tùy chọn:

• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf skills list $ hf skills list —format json

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf skills preview

In ra tệp hf-cli SKILL.md đã tạo ra stdout.

Cách sử dụng:

$ hf skills preview [OPTIONS]

Tùy chọn:

• --help: Hiển thị thông báo này và thoát.

hf skills update

Cập nhật các kỹ năng thị trường Hugging Face đã cài đặt.

Cách sử dụng:

$ hf skills update [OPTIONS] [NAME]

Tham số:

• [NAME]: Tên kỹ năng đã cài đặt tùy chọn cần cập nhật.

Tùy chọn:

• -g, --global: Sử dụng các thư mục kỹ năng toàn cục thay vì dự án hiện tại.
• --dest PATH: Cập nhật kỹ năng trong thư mục kỹ năng tùy chỉnh.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf skills update $ hf skills update hf-cli $ hf skills update huggingface-gradio —dest=~/my-skills $ hf skills update -g

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf spaces

Tương tác với các space trên Hub.

Cách sử dụng:

$ hf spaces [OPTIONS] COMMAND [ARGS]...

Tùy chọn:

• --help: Hiển thị thông báo này và thoát.

Lệnh:

• card: Lấy thẻ Space (README) của một Space trên Hub.
• dev-mode: Bật hoặc tắt chế độ dev trên một Space.
• hardware: Liệt kê các tùy chọn phần cứng khả dụng cho Spaces.
• hot-reload: Nạp lại bất kỳ tệp Python nào của một Space mà không cần xây dựng lại và khởi động lại hoàn toàn.
• info: Lấy thông tin về một space trên Hub.
• list: Liệt kê các space trên Hub, hoặc các tệp trong kho space. [biệt danh: ls]
• logs: Lấy nhật ký chạy hoặc xây dựng của một Space.
• pause: Tạm dừng một Space.
• restart: Khởi động lại một Space.
• search: Tìm kiếm các không gian trên Hub bằng tìm kiếm ngữ nghĩa.
• secrets: Quản lý secrets cho một Space trên Hub.
• settings: Cập nhật cài đặt của một Space.
• ssh: Đăng nhập SSH vào container Dev Mode của một Space.
• templates: Liệt kê các mẫu Space có sẵn.
• variables: Quản lý các biến môi trường cho một Space trên Hub.
• volumes: Quản lý các volume cho một Space trên Hub.
• wait: Chờ cho đến khi Space hoàn tất việc build/khởi động.
• zero-gpu: Quản lý việc sử dụng ZeroGPU của bạn trên Hub.

hf spaces card

Lấy thẻ Space (README) cho một Space trên Hub.

Cách sử dụng:

$ hf spaces card [OPTIONS] SPACE_ID

Tham số:

• SPACE_ID: ID của space (ví dụ: username/repo-name). [bắt buộc]

Tùy chọn:

• --metadata: Chỉ xuất metadata từ thẻ.
• --text: Chỉ xuất phần thân văn bản (không có metadata).
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf spaces card mteb/leaderboard $ hf spaces card mteb/leaderboard —metadata $ hf spaces card mteb/leaderboard —metadata —format json $ hf spaces card mteb/leaderboard —text

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf spaces dev-mode

Bật hoặc tắt chế độ dev trên một Space.

Spaces Dev Mode giúp việc gỡ lỗi ứng dụng của bạn trở nên dễ dàng hơn và rút ngắn thời gian lặp lại trên Spaces bằng cách cho phép bạn khởi động lại ứng dụng mà không cần dừng container của Space. Việc bật dev mode yêu cầu gói PRO hoặc Team & Enterprise. Việc tắt nó (--stop) luôn được cho phép.

Xem tài liệu: https://huggingface.co/docs/hub/spaces-dev-mode

Cách sử dụng:

$ hf spaces dev-mode [OPTIONS] SPACE_ID

Tham số:

• SPACE_ID: ID của space (ví dụ: username/repo-name). [bắt buộc]

Tùy chọn:

• --stop / --no-stop: Dừng chế độ dev. [mặc định: no-stop]
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf spaces dev-mode my-user-name/deepsite

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf spaces phần cứng

Liệt kê các tùy chọn phần cứng khả dụng cho Spaces.

Cách sử dụng:

$ hf spaces hardware [OPTIONS]

Tùy chọn:

• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf spaces hardware

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf spaces hot-reload

Nạp lại (hot-reload) bất kỳ tệp Python nào của một Space mà không cần xây dựng lại (rebuild) và khởi động lại hoàn toàn.

⚠ Tính năng này đang ở giai đoạn thử nghiệm ⚠

Chỉ hoạt động với Gradio SDK (6.1+) Mở trình chỉnh sửa tương tác trừ khi chỉ định —local-file/-f.

Lệnh này vá tiến trình Python đang chạy bằng https://github.com/breuleux/jurigged (so sánh khác biệt dựa trên AST, cập nhật hàm tại chỗ, v.v.), được tích hợp với tính năng tải lại nóng (hot-reload) có sẵn của Gradio (điều này có nghĩa là các thay đổi đối với đối tượng demo của Gradio sẽ được phản ánh trong giao diện người dùng)

Lệnh này tạo một commit từ xa. Nếu bạn đang làm việc từ một bản clone cục bộ, hãy chạy git pull --autostash sau đó để đưa commit về và giữ cho trạng thái git cục bộ của bạn đồng bộ.

Cách sử dụng:

$ hf spaces hot-reload [OPTIONS] SPACE_ID [FILENAME]

Tham số:

• SPACE_ID: ID của space (ví dụ: username/repo-name). [bắt buộc]
• [FILENAME]: Đường dẫn đến tệp Python trong kho Space. Có thể bỏ qua khi đã chỉ định —local-file và đường dẫn trong kho khớp nhau.

Tùy chọn:

• -f, --local-file PATH: Đường dẫn của tệp cục bộ. Chế độ trình soạn thảo tương tác nếu không được chỉ định
• --skip-checks / --no-skip-checks: Bỏ qua các kiểm tra tương thích hot-reload. [mặc định: no-skip-checks]
• --skip-summary / --no-skip-summary: Bỏ qua việc hiển thị tóm tắt sau khi hot-reload được kích hoạt [mặc định: no-skip-summary]
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf spaces hot-reload username/repo-name app.py # Open an interactive editor to the remote app.py file $ hf spaces hot-reload username/repo-name -f app.py # Take local version from ./app.py and patch app.py remotely $ hf spaces hot-reload username/repo-name app.py -f src/app.py # Take local version from ./src/app.py

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf spaces info

Lấy thông tin về một space trên Hub.

Cách sử dụng:

$ hf spaces info [OPTIONS] SPACE_ID

Tham số:

• SPACE_ID: ID của space (ví dụ: username/repo-name). [bắt buộc]

Tùy chọn:

• --revision TEXT: id của bản sửa đổi Git, có thể là tên nhánh, thẻ hoặc mã băm của commit.
• --expand TEXT: Các thuộc tính được phân tách bằng dấu phẩy để trả về. Khi được sử dụng, chỉ các thuộc tính được liệt kê (và id) sẽ được trả về. Ví dụ: ‘—expand=likes,tags’. Hợp lệ: author, cardData, createdAt, datasets, disabled, lastModified, likes, models, private, region, resourceGroup, runtime, sdk, sha, siblings, subdomain, tags, trendingScore, usedStorage.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf spaces info enzostvs/deepsite $ hf spaces info gradio/theme_builder —expand sdk,runtime,likes

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf spaces list

Liệt kê các space trên Hub, hoặc các tệp trong một kho space. [alias: ls]

Khi được gọi không có đối số, liệt kê các space trên Hub. Khi được gọi với một space ID, liệt kê các tệp trong kho space đó.

Cách sử dụng:

$ hf spaces list [OPTIONS] [REPO_ID]

Tham số:

• [REPO_ID]: Space ID (ví dụ: username/repo-name) để liệt kê các tệp từ đó. Nếu bỏ qua, sẽ liệt kê các space.

Tùy chọn:

• --search TEXT: Câu truy vấn tìm kiếm.
• --author TEXT: Lọc theo tác giả hoặc tổ chức.
• --filter TEXT: Lọc theo thẻ (ví dụ: ‘text-classification’). Có thể sử dụng nhiều lần.
• --sort [created_at|last_modified|likes|trending_score]: Sắp xếp kết quả.
• --limit INTEGER: Giới hạn số lượng kết quả. [mặc định: 30]
• --expand TEXT: Các thuộc tính được phân tách bằng dấu phẩy để trả về. Khi được sử dụng, chỉ các thuộc tính được liệt kê (và id) sẽ được trả về. Ví dụ: ‘—expand=likes,tags’. Hợp lệ: author, cardData, createdAt, datasets, disabled, lastModified, likes, models, private, region, resourceGroup, runtime, sdk, sha, siblings, subdomain, tags, trendingScore, usedStorage.
• -h, --human-readable: Hiển thị kích thước ở định dạng dễ đọc (chỉ áp dụng khi liệt kê tệp).
• --tree: Liệt kê các tệp theo định dạng cây (chỉ dùng để liệt kê tệp).
• -R, --recursive: Liệt kê các tệp đệ quy (chỉ dùng để liệt kê tệp).
• --revision TEXT: id của bản sửa đổi Git, có thể là tên nhánh, thẻ hoặc mã băm của commit.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf spaces ls —limit 10 $ hf spaces ls —search “chatbot” —author huggingface $ hf spaces ls victor/deepsite $ hf spaces ls victor/deepsite -R $ hf spaces ls victor/deepsite —tree -h

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf spaces logs

Lấy nhật ký chạy hoặc xây dựng của một Space.

Mặc định, in ra nhật ký chạy hiện có và thoát (không chặn, giống như docker logs). Sử dụng —follow/-f để phát trực tiếp cho đến khi máy chủ đóng luồng. Sử dụng —build để xem nhật ký build của container thay vào đó (hữu ích khi một Space bị kẹt trong BUILD_ERROR).

Cách sử dụng:

$ hf spaces logs [OPTIONS] SPACE_ID

Tham số:

• SPACE_ID: ID của space (ví dụ: username/repo-name). [bắt buộc]

Tùy chọn:

• --build: Lấy nhật ký build của container thay vì nhật ký chạy. Hữu ích khi một Space bị kẹt trong BUILD_ERROR.
• -f, --follow: Theo dõi đầu ra của log (dòng chảy cho đến khi máy chủ đóng dòng). Nếu không có cờ này, chỉ các log hiện có sẽ được in ra.
• -n, --tail INTEGER: Số dòng cần hiển thị từ cuối nhật ký.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf spaces logs username/my-space $ hf spaces logs username/my-space —build $ hf spaces logs -f username/my-space $ hf spaces logs -n 50 username/my-space

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf spaces pause

Tạm dừng một Space.

Cách sử dụng:

$ hf spaces pause [OPTIONS] SPACE_ID

Tham số:

• SPACE_ID: ID của space (ví dụ: username/repo-name). [bắt buộc]

Tùy chọn:

• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $c hf spaces pause username/my-space

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf spaces restart

Khởi động lại một Space.

Cách sử dụng:

$ hf spaces restart [OPTIONS] SPACE_ID

Tham số:

• SPACE_ID: ID của space (ví dụ: username/repo-name). [bắt buộc]

Tùy chọn:

• --factory-reboot: Xây dựng lại Space từ đầu mà không sử dụng bộ nhớ đệm build.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf spaces restart username/my-space $ hf spaces restart username/my-space —factory-reboot

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf spaces search

Tìm kiếm các không gian trên Hub bằng tìm kiếm ngữ nghĩa.

Cách sử dụng:

$ hf spaces search [OPTIONS] QUERY

Tham số:

• QUERY: Truy vấn tìm kiếm. [bắt buộc]

Tùy chọn:

• --filter TEXT: Lọc theo thẻ (ví dụ: ‘text-classification’). Có thể sử dụng nhiều lần.
• --sdk TEXT: Lọc theo SDK (ví dụ: gradio, docker, static).
• --include-non-running / --no-include-non-running: Bao gồm các không gian không chạy trong kết quả. [mặc định: no-include-non-running]
• --description / --no-description: Hiển thị mô tả do AI tạo ra. [mặc định: no-description]
• --limit INTEGER: Giới hạn số lượng kết quả. [mặc định: 10]
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf spaces search “generate image” $ hf spaces search “identify objects in pictures” —sdk gradio —limit 5 $ hf spaces search “remove background from photo” —description —json

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf spaces secrets

Quản lý thông tin bí mật cho một Space trên Hub.

Cách sử dụng:

$ hf spaces secrets [OPTIONS] COMMAND [ARGS]...

Tùy chọn:

• --help: Hiển thị thông báo này và thoát.

Lệnh:

• add: Thêm hoặc cập nhật secrets cho một Space.
• delete: Xóa một bí mật khỏi Space.
• list: Liệt kê các bí mật của một Space. [alias: ls]

hf spaces secrets add

Thêm hoặc cập nhật secrets cho một Space.

Cách sử dụng:

$ hf spaces secrets add [OPTIONS] SPACE_ID

Tham số:

• SPACE_ID: ID của space (ví dụ: username/repo-name). [bắt buộc]

Tùy chọn:

• -s, --secrets TEXT: Đặt các biến môi trường bí mật. Nên dùng --secrets SECRET để đọc giá trị từ môi trường của bạn (ví dụ: --secrets HF_TOKEN để truyền token Hugging Face của bạn); --secrets SECRET=value sẽ lưu giá trị vào lịch sử shell của bạn.
• --secrets-file TEXT: Đọc một tệp chứa các biến môi trường bí mật. Sử dụng - để đọc chúng từ stdin.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf spaces secrets add username/my-space -s HF_TOKEN $ hf spaces secrets add username/my-space -s OPENAI_API_KEY=sk-… -s ANTHROPIC_API_KEY=sk-… $ hf spaces secrets add username/my-space —secrets-file .env.secrets

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf spaces secrets delete

Xóa một bí mật khỏi một Space.

Cách sử dụng:

$ hf spaces secrets delete [OPTIONS] SPACE_ID KEY

Tham số:

• SPACE_ID: ID của space (ví dụ: username/repo-name). [bắt buộc]
• KEY: Tên của bí mật cần xóa. [bắt buộc]

Tùy chọn:

• -y, --yes: Tự động trả lời Có cho các câu hỏi.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf spaces secrets delete username/my-space HF_TOKEN $ hf spaces secrets delete username/my-space HF_TOKEN —yes

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf spaces secrets list

Liệt kê các bí mật của một Space. Giá trị bí mật chỉ ghi được và không được trả về. [alias: ls]

Cách sử dụng:

$ hf spaces secrets list [OPTIONS] SPACE_ID

Tham số:

• SPACE_ID: ID của space (ví dụ: username/repo-name). [bắt buộc]

Tùy chọn:

• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf spaces secrets ls username/my-space

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf spaces settings

Cập nhật cài đặt của một Space.

Cách sử dụng:

$ hf spaces settings [OPTIONS] SPACE_ID

Tham số:

• SPACE_ID: ID của space (ví dụ: username/repo-name). [bắt buộc]

Tùy chọn:

• --sleep-time INTEGER: Thời gian chờ (tính bằng giây) sau đó Space sẽ chuyển sang trạng thái ngủ. Sử dụng -1 để không bao giờ ngủ. Chỉ khả dụng trên phần cứng nâng cấp.
• --hardware [cpu-basic|cpu-upgrade|zero-a10g|t4-small|t4-medium|l4x1|l4x4|l40sx1|l40sx4|l40sx8|a10g-small|a10g-large|a10g-largex2|a10g-largex4|a100-large|a100x4|a100x8|rtx-pro-6000|rtx-pro-6000x2|rtx-pro-6000x4|rtx-pro-6000x8]: Loại phần cứng Space (ví dụ: ‘cpu-basic’, ‘t4-medium’, ‘l4x4’). Chạy ‘hf spaces hardware’ để liệt kê các tùy chọn khả dụng.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf spaces settings username/my-space —sleep-time 300 $ hf spaces settings username/my-space —hardware t4-medium

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf spaces ssh

Truy cập vào container Dev Mode của một Space qua SSH.

Yêu cầu Dev Mode đang chạy trên Space và khóa SSH công khai của bạn đã được đăng ký tại https://huggingface.co/settings/keys.

Xem: https://huggingface.co/docs/hub/spaces-dev-mode

Cách sử dụng:

$ hf spaces ssh [OPTIONS] SPACE_ID

Tham số:

• SPACE_ID: ID của space (ví dụ: username/repo-name). [bắt buộc]

Tùy chọn:

• -i, --identity-file PATH: Đường dẫn đến tệp danh tính SSH (được chuyển tiếp đến ssh -i).
• --dry-run: In ra lệnh SSH thay vì thực thi nó.
• --auto: Bật Dev Mode mà không hỏi nếu chưa được bật.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf spaces ssh username/my-space $ hf spaces ssh username/my-space —dry-run $ hf spaces ssh username/my-space -i ~/.ssh/id_ed25519 $ hf spaces ssh username/my-space —auto

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf spaces templates

Liệt kê các mẫu Space khả dụng.

repo_id (hoặc name) của một template có thể được truyền vào hf repos create --template ... để tạo một Space mới từ template đó.

Cách sử dụng:

$ hf spaces templates [OPTIONS]

Tùy chọn:

• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf spaces templates

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf spaces variables

Quản lý các biến môi trường cho một Space trên Hub.

Cách sử dụng:

$ hf spaces variables [OPTIONS] COMMAND [ARGS]...

Tùy chọn:

• --help: Hiển thị thông báo này và thoát.

Lệnh:

• add: Thêm hoặc cập nhật các biến môi trường cho một Space.
• delete: Xóa một biến môi trường khỏi một Space.
• list: Liệt kê các biến môi trường cho một Space. [alias: ls]

hf spaces variables add

Thêm hoặc cập nhật các biến môi trường cho một Space.

Cách sử dụng:

$ hf spaces variables add [OPTIONS] SPACE_ID

Tham số:

• SPACE_ID: ID của space (ví dụ: username/repo-name). [bắt buộc]

Tùy chọn:

• -e, --env TEXT: Đặt các biến môi trường. Ví dụ —env ENV=value
• --env-file TEXT: Đọc một tệp chứa các biến môi trường. Sử dụng - để đọc chúng từ stdin.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf spaces variables add username/my-space -e DEBUG=1 $ hf spaces variables add username/my-space -e MODEL_ID=gpt2 -e MAX_TOKENS=512 $ hf spaces variables add username/my-space —env-file .env

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf spaces variables delete

Xóa một biến môi trường khỏi một Space.

Cách sử dụng:

$ hf spaces variables delete [OPTIONS] SPACE_ID KEY

Tham số:

• SPACE_ID: ID của space (ví dụ: username/repo-name). [bắt buộc]
• KEY: Tên của biến cần xóa. [bắt buộc]

Tùy chọn:

• -y, --yes: Tự động trả lời Có cho các câu hỏi.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $ hf spaces variables delete username/my-space DEBUG $ hf spaces variables delete username/my-space DEBUG —yes

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf spaces variables list

Liệt kê các biến môi trường cho một Space. [alias: ls]

Cách sử dụng:

$ hf spaces variables list [OPTIONS] SPACE_ID

Tham số:

• SPACE_ID: ID của space (ví dụ: username/repo-name). [bắt buộc]

Tùy chọn:

• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.

Ví dụ $c hf spaces variables ls username/my-space

Tìm hiểu thêm Sử dụng hf <command> --help để biết thêm thông tin về một lệnh. Đọc tài liệu tại https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf spaces volumes

Quản lý các ổ đĩa cho một Space trên Hub.

Cách sử dụng:

$ hf spaces volumes [OPTIONS] COMMAND [ARGS]...

Tùy chọn:

• --help: Hiển thị thông báo này và thoát.

Lệnh:

• delete: Xóa tất cả các volume khỏi một Space.
• list: Liệt kê các volume được gắn trong một Space. [alias: ls]
• set: Đặt (thay thế) các volume cho một Space.

hf spaces volumes delete

Xóa tất cả các volume khỏi một Space.

Cách sử dụng:

$ hf spaces volumes delete [OPTIONS] SPACE_ID

Tham số:

• SPACE_ID: ID của space (ví dụ: username/repo-name). [bắt buộc]

Tùy chọn:

• -y, --yes: Tự động trả lời Có cho các câu hỏi.
• --token TEXT: Một User Access Token được tạo từ https://huggingface.co/settings/tokens.
• --help: Hiển thị thông báo này và thoát.