hf

Hugging Face Hub CLI

用法:

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

Options:

• --install-completion：安裝當前 Shell 的自動補全功能。
• --show-completion：顯示當前 Shell 的自動補全設定，以便複製或自訂安裝。
• --help：顯示此訊息並退出。

指令 (Commands):

• auth：管理身分驗證（登入、登出等）。
• buckets：與儲存桶 (buckets) 互動的指令。
• cache：管理本機快取目錄。
• collections：與 Hub 上的收藏集互動。
• datasets：與 Hub 上的資料集互動。
• discussions：管理 Hub 上的討論與合併請求 (pull requests)……
• download：從 Hub 下載檔案。
• endpoints：管理 Hugging Face 推論端點 (Inference Endpoints)。
• env：列印環境相關資訊。
• extensions：管理 hf CLI 擴充功能。[別名：ext]
• jobs：在 Hub 上執行並管理作業 (Jobs)。
• lfs-enable-largefiles：設定您的儲存庫以啟用上傳……
• lfs-multipart-upload：內部的 git-lfs 自訂傳輸代理，用於……
• models：與 Hub 上的模型互動。
• papers：與 Hub 上的學術論文互動。
• repos：管理 Hub 上的儲存庫。[別名：repo]
• skills：管理 AI 助手的技能。
• spaces：與 Hub 上的 Spaces 互動。
• sync：同步本機目錄與……之間的檔案。
• update：將 hf CLI 更新至最新版本。
• upload：上傳檔案或資料夾至 Hub。
• upload-large-folder：上傳大型資料夾至 Hub。
• version：列印 hf 版本資訊。
• webhooks：管理 Hub 上的 Webhooks。

hf auth

管理身分驗證（登入、登出等）。

用法:

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

Options:

• --help：顯示此訊息並退出。

指令 (Commands):

• list：列出所有已儲存的存取權杖 (access tokens)。[別名：ls]
• login：使用來自……的權杖登入。
• logout：登出特定的權杖。
• switch：切換存取權杖。
• token：將當前存取權杖列印至標準輸出 (stdout)。
• whoami：查詢您當前登入的 huggingface.co 帳號……

hf auth list

列出所有已儲存的存取權杖。[別名：ls]

用法:

$ hf auth list [OPTIONS]

Options:

• --help：顯示此訊息並退出。

範例 $ hf auth list

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf auth login

使用來自 huggingface.co/settings/tokens 的權杖進行登入。

用法:

$ hf auth login [OPTIONS]

Options:

• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --add-to-git-credential / --no-add-to-git-credential：儲存至 git 憑證輔助程式。僅在您打算直接執行 git 指令時才有用。[預設：no-add-to-git-credential]
• --force / --no-force：即使已登入，也強制重新登入。[預設：no-force]
• --help：顯示此訊息並退出。

範例 $ hf auth login $ hf auth login —token $HF_TOKEN $ hf auth login —token $HF_TOKEN —add-to-git-credential $ hf auth login —force

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf auth logout

登出特定的權杖。

用法:

$ hf auth logout [OPTIONS]

Options:

• --token-name TEXT：要登出的權杖名稱
• --help：顯示此訊息並退出。

範例 $ hf auth logout $ hf auth logout —token-name my-token

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf auth switch

切換存取權杖。

用法:

$ hf auth switch [OPTIONS]

Options:

• --token-name TEXT：要切換到的權杖名稱
• --add-to-git-credential / --no-add-to-git-credential：儲存至 git 憑證輔助程式。僅在您打算直接執行 git 指令時才有用。[預設：no-add-to-git-credential]
• --help：顯示此訊息並退出。

範例 $ hf auth switch $ hf auth switch —token-name my-token

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf auth token

將當前存取權杖列印至標準輸出。

用法:

$ hf auth token [OPTIONS]

Options:

• --help：顯示此訊息並退出。

範例 $ hf auth token $ hf auth token | xargs curl -H ‘Authorization: Bearer {}’

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf auth whoami

查詢您當前是以哪個 huggingface.co 帳號登入的。

用法:

$ hf auth whoami [OPTIONS]

Options:

• --help：顯示此訊息並退出。

範例 $ hf auth whoami $ hf auth whoami —format json

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf buckets

與儲存桶 (buckets) 互動的指令。

用法:

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

Options:

• --help：顯示此訊息並退出。

指令 (Commands):

• cp：複製檔案到儲存桶或從儲存桶複製。
• create：建立一個新儲存桶。
• delete：刪除一個儲存桶。
• info：取得關於儲存桶的資訊。
• list：列出儲存桶或儲存桶內的檔案。[別名：ls]
• move：移動 (重新命名) 儲存桶至新名稱或……
• remove：從儲存桶移除檔案。[別名：rm]
• sync：同步本機目錄與……之間的檔案。

hf buckets cp

複製檔案到儲存桶或從儲存桶複製。

用法:

$ hf buckets cp [OPTIONS] SRC [DST]

引數 (Arguments):

• SRC：來源：本機檔案、任何 hf:// URI（模型、資料集、儲存桶），或 - 代表 stdin [必要]
• [DST]：目的地：本機路徑、儲存桶 hf://… URI，或 - 代表 stdout

Options:

• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ hf buckets cp hf://buckets/user/my-bucket/config.json $ hf buckets cp hf://buckets/user/my-bucket/config.json ./data/ $ hf buckets cp hf://buckets/user/my-bucket/config.json my-config.json $ hf buckets cp hf://buckets/user/my-bucket/config.json - $ hf buckets cp my-config.json hf://buckets/user/my-bucket $ hf buckets cp my-config.json hf://buckets/user/my-bucket/logs/ $ hf buckets cp my-config.json hf://buckets/user/my-bucket/remote-config.json $ hf buckets cp - hf://buckets/user/my-bucket/config.json $ hf buckets cp hf://buckets/user/my-bucket/logs hf://buckets/user/archive-bucket/ # 巢狀放入 logs/ 目錄 $ hf buckets cp hf://buckets/user/my-bucket/logs/ hf://buckets/user/archive-bucket/ # 僅複製內容 $ hf buckets cp hf://datasets/user/my-dataset/processed/ hf://buckets/user/my-bucket/dataset/processed/

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf buckets create

建立一個新儲存桶。

用法:

$ hf buckets create [OPTIONS] BUCKET_ID

引數 (Arguments):

• BUCKET_ID：儲存桶 ID：bucket_name、namespace/bucket_name，或 hf://buckets/namespace/bucket_name [必要]

Options:

• --private：建立一個私人儲存桶。
• --region [us|eu]：建立儲存桶所在的雲端區域。可以是 ‘us’ 或 ‘eu’。需要 Team 方案或以上。
• --exist-ok：若儲存桶已存在，則不引發錯誤。
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ 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

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf buckets delete

刪除一個儲存桶。

此指令會刪除整個儲存桶及其所有內容。若要移除個別檔案，請使用 hf buckets rm。

用法:

$ hf buckets delete [OPTIONS] BUCKET_ID

引數 (Arguments):

• BUCKET_ID：儲存桶 ID：namespace/bucket_name 或 hf://buckets/namespace/bucket_name [必要]

Options:

• -y, --yes：跳過確認提示。
• --missing-ok：若儲存桶不存在，則不引發錯誤。
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ 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

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf buckets info

取得關於儲存桶的資訊。

用法:

$ hf buckets info [OPTIONS] BUCKET_ID

引數 (Arguments):

• BUCKET_ID：儲存桶 ID：namespace/bucket_name 或 hf://buckets/namespace/bucket_name [必要]

Options:

• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ hf buckets info user/my-bucket $ hf buckets info hf://buckets/user/my-bucket

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf buckets list

列出儲存桶或儲存桶內的檔案。[別名：ls]

不帶引數或僅帶命名空間 (namespace) 呼叫時，列出儲存桶。當提供儲存桶 ID (namespace/bucket_name) 時，列出該儲存桶中的檔案。

用法:

$ hf buckets list [OPTIONS] [ARGUMENT]

引數 (Arguments):

• [ARGUMENT]：列出儲存桶的命名空間（使用者或組織），或列出檔案的儲存桶 ID (namespace/bucket_name(/prefix) 或 hf://buckets/…)。

Options:

• -h, --human-readable：以人類可讀格式顯示大小。
• --tree：以樹狀格式列出檔案（僅適用於列出檔案時）。
• -R, --recursive：遞迴列出檔案（僅適用於列出檔案時）。
• --search TEXT：搜尋查詢。
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ 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

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf buckets move

移動 (重新命名) 儲存桶至新名稱或命名空間。

用法:

$ hf buckets move [OPTIONS] FROM_ID TO_ID

引數 (Arguments):

• FROM_ID：來源儲存桶 ID：namespace/bucket_name 或 hf://buckets/namespace/bucket_name [必要]
• TO_ID：目的地儲存桶 ID：namespace/bucket_name 或 hf://buckets/namespace/bucket_name [必要]

Options:

• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ 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

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf buckets remove

從儲存桶移除檔案。[別名：rm]

若要刪除整個儲存桶，請改用 hf buckets delete。

用法:

$ hf buckets remove [OPTIONS] ARGUMENT

引數 (Arguments):

• ARGUMENT：儲存桶路徑：namespace/bucket_name/path 或 hf://buckets/namespace/bucket_name/path。配合 —recursive 使用時，也接受 namespace/bucket_name 來指定所有檔案。[必要]

Options:

• -R, --recursive：遞迴移除給定前綴下的檔案。
• -y, --yes：跳過確認提示。
• --dry-run：預覽將要刪除的內容而不執行實際刪除。
• --include TEXT：僅包含符合模式的檔案（可指定多個）。需要 —recursive。
• --exclude TEXT：排除符合模式的檔案（可指定多個）。需要 —recursive。
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ 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

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf buckets sync

同步本機目錄與儲存桶之間的檔案。

用法:

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

引數 (Arguments):

• [SOURCE]：來源路徑：本機目錄或 hf://buckets/namespace/bucket_name(/prefix)
• [DEST]：目的地路徑：本機目錄或 hf://buckets/namespace/bucket_name(/prefix)

Options:

• --delete / --no-delete：刪除目的地中不存在於來源的檔案。[預設：no-delete]
• --ignore-times：僅根據大小跳過檔案，忽略修改時間。
• --ignore-sizes：僅根據修改時間跳過檔案，忽略大小。
• --plan TEXT：將同步計畫儲存至 JSONL 檔案以供審閱，而不執行。
• --apply TEXT：套用先前儲存的計畫檔案。
• --dry-run：將同步計畫以 JSONL 格式列印至標準輸出而不執行。
• --include TEXT：包含符合模式的檔案（可指定多個）。
• --exclude TEXT：排除符合模式的檔案（可指定多個）。
• --filter-from TEXT：從檔案讀取包含/排除模式。
• --existing：跳過在接收端建立新檔案（僅更新現有檔案）。
• --ignore-existing：跳過更新在接收端已存在的檔案（僅建立新檔案）。
• -v, --verbose：顯示詳細的日誌與原因。
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ 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 .

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf cache

管理本機快取目錄。

用法:

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

Options:

• --help：顯示此訊息並退出。

指令 (Commands):

• list：列出快取的儲存庫或修訂版本。[別名：ls]
• prune：從快取中移除分離的修訂版本。
• rm：移除快取的儲存庫或修訂版本。
• verify：驗證單一儲存庫的校驗和 (checksums)……

hf cache list

列出快取的儲存庫或修訂版本。[別名：ls]

用法:

$ hf cache list [OPTIONS]

Options:

• --cache-dir TEXT：要掃描的快取目錄（預設為 Hugging Face 快取）。
• --revisions / --no-revisions：在輸出中包含修訂版本，而非聚合的儲存庫。[預設：no-revisions]
• -f, --filter TEXT：過濾項目（例如 ‘size>1GB’, ‘type=model’, ‘accessed>7d’）。可多次使用。
• --sort [accessed|accessed:asc|accessed:desc|modified|modified:asc|modified:desc|name|name:asc|name:desc|size|size:asc|size:desc]：按鍵排序項目。支援的鍵：‘accessed’、‘modified’、‘name’、‘size’。附加 ‘:asc’ 或 ‘:desc’ 明確設定順序（例如 ‘modified:asc’）。預設：‘accessed’、‘modified’、‘size’ 預設為 ‘desc’（最新/最大優先）；‘name’ 預設為 ‘asc’（字母順序）。
• --limit INTEGER：限制返回的結果數量。排序後僅返回前 N 個項目。
• --help：顯示此訊息並退出。

範例 $ hf cache ls $ hf cache ls —revisions $ hf cache ls —filter “size>1GB” —limit 20 $ hf cache ls —format json

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf cache prune

從快取中移除分離的修訂版本。

用法:

$ hf cache prune [OPTIONS]

Options:

• --cache-dir TEXT：要掃描的快取目錄（預設為 Hugging Face 快取）。
• -y, --yes：跳過確認提示。
• --dry-run / --no-dry-run：預覽刪除而不執行實際刪除。[預設：no-dry-run]
• --help：顯示此訊息並退出。

範例 $ hf cache prune $ hf cache prune —dry-run

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf cache rm

移除快取的儲存庫或修訂版本。

用法:

$ hf cache rm [OPTIONS] TARGETS...

引數 (Arguments):

• TARGETS...：一個或多個要刪除的儲存庫 ID（例如 model/bert-base-uncased）、儲存庫級別的 hf:// URI 或修訂版本雜湊值。[必要]

Options:

• --cache-dir TEXT：要掃描的快取目錄（預設為 Hugging Face 快取）。
• -y, --yes：跳過確認提示。
• --dry-run / --no-dry-run：預覽刪除而不執行實際刪除。[預設：no-dry-run]
• --help：顯示此訊息並退出。

範例 $ hf cache rm model/gpt2 $ hf cache rm hf://models/openai-community/gpt2 $ hf cache rm <revision_hash> $ hf cache rm model/gpt2 —dry-run $ hf cache rm model/gpt2 —yes

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf cache verify

驗證來自快取或本機目錄的單一儲存庫修訂版本的校驗和。

範例

• 驗證快取中的主修訂版本：hf cache verify gpt2
• 驗證特定修訂版本：hf cache verify gpt2 --revision refs/pr/1
• 驗證資料集：hf cache verify karpathy/fineweb-edu-100b-shuffle --repo-type dataset
• 驗證本機目錄：hf cache verify deepseek-ai/DeepSeek-OCR --local-dir /path/to/repo

用法:

$ hf cache verify [OPTIONS] REPO_ID

引數 (Arguments):

• REPO_ID：儲存庫 ID（例如 username/repo-name 或 spaces/username/repo-name）。[必要]

Options:

• --type, --repo-type [model|dataset|space]：儲存庫類型（model、dataset 或 space）。[預設：model]
• --revision TEXT：Git 修訂 ID，可以是分支名稱、標籤或提交雜湊值。
• --cache-dir TEXT：驗證來自快取的檔案時使用的快取目錄（預設為 Hugging Face 快取）。
• --local-dir TEXT：若設定，則驗證此目錄下的檔案而非快取。
• --fail-on-missing-files：如果有些檔案在遠端存在但在本機遺失，則失敗。
• --fail-on-extra-files：如果有些檔案在本機存在但未出現在遠端修訂版本中，則失敗。
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ hf cache verify gpt2 $ hf cache verify gpt2 —revision refs/pr/1 $ hf cache verify my-dataset —repo-type dataset

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf collections

與 Hub 上的收藏集互動。

用法:

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

Options:

• --help：顯示此訊息並退出。

指令 (Commands):

• add-item：將項目新增至收藏集。
• create：在 Hub 上建立新收藏集。
• delete：從 Hub 刪除收藏集。
• delete-item：從收藏集刪除項目。
• info：取得關於 Hub 上收藏集的資訊。
• list：列出 Hub 上的收藏集。[別名：ls]
• update：更新 Hub 上收藏集的元資料 (metadata)。
• update-item：更新收藏集中的項目。

hf collections add-item

將項目新增至收藏集。

用法:

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

引數 (Arguments):

• COLLECTION_SLUG：收藏集 slug（例如 ‘username/collection-slug’）。[必要]
• ITEM_ID：要新增的項目 ID（儲存庫使用 repo_id，論文使用 paper ID）。[必要]
• ITEM_TYPE:{model|dataset|space|paper|collection|bucket}：項目類型（model、dataset、space、paper、collection 或 bucket）。[必要]

Options:

• --note TEXT：附註於項目的說明（最多 500 字元）。
• --exists-ok / --no-exists-ok：如果項目已在收藏集中，則不引發錯誤。[預設：no-exists-ok]
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ 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

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf collections create

在 Hub 上建立新收藏集。

用法:

$ hf collections create [OPTIONS] TITLE

引數 (Arguments):

• TITLE：收藏集標題。[必要]

Options:

• --namespace TEXT：命名空間（使用者名稱或組織名稱）。預設為已驗證的使用者。
• --description TEXT：收藏集的描述。
• --private / --no-private：建立私人收藏集。[預設：no-private]
• --exists-ok / --no-exists-ok：如果收藏集已存在，則不引發錯誤。[預設：no-exists-ok]
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ 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

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf collections delete

從 Hub 刪除收藏集。

用法:

$ hf collections delete [OPTIONS] COLLECTION_SLUG

引數 (Arguments):

• COLLECTION_SLUG：收藏集 slug（例如 ‘username/collection-slug’）。[必要]

Options:

• --missing-ok / --no-missing-ok：如果收藏集不存在，則不引發錯誤。[預設：no-missing-ok]
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ hf collections delete username/my-collection $ hf collections delete username/my-collection —missing-ok

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf collections delete-item

從收藏集刪除項目。

用法:

$ hf collections delete-item [OPTIONS] COLLECTION_SLUG ITEM_OBJECT_ID

引數 (Arguments):

• COLLECTION_SLUG：收藏集 slug（例如 ‘username/collection-slug’）。[必要]
• ITEM_OBJECT_ID：收藏集中項目的 ID（可從 ‘hf collections info’ 回傳的 item_object_id 欄位取得）。[必要]

Options:

• --missing-ok / --no-missing-ok：如果項目不存在，則不引發錯誤。[預設：no-missing-ok]
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

hf collections info

取得關於 Hub 上收藏集的資訊。

用法:

$ hf collections info [OPTIONS] COLLECTION_SLUG

引數 (Arguments):

• COLLECTION_SLUG：收藏集 slug（例如 ‘username/collection-slug’）。[必要]

Options:

• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ hf collections info username/my-collection-slug

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf collections list

列出 Hub 上的收藏集。[別名：ls]

用法:

$ hf collections list [OPTIONS]

Options:

• --owner TEXT：依擁有者使用者名稱或組織名稱過濾。
• --item TEXT：過濾包含特定項目的收藏集（例如 “models/gpt2”, “datasets/squad”, “papers/2311.12983”）。
• --sort [lastModified|trending|upvotes]：依最後修改時間、趨勢或按讚數排序結果。
• --limit INTEGER：限制結果數量。[預設：10]
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ hf collections ls $ hf collections ls —owner nvidia $ hf collections ls —item models/teknium/OpenHermes-2.5-Mistral-7B —limit 10

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf collections update

更新 Hub 上收藏集的元資料。

用法:

$ hf collections update [OPTIONS] COLLECTION_SLUG

引數 (Arguments):

• COLLECTION_SLUG：收藏集 slug（例如 ‘username/collection-slug’）。[必要]

Options:

• --title TEXT：收藏集的新標題。
• --description TEXT：收藏集的新描述。
• --position INTEGER：收藏集在擁有者清單中的新位置。
• --private / --no-private：收藏集是否應為私人。
• --theme TEXT：收藏集的主題顏色（例如 ‘green’, ‘blue’）。
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ 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

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf collections update-item

更新收藏集中的項目。

用法:

$ hf collections update-item [OPTIONS] COLLECTION_SLUG ITEM_OBJECT_ID

引數 (Arguments):

• COLLECTION_SLUG：收藏集 slug（例如 ‘username/collection-slug’）。[必要]
• ITEM_OBJECT_ID：收藏集中項目的 ID（來自 ‘item_object_id’ 欄位，而非 repo_id）。[必要]

Options:

• --note TEXT：項目的新說明（最多 500 字元）。
• --position INTEGER：項目在收藏集中的新位置。
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ 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

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf datasets

與 Hub 上的資料集互動。

用法:

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

Options:

• --help：顯示此訊息並退出。

指令 (Commands):

• card：取得資料集的資料集卡片 (README)……
• info：取得關於 Hub 上資料集的資訊。
• leaderboard：列出資料集排行榜中的模型分數。
• list：列出 Hub 上的資料集，或資料集 repo 中的檔案。[別名：ls]
• parquet：列出資料集可用的 Parquet 檔案網址……
• sql：執行原始 SQL 查詢以使用 DuckDB……

hf datasets card

取得 Hub 上資料集的資料集卡片 (README)。

用法:

$ hf datasets card [OPTIONS] DATASET_ID

引數 (Arguments):

• DATASET_ID：資料集 ID（例如 username/repo-name）。[必要]

Options:

• --metadata：僅輸出卡片中的元資料。
• --text：僅輸出文字主體（無元資料）。
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ 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

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf datasets info

取得關於 Hub 上資料集的資訊。

用法:

$ hf datasets info [OPTIONS] DATASET_ID

引數 (Arguments):

• DATASET_ID：資料集 ID（例如 username/repo-name）。[必要]

Options:

• --revision TEXT：Git 修訂 ID，可以是分支名稱、標籤或提交雜湊值。
• --expand TEXT：要返回的屬性（以逗號分隔）。使用時，僅返回列出的屬性（以及 id）。範例：‘—expand=downloads,likes,tags’。有效值：author, cardData, citation, createdAt, description, disabled, downloads, downloadsAllTime, gated, lastModified, likes, mainSize, paperswithcode_id, private, resourceGroup, sha, siblings, tags, trendingScore, usedStorage。
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ hf datasets info HuggingFaceFW/fineweb $ hf datasets info my-dataset —expand downloads,likes,tags

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf datasets leaderboard

列出資料集排行榜中的模型分數。此指令有助於尋找特定任務的最佳模型或按基準測試分數比較模型。使用 ‘hf datasets ls —filter benchmark:official’ 列出可用的排行榜。

用法:

$ hf datasets leaderboard [OPTIONS] DATASET_ID

引數 (Arguments):

• DATASET_ID：基準測試資料集 ID（例如 SWE-bench/SWE-bench_Verified）。[必要]

Options:

• --limit INTEGER：限制結果數量。[預設：20]
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ 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 # 列出可用的排行榜

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf datasets list

列出 Hub 上的資料集，或資料集 repo 中的檔案。[別名：ls]

不帶引數呼叫時，列出 Hub 上的資料集。當提供資料集 ID 時，列出該資料集 repo 中的檔案。

用法:

$ hf datasets list [OPTIONS] [REPO_ID]

引數 (Arguments):

• [REPO_ID]：要列出檔案的資料集 ID（例如 username/repo-name）。若省略，則列出資料集。

Options:

• --search TEXT：搜尋查詢。
• --author TEXT：按作者或組織過濾。
• --filter TEXT：按標籤過濾（例如 ‘text-classification’）。可多次使用。
• --sort [created_at|downloads|last_modified|likes|trending_score]：排序結果。
• --limit INTEGER：限制結果數量。[預設：30]
• --expand TEXT：要返回的屬性（以逗號分隔）。使用時，僅返回列出的屬性（以及 id）。範例：‘—expand=downloads,likes,tags’。有效值：author, cardData, citation, createdAt, description, disabled, downloads, downloadsAllTime, gated, lastModified, likes, mainSize, paperswithcode_id, private, resourceGroup, sha, siblings, tags, trendingScore, usedStorage。
• -h, --human-readable：以人類可讀格式顯示大小（僅適用於列出檔案時）。
• --tree：以樹狀格式列出檔案（僅適用於列出檔案時）。
• -R, --recursive：遞迴列出檔案（僅適用於列出檔案時）。
• --revision TEXT：Git 修訂 ID，可以是分支名稱、標籤或提交雜湊值。
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ 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

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf datasets parquet

列出資料集可用的 Parquet 檔案網址。

用法:

$ hf datasets parquet [OPTIONS] DATASET_ID

引數 (Arguments):

• DATASET_ID：資料集 ID（例如 username/repo-name）。[必要]

Options:

• --subset TEXT：按子集/配置過濾 Parquet 項目。
• --split TEXT：按分割過濾 Parquet 項目。
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ 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

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf datasets sql

對資料集 Parquet 網址執行原始 SQL 查詢 (使用 DuckDB)。

用法:

$ hf datasets sql [OPTIONS] SQL

引數 (Arguments):

• SQL：要執行的原始 SQL 查詢。[必要]

Options:

• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ 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

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf discussions

管理 Hub 上的討論與合併請求。

用法:

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

Options:

• --help：顯示此訊息並退出。

指令 (Commands):

• close：關閉討論或合併請求。
• comment：在討論或合併請求上發表評論。
• create：建立新的討論或合併請求……
• diff：顯示合併請求的差異 (diff)。
• info：取得關於討論或合併請求的資訊。
• list：列出儲存庫上的討論與合併請求。[別名：ls]
• merge：合併請求。
• rename：重新命名討論或合併請求。
• reopen：重新開啟已關閉的討論或合併請求。

hf discussions close

關閉討論或合併請求。

用法:

$ hf discussions close [OPTIONS] REPO_ID NUM

引數 (Arguments):

• REPO_ID：儲存庫 ID（例如 username/repo-name 或 spaces/username/repo-name）。[必要]
• NUM：討論或合併請求的編號。[必要]

Options:

• --comment TEXT：關閉時發佈的可選評論。
• -y, --yes：跳過確認提示。
• --type, --repo-type [model|dataset|space]：儲存庫類型（model、dataset 或 space）。[預設：model]
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ hf discussions close username/my-model 5 $ hf discussions close username/my-model 5 —comment “Closing as resolved.”

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf discussions comment

在討論或合併請求上發表評論。

用法:

$ hf discussions comment [OPTIONS] REPO_ID NUM

引數 (Arguments):

• REPO_ID：儲存庫 ID（例如 username/repo-name 或 spaces/username/repo-name）。[必要]
• NUM：討論或合併請求的編號。[必要]

Options:

• --body TEXT：評論內容（支援 Markdown）。
• --body-file PATH：從檔案讀取評論內容。使用 ’-’ 代表 stdin。
• --type, --repo-type [model|dataset|space]：儲存庫類型（model、dataset 或 space）。[預設：model]
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ hf discussions comment username/my-model 5 —body “Thanks for reporting!” $ hf discussions comment username/my-model 5 —body “LGTM!”

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf discussions create

在儲存庫上建立新討論或合併請求。

用法:

$ hf discussions create [OPTIONS] REPO_ID

引數 (Arguments):

• REPO_ID：儲存庫 ID（例如 username/repo-name 或 spaces/username/repo-name）。[必要]

Options:

• --title TEXT：討論或合併請求的標題。[必要]
• --body TEXT：描述內容（支援 Markdown）。
• --body-file PATH：從檔案讀取描述內容。使用 ’-’ 代表 stdin。
• --pull-request, --pr：建立合併請求而非討論。
• --type, --repo-type [model|dataset|space]：儲存庫類型（model、dataset 或 space）。[預設：model]
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ 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 <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf discussions diff

顯示合併請求的差異。

用法:

$ hf discussions diff [OPTIONS] REPO_ID NUM

引數 (Arguments):

• REPO_ID：儲存庫 ID（例如 username/repo-name 或 spaces/username/repo-name）。[必要]
• NUM：討論或合併請求的編號。[必要]

Options:

• --type, --repo-type [model|dataset|space]：儲存庫類型（model、dataset 或 space）。[預設：model]
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ hf discussions diff username/my-model 5

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf discussions info

取得關於討論或合併請求的資訊。

用法:

$ hf discussions info [OPTIONS] REPO_ID NUM

引數 (Arguments):

• REPO_ID：儲存庫 ID（例如 username/repo-name 或 spaces/username/repo-name）。[必要]
• NUM：討論或合併請求的編號。[必要]

Options:

• --type, --repo-type [model|dataset|space]：儲存庫類型（model、dataset 或 space）。[預設：model]
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ hf discussions info username/my-model 5 $ hf discussions info username/my-model 5 —format json

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf discussions list

列出儲存庫上的討論與合併請求。[別名：ls]

用法:

$ hf discussions list [OPTIONS] REPO_ID

引數 (Arguments):

• REPO_ID：儲存庫 ID（例如 username/repo-name 或 spaces/username/repo-name）。[必要]

Options:

• -s, --status [open|closed|merged|draft|all]：按狀態過濾（open, closed, merged, draft, all）。[預設：open]
• -k, --kind [all|discussion|pull_request]：按類型過濾（discussion, pull_request, all）。[預設：all]
• --author TEXT：按作者或組織過濾。
• --limit INTEGER：限制結果數量。[預設：30]
• --type, --repo-type [model|dataset|space]：儲存庫類型（model、dataset 或 space）。[預設：model]
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ 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

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf discussions merge

合併請求。

用法:

$ hf discussions merge [OPTIONS] REPO_ID NUM

引數 (Arguments):

• REPO_ID：儲存庫 ID（例如 username/repo-name 或 spaces/username/repo-name）。[必要]
• NUM：討論或合併請求的編號。[必要]

Options:

• --comment TEXT：合併時發佈的可選評論。
• -y, --yes：跳過確認提示。
• --type, --repo-type [model|dataset|space]：儲存庫類型（model、dataset 或 space）。[預設：model]
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ hf discussions merge username/my-model 5 $ hf discussions merge username/my-model 5 —comment “Merging, thanks!”

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf discussions rename

重新命名討論或合併請求。

用法:

$ hf discussions rename [OPTIONS] REPO_ID NUM NEW_TITLE

引數 (Arguments):

• REPO_ID：儲存庫 ID（例如 username/repo-name 或 spaces/username/repo-name）。[必要]
• NUM：討論或合併請求的編號。[必要]
• NEW_TITLE：新標題。[必要]

Options:

• --type, --repo-type [model|dataset|space]：儲存庫類型（model、dataset 或 space）。[預設：model]
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ hf discussions rename username/my-model 5 “Updated title”

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf discussions reopen

重新開啟已關閉的討論或合併請求。

用法:

$ hf discussions reopen [OPTIONS] REPO_ID NUM

引數 (Arguments):

• REPO_ID：儲存庫 ID（例如 username/repo-name 或 spaces/username/repo-name）。[必要]
• NUM：討論或合併請求的編號。[必要]

Options:

• --comment TEXT：重新開啟時發佈的可選評論。
• -y, --yes：跳過確認提示。
• --type, --repo-type [model|dataset|space]：儲存庫類型（model、dataset 或 space）。[預設：model]
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ hf discussions reopen username/my-model 5 $ hf discussions reopen username/my-model 5 —comment “Reopening for further investigation.”

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf download

從 Hub 下載檔案。

用法:

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

引數 (Arguments):

• REPO_ID：儲存庫 ID（例如 username/repo-name 或 spaces/username/repo-name）。[必要]
• [FILENAMES]...：要下載的檔案（例如 config.json、data/metadata.jsonl）。

Options:

• --type, --repo-type [model|dataset|space]：儲存庫類型（model、dataset 或 space）。[預設：model]
• --revision TEXT：Git 修訂 ID，可以是分支名稱、標籤或提交雜湊值。
• --include TEXT：要包含在下載檔案清單中的 Glob 模式。例如：*.json
• --exclude TEXT：要從下載檔案清單中排除的 Glob 模式。
• --cache-dir TEXT：儲存檔案的目錄。
• --local-dir TEXT：如果設定此項，下載的檔案將會放置在此目錄下。請參閱 https://huggingface.co/docs/huggingface_hub/guides/download#download-files-to-a-local-folder 以取得更多詳細資訊。
• --force-download / --no-force-download：如果為 True，即使檔案已經快取也會強制重新下載。[預設：no-force-download]
• --dry-run / --no-dry-run：如果為 True，執行模擬操作（dry run）而不實際下載檔案。[預設：no-dry-run]
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --max-workers INTEGER：用於下載檔案的最大工作執行緒數量。預設為 8。[預設：8]
• --help：顯示此訊息並退出。

範例 $ 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 <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf endpoints

管理 Hugging Face 推論端點（Inference Endpoints）。

用法:

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

Options:

• --help：顯示此訊息並退出。

指令 (Commands):

• catalog：與推論端點目錄進行互動…
• delete：永久刪除推論端點。
• deploy：從 Hub 部署推論端點…
• describe：取得現有端點的詳細資訊。
• list：列出所有的推論端點… [別名：ls]
• list-catalog：列出可用的目錄模型。
• pause：暫停推論端點。
• resume：恢復推論端點。
• scale-to-zero：將推論端點擴展至零。
• update：更新現有端點。

hf endpoints catalog

與推論端點目錄互動。

用法:

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

Options:

• --help：顯示此訊息並退出。

指令 (Commands):

• deploy：從目錄部署推論端點…
• list：列出可用的目錄模型。[別名：ls]

hf endpoints catalog deploy

從模型目錄部署推論端點。

用法:

$ hf endpoints catalog deploy [OPTIONS]

Options:

• --repo TEXT：與推論端點相關聯的模型儲存庫名稱（例如 ‘openai/gpt-oss-120b’）。[必要]
• --name TEXT：端點名稱。
• --accelerator TEXT：用於推論的硬體加速器（例如 ‘cpu’、‘gpu’、‘neuron’）。
• --namespace TEXT：與推論端點相關聯的命名空間。預設為當前使用者的命名空間。
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ hf endpoints catalog deploy —repo meta-llama/Llama-3.2-1B-Instruct

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf endpoints catalog list

列出可用的目錄模型。[別名：ls]

用法:

$ hf endpoints catalog list [OPTIONS]

Options:

• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ hf endpoints catalog ls

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf endpoints delete

永久刪除推論端點。

用法:

$ hf endpoints delete [OPTIONS] NAME

引數 (Arguments):

• NAME：端點名稱。[必要]

Options:

• --namespace TEXT：與推論端點相關聯的命名空間。預設為當前使用者的命名空間。
• --yes：跳過確認提示。
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ hf endpoints delete my-endpoint

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf endpoints deploy

從 Hub 儲存庫部署推論端點。

用法:

$ hf endpoints deploy [OPTIONS] NAME

引數 (Arguments):

• NAME：端點名稱。[必要]

Options:

• --repo TEXT：與推論端點相關聯的模型儲存庫名稱（例如 ‘openai/gpt-oss-120b’）。[必要]
• --framework TEXT：模型使用的機器學習框架（例如 ‘vllm’）。[必要]
• --accelerator TEXT：用於推論的硬體加速器（例如 ‘cpu’）。[必要]
• --instance-size TEXT：用於託管模型的執行個體大小或類型（例如 ‘x4’）。[必要]
• --instance-type TEXT：將部署推論端點的雲端執行個體類型（例如 ‘intel-icl’）。[必要]
• --region TEXT：建立推論端點的雲端區域（例如 ‘us-east-1’）。[必要]
• --vendor TEXT：託管推論端點的雲端供應商（例如 ‘aws’）。[必要]
• --namespace TEXT：與推論端點相關聯的命名空間。預設為當前使用者的命名空間。
• --task TEXT：部署模型的任務類型（例如 ‘text-classification’）。
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --min-replica INTEGER：推論端點保持執行的最少副本（執行個體）數量。[預設：1]
• --max-replica INTEGER：推論端點進行擴展的最大副本（執行個體）數量。[預設：1]
• --scale-to-zero-timeout INTEGER：端點閒置後擴展至零的分鐘數。
• --scaling-metric [pendingRequests|hardwareUsage]：擴展時使用的指標參考。
• --scaling-threshold FLOAT：觸發擴展的指標閾值。若未提供擴展指標，此項將被忽略。
• --help：顯示此訊息並退出。

範例 $ hf endpoints deploy my-endpoint —repo gpt2 —framework pytorch …

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf endpoints describe

取得現有端點的資訊。

用法:

$ hf endpoints describe [OPTIONS] NAME

引數 (Arguments):

• NAME：端點名稱。[必要]

Options:

• --namespace TEXT：與推論端點相關聯的命名空間。預設為當前使用者的命名空間。
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ hf endpoints describe my-endpoint

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf endpoints list

列出指定命名空間的所有推論端點。[別名：ls]

用法:

$ hf endpoints list [OPTIONS]

Options:

• --namespace TEXT：與推論端點相關聯的命名空間。預設為當前使用者的命名空間。
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ hf endpoints ls $ hf endpoints ls —namespace my-org

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf endpoints list-catalog

列出可用的目錄模型。

用法:

$ hf endpoints list-catalog [OPTIONS]

Options:

• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

hf endpoints pause

暫停推論端點。

用法:

$ hf endpoints pause [OPTIONS] NAME

引數 (Arguments):

• NAME：端點名稱。[必要]

Options:

• --namespace TEXT：與推論端點相關聯的命名空間。預設為當前使用者的命名空間。
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ hf endpoints pause my-endpoint

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf endpoints resume

恢復推論端點。

用法:

$ hf endpoints resume [OPTIONS] NAME

引數 (Arguments):

• NAME：端點名稱。[必要]

Options:

• --namespace TEXT：與推論端點相關聯的命名空間。預設為當前使用者的命名空間。
• --fail-if-already-running：如果設為 True，當推論端點已在執行時，該方法會引發錯誤。
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ hf endpoints resume my-endpoint

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf endpoints scale-to-zero

將推論端點擴展至零。

用法:

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

引數 (Arguments):

• NAME：端點名稱。[必要]

Options:

• --namespace TEXT：與推論端點相關聯的命名空間。預設為當前使用者的命名空間。
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ hf endpoints scale-to-zero my-endpoint

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf endpoints update

更新現有端點。

用法:

$ hf endpoints update [OPTIONS] NAME

引數 (Arguments):

• NAME：端點名稱。[必要]

Options:

• --namespace TEXT：與推論端點相關聯的命名空間。預設為當前使用者的命名空間。
• --repo TEXT：與推論端點相關聯的模型儲存庫名稱（例如 ‘openai/gpt-oss-120b’）。
• --accelerator TEXT：用於推論的硬體加速器（例如 ‘cpu’）。
• --instance-size TEXT：用於託管模型的執行個體大小或類型（例如 ‘x4’）。
• --instance-type TEXT：將部署推論端點的雲端執行個體類型（例如 ‘intel-icl’）。
• --framework TEXT：模型使用的機器學習框架（例如 ‘custom’）。
• --revision TEXT：要在推論端點上部署的特定模型版本（例如 ‘6c0e6080953db56375760c0471a8c5f2929baf11’）。
• --task TEXT：部署模型的任務類型（例如 ‘text-classification’）。
• --min-replica INTEGER：推論端點保持執行的最少副本（執行個體）數量。
• --max-replica INTEGER：推論端點進行擴展的最大副本（執行個體）數量。
• --scale-to-zero-timeout INTEGER：端點閒置後擴展至零的分鐘數。
• --scaling-metric [pendingRequests|hardwareUsage]：擴展時使用的指標參考。
• --scaling-threshold FLOAT：觸發擴展的指標閾值。若未提供擴展指標，此項將被忽略。
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ hf endpoints update my-endpoint —min-replica 2

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf env

列印環境相關資訊。

用法:

$ hf env [OPTIONS]

Options:

• --help：顯示此訊息並退出。

hf extensions

管理 hf CLI 擴充功能。[別名：ext]

安全警告：擴充功能為第三方可執行檔或 Python 套件。僅從您信任的來源進行安裝。

用法:

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

Options:

• --help：顯示此訊息並退出。

指令 (Commands):

• exec：執行已安裝的擴充功能。
• install：從公開的 GitHub 安裝擴充功能…
• list：列出已安裝的擴充功能指令。[別名：ls]
• remove：移除已安裝的擴充功能。[別名：rm]
• search：搜尋 GitHub 上可用的擴充功能…

hf extensions | ext exec

執行已安裝的擴充功能。

用法:

$ hf extensions exec [OPTIONS] NAME

引數 (Arguments):

• NAME：擴充功能名稱（帶或不帶 hf- 前綴皆可）。[必要]

Options:

• --help：顯示此訊息並退出。

範例 $ hf extensions exec claude — —help $ hf extensions exec claude —model zai-org/GLM-5

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf extensions | ext install

從公開的 GitHub 儲存庫安裝擴充功能。

安全警告：此操作會安裝第三方可執行檔或 Python 套件。僅從您信任的來源進行安裝。

用法:

$ hf extensions install [OPTIONS] REPO_ID

引數 (Arguments):

• REPO_ID：GitHub 擴充功能儲存庫，格式為 [OWNER/]hf-<name>。[必要]

Options:

• --force：若已安裝則強制覆蓋。
• --help：顯示此訊息並退出。

範例 $ hf extensions install hf-claude $ hf extensions install hanouticelina/hf-claude $ hf extensions install alvarobartt/hf-mem

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf extensions | ext list

列出已安裝的擴充功能指令。[別名：ls]

用法:

$ hf extensions list [OPTIONS]

Options:

• --help：顯示此訊息並退出。

範例 $ hf extensions list

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf extensions | ext remove

移除已安裝的擴充功能。[別名：rm]

用法:

$ hf extensions remove [OPTIONS] NAME

引數 (Arguments):

• NAME：要移除的擴充功能名稱（帶或不帶 hf- 前綴皆可）。[必要]

Options:

• --help：顯示此訊息並退出。

範例 $ hf extensions remove claude

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf extensions | ext search

搜尋 GitHub 上可用的擴充功能（標記有 ‘hf-extension’ 主題）。

用法:

$ hf extensions search [OPTIONS]

Options:

• --help：顯示此訊息並退出。

範例 $ hf extensions search

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf jobs

在 Hub 上執行並管理作業（Jobs）。

用法:

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

Options:

• --help：顯示此訊息並退出。

指令 (Commands):

• cancel：取消作業
• hardware：列出作業可用的硬體選項
• inspect：顯示一個或多個作業的詳細資訊…
• logs：擷取作業日誌。
• ps：列出作業。
• run：執行作業。
• scheduled：在 Hub 上建立並管理排程作業。
• stats：擷取資源使用統計數據和…
• uv：執行 UV 指令碼（內嵌相依性的 Python…

hf jobs cancel

取消作業

用法:

$ hf jobs cancel [OPTIONS] JOB_ID

引數 (Arguments):

• JOB_ID：作業 ID（或 ‘namespace/job_id’）[必要]

Options:

• --namespace TEXT：作業執行所在的命名空間。預設為當前使用者的命名空間。
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ hf jobs cancel <job_id>

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf jobs hardware

列出作業可用的硬體選項

用法:

$ hf jobs hardware [OPTIONS]

Options:

• --help：顯示此訊息並退出。

範例 $ hf jobs hardware

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf jobs inspect

顯示一個或多個作業的詳細資訊

用法:

$ hf jobs inspect [OPTIONS] JOB_IDS...

引數 (Arguments):

• JOB_IDS...：要檢查的作業 ID（或 ‘namespace/job_id’）[必要]

Options:

• --namespace TEXT：作業執行所在的命名空間。預設為當前使用者的命名空間。
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ hf jobs inspect <job_id>

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf jobs logs

擷取作業日誌。

預設情況下，會列印當前可用的日誌並結束（非阻塞）。使用 —follow/-f 可即時串流日誌，直到作業完成。使用 —tail/-n 可限制回傳的行數（若伺服器端支援）。

用法:

$ hf jobs logs [OPTIONS] JOB_ID

引數 (Arguments):

• JOB_ID：作業 ID（或 ‘namespace/job_id’）[必要]

Options:

• -f, --follow：追蹤日誌輸出（串流直到作業完成）。如果不加此參數，則僅列印當前可用的日誌。
• -n, --tail INTEGER：顯示日誌最後幾行的行數。當與 —follow 結合使用時，從最後 N 行開始串流。
• --namespace TEXT：作業執行所在的命名空間。預設為當前使用者的命名空間。
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ 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>

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf jobs ps

列出作業。

用法:

$ hf jobs ps [OPTIONS]

Options:

• -a, --all：顯示所有作業（預設僅顯示執行中的作業）
• --namespace TEXT：作業執行所在的命名空間。預設為當前使用者的命名空間。
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• -f, --filter TEXT：根據提供的條件過濾輸出（格式：key=value）
• --format TEXT：輸出格式：‘table’（預設）、‘json’ 或 Go 模板（例如 ‘{{.id}}’）
• -q, --quiet：僅列印 ID（每行一個）。
• --help：顯示此訊息並退出。

範例 $ hf jobs ps $ hf jobs ps -a

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf jobs run

執行作業。

用法:

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

引數 (Arguments):

• IMAGE：使用的 Docker 映像檔。[必要]
• COMMAND...：要執行的指令。[必要]

Options:

• -e, --env TEXT：設定環境變數。例如：—env ENV=value
• -s, --secrets TEXT：設定秘密環境變數。例如：—secrets SECRET=value 或 --secrets HF_TOKEN 以傳入您的 Hugging Face 權杖。
• -l, --label TEXT：設定標籤。例如：—label KEY=VALUE 或 —label LABEL
• -v, --volume TEXT：掛載一個或多個儲存空間。格式：hf://[TYPE/]SOURCE:/MOUNT_PATH[:ro]。TYPE 可為：models, datasets, spaces, buckets。若省略，TYPE 預設為 models。models、datasets 和 spaces 一律以唯讀（read-only）模式掛載。buckets 預設為讀寫（read+write）模式。例如：-v hf://org/m:/data 或 -v hf://datasets/org/ds:/data 或 -v hf://buckets/org/b:/mnt:ro
• --env-file TEXT：讀取環境變數檔案。
• --secrets-file TEXT：讀取秘密環境變數檔案。
• --flavor [cpu-basic|cpu-upgrade|cpu-performance|cpu-xl|sprx8|zero-a10g|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|inf2x6]：硬體方案，與 HF Spaces 相同。執行 ‘hf jobs hardware’ 以列出可用方案。預設為 cpu-basic。
• --timeout TEXT：最大持續時間：整數/浮點數加上 s（秒，預設）、m（分鐘）、h（小時）或 d（天）。
• -d, --detach：在背景執行作業並列印作業 ID。
• --namespace TEXT：作業執行所在的命名空間。預設為當前使用者的命名空間。
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ hf jobs run python:3.12 python -c ‘print(“Hello!”)’ $ 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

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf jobs scheduled

在 Hub 上建立並管理排程作業。

用法:

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

Options:

• --help：顯示此訊息並退出。

指令 (Commands):

• delete：刪除排程作業。
• inspect：顯示一個或多個作業的詳細資訊…
• ps：列出排程作業
• resume：恢復（取消暫停）排程作業。
• run：排程一個作業。
• suspend：暫停排程作業。
• uv：在 HF 基礎設施上排程 UV 指令碼。

hf jobs scheduled delete

刪除排程作業。

用法:

$ hf jobs scheduled delete [OPTIONS] SCHEDULED_JOB_ID

引數 (Arguments):

• SCHEDULED_JOB_ID：排程作業 ID（或 ‘namespace/scheduled_job_id’）[必要]

Options:

• --namespace TEXT：作業執行所在的命名空間。預設為當前使用者的命名空間。
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ hf jobs scheduled delete <id>

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf jobs scheduled inspect

顯示一個或多個排程作業的詳細資訊

用法:

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

引數 (Arguments):

• SCHEDULED_JOB_IDS...：要檢查的排程作業 ID（或 ‘namespace/scheduled_job_id’）[必要]

Options:

• --namespace TEXT：作業執行所在的命名空間。預設為當前使用者的命名空間。
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ hf jobs scheduled inspect <id>

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf jobs scheduled ps

列出排程作業

用法:

$ hf jobs scheduled ps [OPTIONS]

Options:

• -a, --all：顯示所有排程作業（預設隱藏已暫停的）
• --namespace TEXT：作業執行所在的命名空間。預設為當前使用者的命名空間。
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• -f, --filter TEXT：根據提供的條件過濾輸出（格式：key=value）
• --format TEXT：輸出格式：‘table’（預設）、‘json’ 或 Go 模板（例如 ‘{{.id}}’）
• -q, --quiet：僅列印 ID（每行一個）。
• --help：顯示此訊息並退出。

範例 $ hf jobs scheduled ps

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf jobs scheduled resume

恢復（取消暫停）排程作業。

用法:

$ hf jobs scheduled resume [OPTIONS] SCHEDULED_JOB_ID

引數 (Arguments):

• SCHEDULED_JOB_ID：排程作業 ID（或 ‘namespace/scheduled_job_id’）[必要]

Options:

• --namespace TEXT：作業執行所在的命名空間。預設為當前使用者的命名空間。
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ hf jobs scheduled resume <id>

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf jobs scheduled run

排程一個作業。

用法:

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

引數 (Arguments):

• SCHEDULE：annual、yearly、monthly、weekly、daily、hourly 之一，或 CRON 排程表示式。[必要]
• IMAGE：使用的 Docker 映像檔。[必要]
• COMMAND...：要執行的指令。[必要]

Options:

• --suspend / --no-suspend：暫停排程作業
• --concurrency / --no-concurrency：允許此作業的多個執行個體同時執行
• -e, --env TEXT：設定環境變數。例如：—env ENV=value
• -s, --secrets TEXT：設定秘密環境變數。例如：—secrets SECRET=value 或 --secrets HF_TOKEN 以傳入您的 Hugging Face 權杖。
• -l, --label TEXT：設定標籤。例如：—label KEY=VALUE 或 —label LABEL
• -v, --volume TEXT：掛載一個或多個儲存空間。格式：hf://[TYPE/]SOURCE:/MOUNT_PATH[:ro]。TYPE 可為：models, datasets, spaces, buckets。若省略，TYPE 預設為 models。models、datasets 和 spaces 一律以唯讀（read-only）模式掛載。buckets 預設為讀寫（read+write）模式。例如：-v hf://org/m:/data 或 -v hf://datasets/org/ds:/data 或 -v hf://buckets/org/b:/mnt:ro
• --env-file TEXT：讀取環境變數檔案。
• --secrets-file TEXT：讀取秘密環境變數檔案。
• --flavor [cpu-basic|cpu-upgrade|cpu-performance|cpu-xl|sprx8|zero-a10g|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|inf2x6]：硬體方案，與 HF Spaces 相同。執行 ‘hf jobs hardware’ 以列出可用方案。預設為 cpu-basic。
• --timeout TEXT：最大持續時間：整數/浮點數加上 s（秒，預設）、m（分鐘）、h（小時）或 d（天）。
• --namespace TEXT：作業執行所在的命名空間。預設為當前使用者的命名空間。
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ hf jobs scheduled run “0 0 * * *” python:3.12 python script.py

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf jobs scheduled suspend

暫停排程作業。

用法:

$ hf jobs scheduled suspend [OPTIONS] SCHEDULED_JOB_ID

引數 (Arguments):

• SCHEDULED_JOB_ID：排程作業 ID（或 ‘namespace/scheduled_job_id’）[必要]

Options:

• --namespace TEXT：作業執行所在的命名空間。預設為當前使用者的命名空間。
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ hf jobs scheduled suspend <id>

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf jobs scheduled uv

在 HF 基礎設施上排程 UV 指令碼。

用法:

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

Options:

• --help：顯示此訊息並退出。

指令 (Commands):

• run：在 HF 上執行 UV 指令碼（本機檔案或 URL）…

hf jobs scheduled uv run

在 HF 基礎設施上執行 UV 指令碼（本機檔案或 URL）

用法:

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

引數 (Arguments):

• SCHEDULE：annual、yearly、monthly、weekly、daily、hourly 之一，或 CRON 排程表示式。[必要]
• SCRIPT：要執行的 UV 指令碼（本機檔案或 URL）[必要]
• [SCRIPT_ARGS]...：指令碼的參數

Options:

• --suspend / --no-suspend：暫停排程作業
• --concurrency / --no-concurrency：允許此作業的多個執行個體同時執行
• --image TEXT：使用安裝了 uv 的自訂 Docker 映像檔。
• --flavor [cpu-basic|cpu-upgrade|cpu-performance|cpu-xl|sprx8|zero-a10g|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|inf2x6]：硬體方案，與 HF Spaces 相同。執行 ‘hf jobs hardware’ 以列出可用方案。預設為 cpu-basic。
• -e, --env TEXT：設定環境變數。例如：—env ENV=value
• -s, --secrets TEXT：設定秘密環境變數。例如：—secrets SECRET=value 或 --secrets HF_TOKEN 以傳入您的 Hugging Face 權杖。
• -l, --label TEXT：設定標籤。例如：—label KEY=VALUE 或 —label LABEL
• -v, --volume TEXT：掛載一個或多個儲存空間。格式：hf://[TYPE/]SOURCE:/MOUNT_PATH[:ro]。TYPE 可為：models, datasets, spaces, buckets。若省略，TYPE 預設為 models。models、datasets 和 spaces 一律以唯讀（read-only）模式掛載。buckets 預設為讀寫（read+write）模式。例如：-v hf://org/m:/data 或 -v hf://datasets/org/ds:/data 或 -v hf://buckets/org/b:/mnt:ro
• --env-file TEXT：讀取環境變數檔案。
• --secrets-file TEXT：讀取秘密環境變數檔案。
• --timeout TEXT：最大持續時間：整數/浮點數加上 s（秒，預設）、m（分鐘）、h（小時）或 d（天）。
• --namespace TEXT：作業執行所在的命名空間。預設為當前使用者的命名空間。
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --with TEXT：執行時安裝指定的套件
• -p, --python TEXT：執行環境所使用的 Python 解譯器
• --help：顯示此訊息並退出。

範例 $ hf jobs scheduled uv run “0 0 * * *” script.py $ hf jobs scheduled uv run “0 0 * * *” script.py —with pandas

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf jobs stats

擷取作業的資源使用統計數據和指標

用法:

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

引數 (Arguments):

• [JOB_IDS]...：作業 ID（或 ‘namespace/job_id’）

Options:

• --namespace TEXT：作業執行所在的命名空間。預設為當前使用者的命名空間。
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ hf jobs stats <job_id>

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf jobs uv

在 HF 基礎設施上執行 UV 指令碼（內嵌相依性的 Python）。

用法:

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

Options:

• --help：顯示此訊息並退出。

指令 (Commands):

• run：在 HF 上執行 UV 指令碼（本機檔案或 URL）…

hf jobs uv run

在 HF 基礎設施上執行 UV 指令碼（本機檔案或 URL）

用法:

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

引數 (Arguments):

• SCRIPT：要執行的 UV 指令碼（本機檔案或 URL）[必要]
• [SCRIPT_ARGS]...：指令碼的參數

Options:

• --image TEXT：使用安裝了 uv 的自訂 Docker 映像檔。
• --flavor [cpu-basic|cpu-upgrade|cpu-performance|cpu-xl|sprx8|zero-a10g|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|inf2x6]：硬體方案，與 HF Spaces 相同。執行 ‘hf jobs hardware’ 以列出可用方案。預設為 cpu-basic。
• -e, --env TEXT：設定環境變數。例如：—env ENV=value
• -s, --secrets TEXT：設定秘密環境變數。例如：—secrets SECRET=value 或 --secrets HF_TOKEN 以傳入您的 Hugging Face 權杖。
• -l, --label TEXT：設定標籤。例如：—label KEY=VALUE 或 —label LABEL
• -v, --volume TEXT：掛載一個或多個儲存空間。格式：hf://[TYPE/]SOURCE:/MOUNT_PATH[:ro]。TYPE 可為：models, datasets, spaces, buckets。若省略，TYPE 預設為 models。models、datasets 和 spaces 一律以唯讀（read-only）模式掛載。buckets 預設為讀寫（read+write）模式。例如：-v hf://org/m:/data 或 -v hf://datasets/org/ds:/data 或 -v hf://buckets/org/b:/mnt:ro
• --env-file TEXT：讀取環境變數檔案。
• --secrets-file TEXT：讀取秘密環境變數檔案。
• --timeout TEXT：最大持續時間：整數/浮點數加上 s（秒，預設）、m（分鐘）、h（小時）或 d（天）。
• -d, --detach：在背景執行作業並列印作業 ID。
• --namespace TEXT：作業執行所在的命名空間。預設為當前使用者的命名空間。
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --with TEXT：執行時安裝指定的套件
• -p, --python TEXT：執行環境所使用的 Python 解譯器
• --help：顯示此訊息並退出。

範例 $ hf jobs uv run my_script.py $ hf jobs uv run ml_training.py —flavor a10g-small $ 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 <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf lfs-enable-largefiles

設定您的儲存庫以啟用大於 5GB 檔案的上傳。

此指令會設定 git-lfs 使用自訂多重傳輸代理（multipart transfer agent），從而實現以區塊（chunks）形式高效上傳大檔案。

用法:

$ hf lfs-enable-largefiles [OPTIONS] PATH

引數 (Arguments):

• PATH：您想要設定的本機儲存庫路徑。[必要]

Options:

• --help：顯示此訊息並退出。

hf lfs-multipart-upload

用於多重上傳的內部 git-lfs 自訂傳輸代理。

此功能實作了 git-lfs 多重上傳的自訂傳輸協定。負責處理大檔案到 Hugging Face Hub 的區塊式上傳。

用法:

$ hf lfs-multipart-upload [OPTIONS]

Options:

• --help：顯示此訊息並退出。

hf models

與 Hub 上的模型進行互動。

用法:

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

Options:

• --help：顯示此訊息並退出。

指令 (Commands):

• card：取得 Hub 上某個模型的模型卡（README）…
• info：取得 Hub 上某個模型的相關資訊。
• list：列出 Hub 上的模型，或列出特定模型儲存庫中的檔案… [別名：ls]

hf models card

取得 Hub 上某個模型的模型卡（README）。

用法:

$ hf models card [OPTIONS] MODEL_ID

引數 (Arguments):

• MODEL_ID：模型 ID（例如 username/repo-name）。[必要]

Options:

• --metadata：僅輸出卡片中的元資料。
• --text：僅輸出文字主體（無元資料）。
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ 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

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf models info

取得 Hub 上某個模型的相關資訊。

用法:

$ hf models info [OPTIONS] MODEL_ID

引數 (Arguments):

• MODEL_ID：模型 ID（例如 username/repo-name）。[必要]

Options:

• --revision TEXT：Git 修訂 ID，可以是分支名稱、標籤或提交雜湊值。
• --expand TEXT：要回傳的逗號分隔屬性。使用時，僅會回傳列出的屬性（以及 id）。例如：‘—expand=downloads,likes,tags’。有效屬性：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：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

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

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf models list

列出 Hub 上的模型，或列出模型儲存庫中的檔案。[別名：ls]

若未指定參數，則列出 Hub 上的模型。若提供模型 ID，則列出該儲存庫中的檔案。

用法:

$ hf models list [OPTIONS] [REPO_ID]

引數 (Arguments):

• [REPO_ID]：要列出檔案的模型 ID（例如 username/repo-name）。若省略，則列出所有模型。

Options:

• --search TEXT：搜尋查詢。
• --author TEXT：按作者或組織過濾。
• --filter TEXT：按標籤過濾（例如 ‘text-classification’）。可多次使用。
• --num-parameters TEXT：根據參數數量篩選，例如 ‘min:6B,max:128B’。
• --sort [created_at|downloads|last_modified|likes|trending_score]：排序結果。
• --limit INTEGER：限制結果數量。[預設：30]
• --expand TEXT：要回傳的逗號分隔屬性。使用時，僅會回傳列出的屬性（以及 id）。例如：‘—expand=downloads,likes,tags’。有效屬性：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：以人類可讀格式顯示大小（僅適用於列出檔案時）。
• --tree：以樹狀格式列出檔案（僅適用於列出檔案時）。
• -R, --recursive：遞迴列出檔案（僅適用於列出檔案時）。
• --revision TEXT：Git 修訂 ID，可以是分支名稱、標籤或提交雜湊值。
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ hf models ls —sort downloads —limit 10 $ hf models ls —search “llama” —author meta-llama $ hf models ls —num-parameters min:6B,max:128B —sort likes $ 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

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf papers

與 Hub 上的論文（Papers）進行互動。

用法:

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

Options:

• --help：顯示此訊息並退出。

指令 (Commands):

• info：取得 Hub 上某篇論文的相關資訊。
• list：列出 Hub 上的每日論文。[別名：ls]
• read：以 Markdown 格式讀取論文。
• search：搜尋 Hub 上的論文。

hf papers info

取得 Hub 上某篇論文的相關資訊。

用法:

$ hf papers info [OPTIONS] PAPER_ID

引數 (Arguments):

• PAPER_ID：arXiv 論文 ID（例如 ‘2502.08025’）。[必要]

Options:

• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ hf papers info 2601.15621

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf papers list

列出 Hub 上的每日論文。[別名：ls]

用法:

$ hf papers list [OPTIONS]

Options:

• --date TEXT：ISO 格式的日期（YYYY-MM-DD）或 ‘today’。
• --week TEXT：要篩選的 ISO 週次，例如 ‘2025-W09’。
• --month TEXT：要篩選的月份（ISO 格式 YYYY-MM），例如 ‘2025-02’。
• --submitter TEXT：根據提交者的使用者名稱進行篩選。
• --sort [publishedAt|trending]：排序結果。
• --limit INTEGER：限制結果數量。[預設：50]
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ 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

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf papers read

以 Markdown 格式讀取論文。

用法:

$ hf papers read [OPTIONS] PAPER_ID

引數 (Arguments):

• PAPER_ID：arXiv 論文 ID（例如 ‘2502.08025’）。[必要]

Options:

• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ hf papers read 2601.15621

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf papers search

搜尋 Hub 上的論文。

用法:

$ hf papers search [OPTIONS] QUERY

引數 (Arguments):

• QUERY：搜尋查詢字串。[必要]

Options:

• --limit INTEGER：限制結果數量。[預設：20]
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ hf papers search “vision language” $ hf papers search “attention mechanism” —limit 10 $ hf papers search “diffusion” —format json

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf repos

管理 Hub 上的儲存庫。[別名：repo]

用法:

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

Options:

• --help：顯示此訊息並退出。

指令 (Commands):

• branch：管理 Hub 上儲存庫的分支。
• create：在 Hub 上建立新儲存庫。
• delete：從 Hub 刪除儲存庫。
• delete-files：從 Hub 的儲存庫中刪除檔案。
• duplicate：在 Hub 上複製儲存庫（模型、……
• move：將儲存庫從一個命名空間移動到……
• settings：更新儲存庫的設定。
• tag：管理 Hub 上儲存庫的標籤。

hf repos | repo branch

管理 Hub 上儲存庫的分支。

用法:

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

Options:

• --help：顯示此訊息並退出。

指令 (Commands):

• create：為 Hub 上的儲存庫建立新分支。
• delete：從 Hub 上的儲存庫刪除分支。

hf repos | repo branch create

為 Hub 上的儲存庫建立新分支。

用法:

$ hf repos branch create [OPTIONS] REPO_ID BRANCH

引數 (Arguments):

• REPO_ID：儲存庫 ID（例如 username/repo-name 或 spaces/username/repo-name）。[必要]
• BRANCH：要建立的分支名稱。[必填]

Options:

• --revision TEXT：Git 修訂 ID，可以是分支名稱、標籤或提交雜湊值。
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --type, --repo-type [model|dataset|space]：儲存庫類型（model、dataset 或 space）。[預設：model]
• --exist-ok / --no-exist-ok：若設為 True，當分支已存在時不會引發錯誤。[預設值：no-exist-ok]
• --help：顯示此訊息並退出。

範例 $ hf repos branch create my-model dev $ hf repos branch create my-model dev —revision abc123

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf repos | repo branch delete

從 Hub 上的儲存庫刪除分支。

用法:

$ hf repos branch delete [OPTIONS] REPO_ID BRANCH

引數 (Arguments):

• REPO_ID：儲存庫 ID（例如 username/repo-name 或 spaces/username/repo-name）。[必要]
• BRANCH：要刪除的分支名稱。[必填]

Options:

• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --type, --repo-type [model|dataset|space]：儲存庫類型（model、dataset 或 space）。[預設：model]
• --help：顯示此訊息並退出。

範例 $ hf repos branch delete my-model dev

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf repos | repo create

在 Hub 上建立新儲存庫。

用法:

$ hf repos create [OPTIONS] REPO_ID

引數 (Arguments):

• REPO_ID：儲存庫 ID（例如 username/repo-name 或 spaces/username/repo-name）。[必要]

Options:

• --type, --repo-type [model|dataset|space]：儲存庫類型（model、dataset 或 space）。[預設：model]
• --space-sdk TEXT：Hugging Face Spaces SDK 類型。當 —type 設為 'space' 時為必填。
• --private / --no-private：若 Hub 上不存在該儲存庫，是否建立私人儲存庫。若儲存庫已存在則忽略此參數。
• --public：是否將儲存庫設為公開。若儲存庫已存在則忽略此參數。
• --protected：是否將 Space 設為受保護（僅限 Spaces）。若儲存庫已存在則忽略此參數。
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --exist-ok / --no-exist-ok：若儲存庫已存在，不要引發錯誤。[預設值：no-exist-ok]
• --resource-group-id TEXT：建立儲存庫所在的資源群組。資源群組僅適用於企業版 Hub 組織。
• --region [us|eu]：建立儲存庫所在的雲端區域。可選 'us' 或 'eu'。需要 Team 方案或以上。
• --flavor [cpu-basic|cpu-upgrade|cpu-performance|cpu-xl|sprx8|zero-a10g|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|inf2x6]：Space 硬體規格（例如 'cpu-basic'、't4-medium'、'l4x4'）。僅限 Spaces 使用。
• --storage [small|medium|large]：（已棄用，請改用 volumes）Space 持久儲存層級（'small'、'medium' 或 'large'）。僅限 Spaces 使用。
• --sleep-time INTEGER：Space 進入睡眠前的閒置秒數。使用 -1 停用。僅限 Spaces 使用。
• -s, --secrets TEXT：設定秘密環境變數。例如：—secrets SECRET=value 或 --secrets HF_TOKEN 以傳入您的 Hugging Face 權杖。
• --secrets-file TEXT：讀取秘密環境變數檔案。
• -e, --env TEXT：設定環境變數。例如：—env ENV=value
• --env-file TEXT：讀取環境變數檔案。
• -v, --volume TEXT：掛載一個或多個儲存空間。格式：hf://[TYPE/]SOURCE:/MOUNT_PATH[:ro]。TYPE 可為：models, datasets, spaces, buckets。若省略，TYPE 預設為 models。models、datasets 和 spaces 一律以唯讀（read-only）模式掛載。buckets 預設為讀寫（read+write）模式。例如：-v hf://org/m:/data 或 -v hf://datasets/org/ds:/data 或 -v hf://buckets/org/b:/mnt:ro
• --help：顯示此訊息並退出。

範例 $ hf repos create my-model $ hf repos create my-dataset —repo-type dataset —private $ hf repos create my-space —type space —space-sdk gradio —flavor t4-medium —secrets HF_TOKEN -e THEME=dark —protected $ hf repos create my-space —type space —space-sdk gradio -v hf://org/my-model:/models -v hf://buckets/org/b:/data $ hf repos create my-model —region us

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf repos | repo delete

從 Hub 刪除儲存庫。此操作無法復原。

用法:

$ hf repos delete [OPTIONS] REPO_ID

引數 (Arguments):

• REPO_ID：儲存庫 ID（例如 username/repo-name 或 spaces/username/repo-name）。[必要]

Options:

• --type, --repo-type [model|dataset|space]：儲存庫類型（model、dataset 或 space）。[預設：model]
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --missing-ok / --no-missing-ok：若設為 True，當儲存庫不存在時不會引發錯誤。[預設值：no-missing-ok]
• -y, --yes：自動對提示回答「是」。
• --help：顯示此訊息並退出。

範例 $ hf repos delete my-model

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf repos | repo delete-files

從 Hub 的儲存庫中刪除檔案。

用法:

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

引數 (Arguments):

• REPO_ID：儲存庫 ID（例如 username/repo-name 或 spaces/username/repo-name）。[必要]
• PATTERNS...：用於匹配要刪除檔案的 Glob 模式。基於 fnmatch，'*' 會遞迴匹配檔案。[必填]

Options:

• --type, --repo-type [model|dataset|space]：儲存庫類型（model、dataset 或 space）。[預設：model]
• --revision TEXT：Git 修訂 ID，可以是分支名稱、標籤或提交雜湊值。
• --commit-message TEXT：產生的提交說明/標題/第一行。
• --commit-description TEXT：產生的提交描述。
• --create-pr / --no-create-pr：是否為這些變更建立新的 Pull Request。[預設值：no-create-pr]
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ hf repos delete-files my-model file.txt $ hf repos delete-files my-model “*.json” $ hf repos delete-files my-model folder/

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf repos | repo duplicate

在 Hub 上複製儲存庫（模型、資料集或 Space）。

用法:

$ hf repos duplicate [OPTIONS] FROM_ID [TO_ID]

引數 (Arguments):

• FROM_ID：儲存庫的 ID（例如 username/repo-name 或 spaces/username/repo-name）。[必填]
• [TO_ID]：目標儲存庫 ID（例如 myorg/my-copy）。預設使用與原儲存庫同名的命名空間。

Options:

• --type, --repo-type [model|dataset|space]：儲存庫類型（model、dataset 或 space）。[預設：model]
• --private / --no-private：若 Hub 上不存在該儲存庫，是否建立私人儲存庫。若儲存庫已存在則忽略此參數。
• --public：是否將儲存庫設為公開。若儲存庫已存在則忽略此參數。
• --protected：是否將 Space 設為受保護（僅限 Spaces）。若儲存庫已存在則忽略此參數。
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --exist-ok / --no-exist-ok：若儲存庫已存在，不要引發錯誤。[預設值：no-exist-ok]
• --flavor [cpu-basic|cpu-upgrade|cpu-performance|cpu-xl|sprx8|zero-a10g|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|inf2x6]：Space 硬體規格（例如 'cpu-basic'、't4-medium'、'l4x4'）。僅限 Spaces 使用。
• --storage [small|medium|large]：（已棄用，請改用 volumes）Space 持久儲存層級（'small'、'medium' 或 'large'）。僅限 Spaces 使用。
• --sleep-time INTEGER：Space 進入睡眠前的閒置秒數。使用 -1 停用。僅限 Spaces 使用。
• -s, --secrets TEXT：設定秘密環境變數。例如：—secrets SECRET=value 或 --secrets HF_TOKEN 以傳入您的 Hugging Face 權杖。
• --secrets-file TEXT：讀取秘密環境變數檔案。
• -e, --env TEXT：設定環境變數。例如：—env ENV=value
• --env-file TEXT：讀取環境變數檔案。
• -v, --volume TEXT：掛載一個或多個儲存空間。格式：hf://[TYPE/]SOURCE:/MOUNT_PATH[:ro]。TYPE 可為：models, datasets, spaces, buckets。若省略，TYPE 預設為 models。models、datasets 和 spaces 一律以唯讀（read-only）模式掛載。buckets 預設為讀寫（read+write）模式。例如：-v hf://org/m:/data 或 -v hf://datasets/org/ds:/data 或 -v hf://buckets/org/b:/mnt:ro
• --help：顯示此訊息並退出。

範例 $ 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

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf repos | repo move

將儲存庫從一個命名空間移動到另一個命名空間。

用法:

$ hf repos move [OPTIONS] FROM_ID TO_ID

引數 (Arguments):

• FROM_ID：儲存庫的 ID（例如 username/repo-name 或 spaces/username/repo-name）。[必填]
• TO_ID：儲存庫的 ID（例如 username/repo-name 或 spaces/username/repo-name）。[必填]

Options:

• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --type, --repo-type [model|dataset|space]：儲存庫類型（model、dataset 或 space）。[預設：model]
• --help：顯示此訊息並退出。

範例 $ hf repos move old-namespace/my-model new-namespace/my-model

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf repos | repo settings

更新儲存庫的設定。

用法:

$ hf repos settings [OPTIONS] REPO_ID

引數 (Arguments):

• REPO_ID：儲存庫 ID（例如 username/repo-name 或 spaces/username/repo-name）。[必要]

Options:

• --gated [auto|manual|false]：儲存庫的門控（Gated）狀態。
• --private / --no-private：若 Hub 上不存在該儲存庫，是否建立私人儲存庫。若儲存庫已存在則忽略此參數。
• --public：是否將儲存庫設為公開。若儲存庫已存在則忽略此參數。
• --protected：是否將 Space 設為受保護（僅限 Spaces）。若儲存庫已存在則忽略此參數。
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --type, --repo-type [model|dataset|space]：儲存庫類型（model、dataset 或 space）。[預設：model]
• --help：顯示此訊息並退出。

範例 $ hf repos settings my-model —private $ hf repos settings my-model —gated auto $ hf repos settings my-space —repo-type space —protected

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf repos | repo tag

管理 Hub 上儲存庫的標籤。

用法:

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

Options:

• --help：顯示此訊息並退出。

指令 (Commands):

• create：為儲存庫建立標籤。
• delete：刪除儲存庫的標籤。
• list：列出儲存庫的標籤。[別名：ls]

hf repos | repo tag create

為儲存庫建立標籤。

用法:

$ hf repos tag create [OPTIONS] REPO_ID TAG

引數 (Arguments):

• REPO_ID：儲存庫 ID（例如 username/repo-name 或 spaces/username/repo-name）。[必要]
• TAG：要建立的標籤名稱。[必填]

Options:

• -m, --message TEXT：要建立的標籤描述。
• --revision TEXT：Git 修訂 ID，可以是分支名稱、標籤或提交雜湊值。
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --type, --repo-type [model|dataset|space]：儲存庫類型（model、dataset 或 space）。[預設：model]
• --help：顯示此訊息並退出。

範例 $ hf repos tag create my-model v1.0 $ hf repos tag create my-model v1.0 -m “First release”

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf repos | repo tag delete

刪除儲存庫的標籤。

用法:

$ hf repos tag delete [OPTIONS] REPO_ID TAG

引數 (Arguments):

• REPO_ID：儲存庫 ID（例如 username/repo-name 或 spaces/username/repo-name）。[必要]
• TAG：要刪除的標籤名稱。[必填]

Options:

• -y, --yes：自動對提示回答「是」。
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --type, --repo-type [model|dataset|space]：儲存庫類型（model、dataset 或 space）。[預設：model]
• --help：顯示此訊息並退出。

範例 $ hf repos tag delete my-model v1.0

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf repos | repo tag list

列出儲存庫的標籤。[別名：ls]

用法:

$ hf repos tag list [OPTIONS] REPO_ID

引數 (Arguments):

• REPO_ID：儲存庫 ID（例如 username/repo-name 或 spaces/username/repo-name）。[必要]

Options:

• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --type, --repo-type [model|dataset|space]：儲存庫類型（model、dataset 或 space）。[預設：model]
• --help：顯示此訊息並退出。

範例 $ hf repos tag list my-model

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf skills

管理 AI 助理的技能。

用法:

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

Options:

• --help：顯示此訊息並退出。

指令 (Commands):

• add：下載 Hugging Face 技能並安裝……
• list：列出 Hugging Face 市場中可用的技能。[別名：ls]
• preview：列印產生的 hf-cli SKILL.md 到……
• update：更新已安裝的 Hugging Face 市場技能……

hf skills add

下載 Hugging Face 技能並為 AI 助理安裝它。

預設位置在當前目錄 (.agents/skills) 或使用者層級 (~/.agents/skills)。若指定 --claude，該技能也會符號連結至 Claude 的舊版技能目錄。

用法:

$ hf skills add [OPTIONS] [NAME]

引數 (Arguments):

• [NAME]：市場中的技能名稱。

Options:

• --claude：為 Claude 安裝。
• -g, --global：全域安裝（使用者層級），而非在當前專案目錄中安裝。
• --dest PATH：安裝到自訂目的地（技能目錄的路徑）。
• --force：覆寫目的地中已存在的技能。
• --help：顯示此訊息並退出。

範例 $ hf skills add $ hf skills add huggingface-gradio —dest=~/my-skills $ hf skills add —global $ hf skills add —claude $ hf skills add huggingface-gradio —claude —global

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf skills list

列出 Hugging Face 市場中可用的技能。[別名：ls]

用法:

$ hf skills list [OPTIONS]

Options:

• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ hf skills list $ hf skills list —format json

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf skills preview

將產生的 hf-cli SKILL.md 列印至標準輸出 (stdout)。

用法:

$ hf skills preview [OPTIONS]

Options:

• --help：顯示此訊息並退出。

hf skills update

更新已安裝的 Hugging Face 市場技能。

用法:

$ hf skills update [OPTIONS] [NAME]

引數 (Arguments):

• [NAME]：選填，指定要更新的已安裝技能名稱。

Options:

• --claude：更新為 Claude 安裝的技能。
• -g, --global：使用全域技能目錄而非當前專案目錄。
• --dest PATH：更新自訂技能目錄中的技能。
• --help：顯示此訊息並退出。

範例 $ hf skills update $ hf skills update hf-cli $ hf skills update huggingface-gradio —dest=~/my-skills $ hf skills update —claude

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf spaces

與 Hub 上的 Spaces 互動。

用法:

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

Options:

• --help：顯示此訊息並退出。

指令 (Commands):

• card：取得 Hub 上某個 Space 的卡片（README）。
• dev-mode：啟用或停用 Space 的開發模式。
• hardware：列出 Spaces 可用的硬體選項。
• hot-reload：熱重載 Space 的任何 Python 檔案……
• info：取得 Hub 上 Space 的資訊。
• list：列出 Hub 上的 Spaces，或列出……中的檔案。[別名：ls]
• logs：獲取 Space 的執行或建置日誌。
• pause：暫停 Space。
• restart：重新啟動 Space。
• search：使用語意搜尋 Hub 上的 Spaces……
• secrets：管理 Hub 上 Space 的密鑰（Secrets）。
• settings：更新 Space 的設定。
• variables：管理 Space 的環境變數……
• volumes：管理 Hub 上 Space 的儲存卷（Volumes）。

hf spaces card

取得 Hub 上某個 Space 的卡片（README）。

用法:

$ hf spaces card [OPTIONS] SPACE_ID

引數 (Arguments):

• SPACE_ID：Space ID（例如 username/repo-name）。[必填]

Options:

• --metadata：僅輸出卡片中的元資料。
• --text：僅輸出文字主體（無元資料）。
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ 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

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf spaces dev-mode

啟用或停用 Space 的開發模式。

Spaces 開發模式（Dev Mode）簡化了應用程式的除錯流程，並讓您可以無需停止 Space 容器即可重新啟動應用程式，從而加快 Spaces 的迭代速度。此功能為 PRO 或 Team & Enterprise 方案的一部分。

參閱文件：https://huggingface.co/docs/hub/spaces-dev-mode

用法:

$ hf spaces dev-mode [OPTIONS] SPACE_ID

引數 (Arguments):

• SPACE_ID：Space ID（例如 username/repo-name）。[必填]

Options:

• --stop / --no-stop：停止開發模式。[預設值：no-stop]
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ hf spaces dev-mode my-user-name/deepsite

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf spaces hardware

列出 Spaces 可用的硬體選項。

用法:

$ hf spaces hardware [OPTIONS]

Options:

• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ hf spaces hardware

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf spaces hot-reload

熱重載 Space 的任何 Python 檔案，無需完全重建 + 重新啟動。

⚠ 此功能為實驗性功能 ⚠

僅適用於 Gradio SDK (6.1+)。除非指定 —local-file/-f，否則會開啟互動式編輯器。

此指令使用 https://github.com/breuleux/jurigged 對即時 Python 進程進行修補（基於 AST 的差異比較、原地函數更新等），並整合 Gradio 原生的熱重載支援（意味著 Gradio 演示物件的變更會反映在 UI 中）。

該指令會建立一個遠端提交。如果您是在本地副本上工作，請在執行後執行 git pull --autostash 以取回該提交，並保持您的本地 git 狀態同步。

用法:

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

引數 (Arguments):

• SPACE_ID：Space ID（例如 username/repo-name）。[必填]
• [FILENAME]：Space 儲存庫中 Python 檔案的路徑。當指定 —local-file 且儲存庫中的路徑相符時，可省略。

Options:

• -f, --local-file PATH：本地檔案的路徑。若未指定，則進入互動式編輯器模式。
• --skip-checks / --no-skip-checks：跳過熱重載相容性檢查。[預設值：no-skip-checks]
• --skip-summary / --no-skip-summary：觸發熱重載後跳過顯示摘要。[預設值：no-skip-summary]
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ hf spaces hot-reload username/repo-name app.py # 開啟互動式編輯器編輯遠端 app.py 檔案 $ hf spaces hot-reload username/repo-name -f app.py # 使用 ./app.py 的本地版本並遠端修補 app.py $ hf spaces hot-reload username/repo-name app.py -f src/app.py # 使用 ./src/app.py 的本地版本

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf spaces info

取得 Hub 上 Space 的資訊。

用法:

$ hf spaces info [OPTIONS] SPACE_ID

引數 (Arguments):

• SPACE_ID：Space ID（例如 username/repo-name）。[必填]

Options:

• --revision TEXT：Git 修訂 ID，可以是分支名稱、標籤或提交雜湊值。
• --expand TEXT：要回傳的逗號分隔屬性。使用時，僅回傳列出的屬性（以及 id）。範例：'—expand=likes,tags'。有效屬性：author, cardData, createdAt, datasets, disabled, lastModified, likes, models, private, resourceGroup, runtime, sdk, sha, siblings, subdomain, tags, trendingScore, usedStorage。
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ hf spaces info enzostvs/deepsite $ hf spaces info gradio/theme_builder —expand sdk,runtime,likes

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf spaces list

列出 Hub 上的 Spaces，或列出 Space 儲存庫中的檔案。[別名：ls]

不加參數呼叫時，列出 Hub 上的 Spaces。指定 Space ID 呼叫時，列出該 Space 儲存庫中的檔案。

用法:

$ hf spaces list [OPTIONS] [REPO_ID]

引數 (Arguments):

• [REPO_ID]：要列出檔案的 Space ID（例如 username/repo-name）。若省略，則列出所有 Spaces。

Options:

• --search TEXT：搜尋查詢。
• --author TEXT：按作者或組織過濾。
• --filter TEXT：按標籤過濾（例如 ‘text-classification’）。可多次使用。
• --sort [created_at|last_modified|likes|trending_score]：排序結果。
• --limit INTEGER：限制結果數量。[預設：30]
• --expand TEXT：要回傳的逗號分隔屬性。使用時，僅回傳列出的屬性（以及 id）。範例：'—expand=likes,tags'。有效屬性：author, cardData, createdAt, datasets, disabled, lastModified, likes, models, private, resourceGroup, runtime, sdk, sha, siblings, subdomain, tags, trendingScore, usedStorage。
• -h, --human-readable：以人類可讀格式顯示大小（僅適用於列出檔案時）。
• --tree：以樹狀格式列出檔案（僅適用於列出檔案時）。
• -R, --recursive：遞迴列出檔案（僅適用於列出檔案時）。
• --revision TEXT：Git 修訂 ID，可以是分支名稱、標籤或提交雜湊值。
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ 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

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf spaces logs

獲取 Space 的執行或建置日誌。

預設會列印當前可用的執行日誌並退出（非阻塞，類似 docker logs）。使用 —follow/-f 可串流輸出直到伺服器關閉連線。使用 —build 可查看容器建置日誌（當 Space 卡在 BUILD_ERROR 時很有用）。

用法:

$ hf spaces logs [OPTIONS] SPACE_ID

引數 (Arguments):

• SPACE_ID：Space ID（例如 username/repo-name）。[必填]

Options:

• --build：獲取容器建置日誌而非執行日誌。當 Space 卡在 BUILD_ERROR 時很有用。
• -f, --follow：追蹤日誌輸出（串流直到伺服器關閉連線）。若無此參數，僅會列印當前可用的日誌。
• -n, --tail INTEGER：從日誌結尾顯示的行數。
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ 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

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf spaces pause

暫停 Space。

用法:

$ hf spaces pause [OPTIONS] SPACE_ID

引數 (Arguments):

• SPACE_ID：Space ID（例如 username/repo-name）。[必填]

Options:

• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ hf spaces pause username/my-space

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf spaces restart

重新啟動 Space。

用法:

$ hf spaces restart [OPTIONS] SPACE_ID

引數 (Arguments):

• SPACE_ID：Space ID（例如 username/repo-name）。[必填]

Options:

• --factory-reboot：不使用建置快取，從頭重新建置 Space。
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ hf spaces restart username/my-space $ hf spaces restart username/my-space —factory-reboot

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf spaces search

使用語意搜尋 Hub 上的 Spaces。

用法:

$ hf spaces search [OPTIONS] QUERY

引數 (Arguments):

• QUERY：搜尋查詢字串。[必填]

Options:

• --filter TEXT：按標籤過濾（例如 ‘text-classification’）。可多次使用。
• --sdk TEXT：依 SDK 過濾（例如 gradio、docker、static）。
• --include-non-running / --no-include-non-running：將未運作中的 Spaces 包含在結果中。[預設值：no-include-non-running]
• --description / --no-description：顯示 AI 生成的描述。[預設值：no-description]
• --limit INTEGER：限制結果數量。[預設：10]
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ 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

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf spaces secrets

管理 Hub 上 Space 的密鑰（Secrets）。

用法:

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

Options:

• --help：顯示此訊息並退出。

指令 (Commands):

• add：為 Space 新增或更新密鑰。
• delete：從 Space 移除密鑰。
• list：列出 Space 的密鑰。[別名：ls]

hf spaces secrets add

為 Space 新增或更新密鑰。

用法:

$ hf spaces secrets add [OPTIONS] SPACE_ID

引數 (Arguments):

• SPACE_ID：Space ID（例如 username/repo-name）。[必填]

Options:

• -s, --secrets TEXT：設定秘密環境變數。例如：—secrets SECRET=value 或 --secrets HF_TOKEN 以傳入您的 Hugging Face 權杖。
• --secrets-file TEXT：讀取秘密環境變數檔案。
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ 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

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf spaces secrets delete

從 Space 移除密鑰。

用法:

$ hf spaces secrets delete [OPTIONS] SPACE_ID KEY

引數 (Arguments):

• SPACE_ID：Space ID（例如 username/repo-name）。[必填]
• KEY：要移除的密鑰名稱。[必填]

Options:

• -y, --yes：自動對提示回答「是」。
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ hf spaces secrets delete username/my-space HF_TOKEN $ hf spaces secrets delete username/my-space HF_TOKEN —yes

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf spaces secrets list

列出 Space 的密鑰。密鑰值為唯寫，不會回傳。[別名：ls]

用法:

$ hf spaces secrets list [OPTIONS] SPACE_ID

引數 (Arguments):

• SPACE_ID：Space ID（例如 username/repo-name）。[必填]

Options:

• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ hf spaces secrets ls username/my-space

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf spaces settings

更新 Space 的設定。

用法:

$ hf spaces settings [OPTIONS] SPACE_ID

引數 (Arguments):

• SPACE_ID：Space ID（例如 username/repo-name）。[必填]

Options:

• --sleep-time INTEGER：Space 進入睡眠的閒置秒數。使用 -1 永不睡眠。僅適用於升級後的硬體。
• --hardware [cpu-basic|cpu-upgrade|cpu-performance|cpu-xl|sprx8|zero-a10g|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|inf2x6]：Space 硬體規格（例如 'cpu-basic'、't4-medium'、'l4x4'）。執行 'hf spaces hardware' 以列出可用選項。
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ hf spaces settings username/my-space —sleep-time 300 $ hf spaces settings username/my-space —hardware t4-medium

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf spaces variables

管理 Hub 上 Space 的環境變數。

用法:

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

Options:

• --help：顯示此訊息並退出。

指令 (Commands):

• add：為 Space 新增或更新環境變數……
• delete：從 Space 移除環境變數。
• list：列出 Space 的環境變數。[別名：ls]

hf spaces variables add

為 Space 新增或更新環境變數。

用法:

$ hf spaces variables add [OPTIONS] SPACE_ID

引數 (Arguments):

• SPACE_ID：Space ID（例如 username/repo-name）。[必填]

Options:

• -e, --env TEXT：設定環境變數。例如：—env ENV=value
• --env-file TEXT：讀取環境變數檔案。
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ 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

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf spaces variables delete

從 Space 移除環境變數。

用法:

$ hf spaces variables delete [OPTIONS] SPACE_ID KEY

引數 (Arguments):

• SPACE_ID：Space ID（例如 username/repo-name）。[必填]
• KEY：要移除的變數名稱。[必填]

Options:

• -y, --yes：自動對提示回答「是」。
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ hf spaces variables delete username/my-space DEBUG $ hf spaces variables delete username/my-space DEBUG —yes

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf spaces variables list

列出 Space 的環境變數。[別名：ls]

用法:

$ hf spaces variables list [OPTIONS] SPACE_ID

引數 (Arguments):

• SPACE_ID：Space ID（例如 username/repo-name）。[必填]

Options:

• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ hf spaces variables ls username/my-space

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf spaces volumes

管理 Hub 上 Space 的儲存卷（Volumes）。

用法:

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

Options:

• --help：顯示此訊息並退出。

指令 (Commands):

• delete：移除 Space 的所有儲存卷。
• list：列出掛載在 Space 中的儲存卷。[別名：ls]
• set：設定（替換）Space 的儲存卷。

hf spaces volumes delete

移除 Space 的所有儲存卷。

用法:

$ hf spaces volumes delete [OPTIONS] SPACE_ID

引數 (Arguments):

• SPACE_ID：Space ID（例如 username/repo-name）。[必填]

Options:

• -y, --yes：自動對提示回答「是」。
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ hf spaces volumes delete username/my-space $ hf spaces volumes delete username/my-space —yes

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf spaces volumes list

列出掛載在 Space 中的儲存卷。[別名：ls]

用法:

$ hf spaces volumes list [OPTIONS] SPACE_ID

引數 (Arguments):

• SPACE_ID：Space ID（例如 username/repo-name）。[必填]

Options:

• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ hf spaces volumes ls username/my-space

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf spaces volumes set

設定（替換）Space 的儲存卷。

用法:

$ hf spaces volumes set [OPTIONS] SPACE_ID

引數 (Arguments):

• SPACE_ID：Space ID（例如 username/repo-name）。[必填]

Options:

• -v, --volume TEXT：掛載一個或多個儲存空間。格式：hf://[TYPE/]SOURCE:/MOUNT_PATH[:ro]。TYPE 可為：models, datasets, spaces, buckets。若省略，TYPE 預設為 models。models、datasets 和 spaces 一律以唯讀（read-only）模式掛載。buckets 預設為讀寫（read+write）模式。例如：-v hf://org/m:/data 或 -v hf://datasets/org/ds:/data 或 -v hf://buckets/org/b:/mnt:ro
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ hf spaces volumes set username/my-space -v hf://models/username/my-model:/models $ hf spaces volumes set username/my-space -v hf://buckets/username/my-bucket:/data -v hf://datasets/username/my-dataset:/datasets:ro

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf sync

同步本機目錄與儲存桶之間的檔案。

用法:

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

引數 (Arguments):

• [SOURCE]：來源路徑：本機目錄或 hf://buckets/namespace/bucket_name(/prefix)
• [DEST]：目的地路徑：本機目錄或 hf://buckets/namespace/bucket_name(/prefix)

Options:

• --delete / --no-delete：刪除目的地中不存在於來源的檔案。[預設：no-delete]
• --ignore-times：僅根據大小跳過檔案，忽略修改時間。
• --ignore-sizes：僅根據修改時間跳過檔案，忽略大小。
• --plan TEXT：將同步計畫儲存至 JSONL 檔案以供審閱，而不執行。
• --apply TEXT：套用先前儲存的計畫檔案。
• --dry-run：將同步計畫以 JSONL 格式列印至標準輸出而不執行。
• --include TEXT：包含符合模式的檔案（可指定多個）。
• --exclude TEXT：排除符合模式的檔案（可指定多個）。
• --filter-from TEXT：從檔案讀取包含/排除模式。
• --existing：跳過在接收端建立新檔案（僅更新現有檔案）。
• --ignore-existing：跳過更新在接收端已存在的檔案（僅建立新檔案）。
• -v, --verbose：顯示詳細的日誌與原因。
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

hf update

將 hf CLI 更新至最新版本。

用法:

$ hf update [OPTIONS]

Options:

• --help：顯示此訊息並退出。

hf upload

上傳檔案或資料夾至 Hub。推薦用於單次提交的上傳。

用法:

$ hf upload [OPTIONS] REPO_ID [LOCAL_PATH] [PATH_IN_REPO]

引數 (Arguments):

• REPO_ID：儲存庫 ID（例如 username/repo-name 或 spaces/username/repo-name）。[必要]
• [LOCAL_PATH]：要上傳的檔案或資料夾的本地路徑。支援萬用字元模式。預設為當前目錄。
• [PATH_IN_REPO]：儲存庫中檔案或資料夾的路徑。預設為該檔案或資料夾的相對路徑。

Options:

• --type, --repo-type [model|dataset|space]：儲存庫類型（model、dataset 或 space）。[預設：model]
• --revision TEXT：Git 修訂 ID，可以是分支名稱、標籤或提交雜湊值。
• --private / --no-private：若 Hub 上不存在該儲存庫，是否建立私人儲存庫。若儲存庫已存在則忽略此參數。
• --include TEXT：用於匹配要上傳檔案的 Glob 模式。
• --exclude TEXT：用於排除上傳檔案的 Glob 模式。
• --delete TEXT：在提交時從儲存庫中刪除檔案的 Glob 模式。
• --commit-message TEXT：產生的提交說明/標題/第一行。
• --commit-description TEXT：產生的提交描述。
• --create-pr / --no-create-pr：是否將內容作為新的 Pull Request 上傳。[預設值：no-create-pr]
• --every FLOAT：若已設定，則排程後台作業，每隔 every 分鐘建立一次提交。
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ hf upload my-cool-model . . $ hf upload Wauplin/my-cool-model ./models/model.safetensors $ hf upload Wauplin/my-cool-dataset ./data /train —repo-type=dataset $ hf upload Wauplin/my-cool-model ./models . —commit-message=“Epoch 34/50” —commit-description=“Val accuracy: 68%” $ hf upload bigcode/the-stack . . —repo-type dataset —create-pr

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf upload-large-folder

上傳大型資料夾至 Hub。推薦用於可恢復的上傳。

用法:

$ hf upload-large-folder [OPTIONS] REPO_ID LOCAL_PATH

引數 (Arguments):

• REPO_ID：儲存庫 ID（例如 username/repo-name 或 spaces/username/repo-name）。[必要]
• LOCAL_PATH：要上傳的資料夾的本地路徑。[必填]

Options:

• --type, --repo-type [model|dataset|space]：儲存庫類型（model、dataset 或 space）。[預設：model]
• --revision TEXT：Git 修訂 ID，可以是分支名稱、標籤或提交雜湊值。
• --private / --no-private：若 Hub 上不存在該儲存庫，是否建立私人儲存庫。若儲存庫已存在則忽略此參數。
• --include TEXT：用於匹配要上傳檔案的 Glob 模式。
• --exclude TEXT：用於排除上傳檔案的 Glob 模式。
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --num-workers INTEGER：用於雜湊、上傳和提交檔案的工作執行緒數量。
• --no-report / --no-no-report：是否停用常規狀態報告。[預設值：no-no-report]
• --no-bars / --no-no-bars：是否停用進度條。[預設值：no-no-bars]
• --help：顯示此訊息並退出。

範例 $ hf upload-large-folder Wauplin/my-cool-model ./large_model_dir $ hf upload-large-folder Wauplin/my-cool-model ./large_model_dir —revision v1.0

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf version

列印 hf 版本資訊。

用法:

$ hf version [OPTIONS]

Options:

• --help：顯示此訊息並退出。

hf webhooks

管理 Hub 上的 Webhooks。

用法:

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

Options:

• --help：顯示此訊息並退出。

指令 (Commands):

• create：建立新的 webhook。
• delete：永久刪除 webhook。
• disable：停用啟用的 webhook。
• enable：啟用停用的 webhook。
• info：顯示單個 webhook 的完整詳情。
• list：列出當前使用者的所有 webhooks。[別名：ls]
• update：更新現有的 webhook。

hf webhooks create

建立新的 webhook。

提供 —url（ping 遠端伺服器）或 —job-id（觸發作業），不可兩者同時提供。

用法:

$ hf webhooks create [OPTIONS]

Options:

• --watch TEXT：要監控的項目，格式為 'type:name'（例如 'model:bert-base-uncased'）。可重複設定。[必填]
• --url TEXT：發送 webhook 酬載（payloads）的 URL。與 —job-id 互斥。
• --job-id TEXT：要觸發的作業 ID（來自 job.id），而非 ping URL。與 —url 互斥。
• --domain [repo|discussions]：要監控的領域：'repo' 或 'discussions'。可重複設定。預設為所有領域。
• --secret TEXT：用於簽署 webhook 酬載的可選密鑰。
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ hf webhooks create —url https://example.com/hook —watch model:bert-base-uncased $ hf webhooks create —url https://example.com/hook —watch org:HuggingFace —watch model:gpt2 —domain repo $ hf webhooks create —job-id 687f911eaea852de79c4a50a —watch user:julien-c

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf webhooks delete

永久刪除 webhook。

用法:

$ hf webhooks delete [OPTIONS] WEBHOOK_ID

引數 (Arguments):

• WEBHOOK_ID：要刪除的 webhook ID。[必填]

Options:

• -y, --yes：跳過確認提示。
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ hf webhooks delete abc123 $ hf webhooks delete abc123 —yes

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf webhooks disable

停用已啟用的 webhook。

用法:

$ hf webhooks disable [OPTIONS] WEBHOOK_ID

引數 (Arguments):

• WEBHOOK_ID：要停用的 webhook ID。[必填]

Options:

• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ hf webhooks disable abc123

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf webhooks enable

啟用停用的 webhook。

用法:

$ hf webhooks enable [OPTIONS] WEBHOOK_ID

引數 (Arguments):

• WEBHOOK_ID：要啟用的 webhook ID。[必填]

Options:

• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ hf webhooks enable abc123

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf webhooks info

顯示單個 webhook 的完整詳情。

用法:

$ hf webhooks info [OPTIONS] WEBHOOK_ID

引數 (Arguments):

• WEBHOOK_ID：webhook ID。[必填]

Options:

• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ hf webhooks info abc123

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf webhooks list

列出當前使用者的所有 webhooks。[別名：ls]

用法:

$ hf webhooks list [OPTIONS]

Options:

• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ hf webhooks ls $ hf webhooks ls —format json $ hf webhooks ls —format quiet

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli

hf webhooks update

更新現有的 webhook。僅變更所提供的選項。

用法:

$ hf webhooks update [OPTIONS] WEBHOOK_ID

引數 (Arguments):

• WEBHOOK_ID：要更新的 webhook ID。[必填]

Options:

• --url TEXT：發送 webhook 酬載的新 URL。
• --watch TEXT：要監控項目的新列表，格式為 'type:name'。可重複設定。會替換掉整個現有的監控列表。
• --domain [repo|discussions]：要監控領域的新列表：'repo' 或 'discussions'。可重複設定。
• --secret TEXT：用於簽署 webhook 酬載的新密鑰。
• --token TEXT：從 https://huggingface.co/settings/tokens 產生的使用者存取權杖。
• --help：顯示此訊息並退出。

範例 $ hf webhooks update abc123 —url https://new-url.com/hook $ hf webhooks update abc123 —watch model:gpt2 —domain repo $ hf webhooks update abc123 —secret newsecret

瞭解更多：使用 hf <command> --help 獲取有關指令的更多資訊。請參閱官方文件：https://huggingface.co/docs/huggingface_hub/en/guides/cli