Hub Python 庫文件

hf

Hugging Face's logo
加入 Hugging Face 社群

並獲得增強的文件體驗

開始使用

hf

Hugging Face Hub CLI

用法:

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

Options:

  • --install-completion: 為當前 shell 安裝補全。
  • --show-completion: 顯示當前 shell 的補全,用於複製或自定義安裝。
  • --help: 顯示此訊息並退出。

Commands:

  • auth: 管理認證(登入、登出等)。
  • cache: 管理本地快取目錄。
  • collections: 與 Hub 上的集合進行互動。
  • datasets: 與 Hub 上的資料集進行互動。
  • download: 從 Hub 下載檔案。
  • endpoints: 管理 Hugging Face 推理端點。
  • env: 列印環境資訊。
  • jobs: 在 Hub 上執行和管理作業。
  • lfs-enable-largefiles: 配置您的倉庫以啟用上傳…
  • lfs-multipart-upload: git-lfs 的內部自定義傳輸代理,用於…
  • models: 與 Hub 上的模型進行互動。
  • papers: 與 Hub 上的論文進行互動。
  • repo: 管理 Hub 上的倉庫。
  • repo-files: 管理 Hub 上倉庫中的檔案。
  • skills: 管理 AI 助手的技能。
  • spaces: 與 Hub 上的 Space 進行互動。
  • upload: 將檔案或資料夾上傳到 Hub。
  • upload-large-folder: 將大型資料夾上傳到 Hub。
  • version: 列印 hf 版本資訊。

hf auth

管理認證(登入、登出等)。

用法:

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

Options:

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

Commands:

  • list: 列出所有儲存的訪問令牌。
  • login: 使用來自…的令牌登入。
  • logout: 從特定令牌登出。
  • switch: 在訪問令牌之間切換。
  • whoami: 找出您已登入的 huggingface.co 帳戶…

hf auth list

列出所有儲存的訪問令牌。

用法:

$ 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]
  • --help: 顯示此訊息並退出。

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

瞭解更多 使用 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 whoami

找出您已登入的 huggingface.co 帳戶。

用法:

$ hf auth whoami [OPTIONS]

Options:

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

示例 $ hf auth whoami

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

hf cache

管理本地快取目錄。

用法:

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

Options:

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

Commands:

  • ls: 列出快取的倉庫或修訂版本。
  • prune: 從快取中移除未附加的修訂版本。
  • rm: 移除快取的倉庫或修訂版本。
  • verify: 驗證單個倉庫的校驗和…

hf cache ls

列出快取的倉庫或修訂版本。

用法:

$ hf cache ls [OPTIONS]

Options:

  • --cache-dir TEXT: 要掃描的快取目錄(預設為 Hugging Face 快取)。
  • --revisions / --no-revisions: 在輸出中包含修訂版本而不是聚合的倉庫。[預設值: no-revisions]
  • -f, --filter TEXT: 過濾條目(例如,“size>1GB”、“type=model”、“accessed>7d”)。可以使用多次。
  • --format [table|json]: 輸出格式。[預設值: table]
  • -q, --quiet: 僅列印 ID(倉庫 ID 或修訂雜湊)。
  • --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)或修訂雜湊。[必需]

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 <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)。[必需]

Options:

  • --repo-type [model|dataset|space]: 倉庫型別(模型、資料集或 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 上集合的資訊。
  • ls: 列出 Hub 上的集合。
  • update: 更新 Hub 上集合的元資料。
  • update-item: 更新集合中的專案。

hf collections add-item

將專案新增到集合。

用法:

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

Arguments:

  • COLLECTION_SLUG: 集合的 slug(例如,“username/collection-slug”)。[必需]
  • ITEM_ID: 要新增的專案的 ID(倉庫 ID 用於倉庫,論文 ID 用於論文)。[必需]
  • ITEM_TYPE:{model|dataset|space|paper|collection}: 專案的型別(模型、資料集、Space、論文或集合)。[必需]

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 “我的模型” $ hf collections create “我的模型” —description “我最喜歡的模型集合” —private $ hf collections create “組織集合” —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(來自“item_object_id”欄位,而不是 repo_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:

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

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

hf collections ls

列出 Hub 上的集合。

用法:

$ hf collections ls [OPTIONS]

Options:

  • --owner TEXT: 按所有者使用者名稱或組織過濾。
  • --item TEXT: 過濾包含特定專案的集合(例如,“models/gpt2”、“datasets/squad”、“papers/2311.12983”)。
  • --sort [lastModified|trending|upvotes]: 按最後修改時間、熱門或點贊數排序結果。
  • --limit INTEGER: 限制結果數量。[預設值: 10]
  • --format [table|json]: 輸出格式(表格或 JSON)。[預設值: table]
  • -q, --quiet: 僅列印 ID(每行一個)。
  • --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 “新標題” $ hf collections update username/my-collection —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 “更新的註釋” $ 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:

  • info: 獲取 Hub 上資料集的資訊。
  • ls: 列出 Hub 上的資料集。

hf datasets info

獲取 Hub 上資料集的資訊。

用法:

$ hf datasets info [OPTIONS] DATASET_ID

Arguments:

  • DATASET_ID: 資料集 ID(例如 username/repo-name)。[必需]

Options:

  • --revision TEXT: Git 修訂 ID,可以是分支名稱、標籤或提交雜湊。
  • --expand TEXT: 要展開的逗號分隔的屬性。例如:‘—expand=downloads,likes,tags’。有效值:author, cardData, citation, createdAt, description, disabled, downloads, downloadsAllTime, gated, lastModified, likes, 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 ls

列出 Hub 上的資料集。

用法:

$ hf datasets ls [OPTIONS]

Options:

  • --search TEXT: 搜尋查詢。
  • --author TEXT: 按作者或組織過濾。
  • --filter TEXT: 按標籤過濾(例如,“text-classification”)。可以使用多次。
  • --sort [created_at|downloads|last_modified|likes|trending_score]: 對結果進行排序。
  • --limit INTEGER: 限制結果數量。[預設值: 10]
  • --expand TEXT: 要展開的逗號分隔的屬性。例如:‘—expand=downloads,likes,tags’。有效值:author, cardData, citation, createdAt, description, disabled, downloads, downloadsAllTime, gated, lastModified, likes, paperswithcode_id, private, resourceGroup, sha, siblings, tags, trendingScore, usedStorage。
  • --format [table|json]: 輸出格式(表格或 JSON)。[預設值: table]
  • -q, --quiet: 僅列印 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 <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)。[必需]
  • [FILENAMES]...: 要下載的檔案(例如 config.jsondata/metadata.jsonl)。

Options:

  • --repo-type [model|dataset|space]: 倉庫型別(模型、資料集或 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,則執行模擬執行,而不實際下載檔案。[預設值: no-dry-run]
  • --token TEXT: 從 https://huggingface.co/settings/tokens 生成的使用者訪問令牌。
  • --quiet / --no-quiet: 如果為 True,則停用進度條,並且僅列印下載檔案的路徑。[預設值: no-quiet]
  • --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 <command> --help 獲取有關命令的更多資訊。請訪問 https://huggingface.co/docs/huggingface_hub/en/guides/cli 閱讀文件。

hf endpoints

管理 Hugging Face 推理端點。

用法:

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

Options:

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

Commands:

  • catalog: 與推理端點…互動。
  • delete: 永久刪除推理端點。
  • deploy: 從 Hub…部署推理端點。
  • describe: 獲取現有端點的資訊。
  • list-catalog: 列出可用的目錄模型。
  • ls: 列出所有推理端點…
  • pause: 暫停推理端點。
  • resume: 恢復推理端點。
  • scale-to-zero: 將推理端點縮減為零。
  • update: 更新現有端點。

hf endpoints catalog

與推理端點目錄互動。

用法:

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

Options:

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

Commands:

  • deploy: 從…部署推理端點。
  • ls: 列出可用的目錄模型。

hf endpoints catalog deploy

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

用法:

$ hf endpoints catalog deploy [OPTIONS]

Options:

  • --repo TEXT: 與推理端點關聯的模型倉庫名稱(例如,“openai/gpt-oss-120b”)。[必需]
  • --name TEXT: 端點名稱。
  • --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 ls

列出可用的目錄模型。

用法:

$ hf endpoints catalog ls [OPTIONS]

Options:

示例 $ 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-catalog

列出可用的目錄模型。

用法:

$ hf endpoints list-catalog [OPTIONS]

Options:

hf endpoints ls

列出給定名稱空間的所有推理端點。

用法:

$ hf endpoints ls [OPTIONS]

Options:

  • --namespace TEXT: 與推理端點關聯的名稱空間。預設為當前使用者的名稱空間。
  • --format [table|json]: 輸出格式(表格或 JSON)。[預設值: table]
  • -q, --quiet: 僅列印 ID(每行一個)。
  • --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 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 jobs

在 Hub 上執行和管理作業。

用法:

$ 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 [必需]

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

顯示一個或多個 Job 的詳細資訊

用法:

$ hf jobs inspect [OPTIONS] JOB_IDS...

Arguments:

  • JOB_IDS...: 要檢查的 Job [必需]

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

獲取 Job 的日誌

用法:

$ hf jobs logs [OPTIONS] JOB_ID

Arguments:

  • JOB_ID: 作業 ID [必需]

Options:

  • --namespace TEXT: 作業將執行的名稱空間。預設為當前使用者的名稱空間。
  • --token TEXT: 從 https://huggingface.co/settings/tokens 生成的使用者訪問令牌。
  • --help: 顯示此訊息並退出。

示例 $ hf jobs logs <job_id>

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

hf jobs ps

列出 Jobs。

用法:

$ hf jobs ps [OPTIONS]

Options:

  • -a, --all: 顯示所有 Jobs (預設僅顯示執行中的)
  • --namespace TEXT: 作業將執行的名稱空間。預設為當前使用者的名稱空間。
  • --token TEXT: 從 https://huggingface.co/settings/tokens 生成的使用者訪問令牌。
  • -f, --filter TEXT: 根據提供的條件過濾輸出 (格式: key=value)
  • --format TEXT: 使用自定義模板格式化輸出
  • --help: 顯示此訊息並退出。

示例 $ hf jobs ps $ hf jobs ps -a

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

hf jobs run

執行一個 Job。

用法:

$ 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 token。
  • -l, --label TEXT: 設定標籤。例如: —label KEY=VALUE 或 —label LABEL
  • --env-file TEXT: 讀取環境變數檔案。
  • --secrets-file TEXT: 讀取秘密環境變數檔案。
  • --flavor [cpu-basic|cpu-upgrade|cpu-xl|zero-a10g|t4-small|t4-medium|l4x1|l4x4|l40sx1|l40sx4|l40sx8|a10g-small|a10g-large|a10g-largex2|a10g-largex4|a100-large|a100x4|a100x8]: 硬體的型別,如同 HF Spaces。執行 ‘hf jobs hardware’ 列出可用的型別。預設為 cpu-basic
  • --timeout TEXT: 最長持續時間: 整數/浮點數,帶 s (秒, 預設), m (分鐘), h (小時) 或 d (天)。
  • -d, --detach: 在後臺執行 Job 並列印 Job 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 <command> --help 獲取有關命令的更多資訊。請訪問 https://huggingface.co/docs/huggingface_hub/en/guides/cli 閱讀文件。

hf jobs scheduled

在 Hub 上建立和管理計劃 Job。

用法:

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

Options:

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

Commands:

  • delete: 刪除一個計劃 Job。
  • inspect: 顯示一個或更多的詳細資訊…
  • ps: 列出計劃 Job
  • resume: 恢復 (取消暫停) 一個計劃 Job。
  • run: 計劃一個 Job。
  • suspend: 暫停 (暫停) 一個計劃 Job。
  • uv: 在 HF 基礎設施上計劃 UV 指令碼。

hf jobs scheduled delete

刪除一個計劃 Job。

用法:

$ hf jobs scheduled delete [OPTIONS] SCHEDULED_JOB_ID

Arguments:

  • SCHEDULED_JOB_ID: 計劃 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

顯示一個或多個計劃 Job 的詳細資訊

用法:

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

Arguments:

  • SCHEDULED_JOB_IDS...: 要檢查的計劃 Job [必需]

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

列出計劃 Job

用法:

$ hf jobs scheduled ps [OPTIONS]

Options:

  • -a, --all: 顯示所有計劃 Job (預設隱藏已暫停的)
  • --namespace TEXT: 作業將執行的名稱空間。預設為當前使用者的名稱空間。
  • --token TEXT: 從 https://huggingface.co/settings/tokens 生成的使用者訪問令牌。
  • -f, --filter TEXT: 根據提供的條件過濾輸出 (格式: key=value)
  • --format TEXT: 使用自定義模板格式化輸出
  • --help: 顯示此訊息並退出。

示例 $ hf jobs scheduled ps

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

hf jobs scheduled resume

恢復 (取消暫停) 一個計劃 Job。

用法:

$ hf jobs scheduled resume [OPTIONS] SCHEDULED_JOB_ID

Arguments:

  • SCHEDULED_JOB_ID: 計劃 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

計劃一個 Job。

用法:

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

Arguments:

  • SCHEDULE: annually, yearly, monthly, weekly, daily, hourly, 或 CRON 表示式之一。 [必需]
  • IMAGE: 要使用的 Docker 映象。 [必需]
  • COMMAND...: 要執行的命令。 [必需]

Options:

  • --suspend / --no-suspend: 暫停 (暫停) 計劃 Job
  • --concurrency / --no-concurrency: 允許此 Job 的多個例項同時執行
  • -e, --env TEXT: 設定環境變數。例如: —env ENV=value
  • -s, --secrets TEXT: 設定秘密環境變數。例如: —secrets SECRET=value 或 --secrets HF_TOKEN 傳遞你的 Hugging Face token。
  • -l, --label TEXT: 設定標籤。例如: —label KEY=VALUE 或 —label LABEL
  • --env-file TEXT: 讀取環境變數檔案。
  • --secrets-file TEXT: 讀取秘密環境變數檔案。
  • --flavor [cpu-basic|cpu-upgrade|cpu-xl|zero-a10g|t4-small|t4-medium|l4x1|l4x4|l40sx1|l40sx4|l40sx8|a10g-small|a10g-large|a10g-largex2|a10g-largex4|a100-large|a100x4|a100x8]: 硬體的型別,如同 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

暫停 (暫停) 一個計劃 Job。

用法:

$ hf jobs scheduled suspend [OPTIONS] SCHEDULED_JOB_ID

Arguments:

  • SCHEDULED_JOB_ID: 計劃 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: 執行一個 UV 指令碼 (本地檔案或 URL) 在 HF…
hf jobs scheduled uv run

在 HF 基礎設施上執行 UV 指令碼 (本地檔案或 URL)

用法:

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

Arguments:

  • SCHEDULE: annually, yearly, monthly, weekly, daily, hourly, 或 CRON 表示式之一。 [必需]
  • SCRIPT: 要執行的 UV 指令碼 (本地檔案或 URL) [必需]
  • [SCRIPT_ARGS]...: 指令碼的引數

Options:

  • --suspend / --no-suspend: 暫停 (暫停) 計劃 Job
  • --concurrency / --no-concurrency: 允許此 Job 的多個例項同時執行
  • --image TEXT: 使用安裝了 uv 的自定義 Docker 映象。
  • --flavor [cpu-basic|cpu-upgrade|cpu-xl|zero-a10g|t4-small|t4-medium|l4x1|l4x4|l40sx1|l40sx4|l40sx8|a10g-small|a10g-large|a10g-largex2|a10g-largex4|a100-large|a100x4|a100x8]: 硬體的型別,如同 HF Spaces。執行 ‘hf jobs hardware’ 列出可用的型別。預設為 cpu-basic
  • -e, --env TEXT: 設定環境變數。例如: —env ENV=value
  • -s, --secrets TEXT: 設定秘密環境變數。例如: —secrets SECRET=value 或 --secrets HF_TOKEN 傳遞你的 Hugging Face token。
  • -l, --label TEXT: 設定標籤。例如: —label KEY=VALUE 或 —label LABEL
  • --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

獲取 Jobs 的資源使用統計資料和指標

用法:

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

Arguments:

  • [JOB_IDS]...: Job IDs

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: 執行一個 UV 指令碼 (本地檔案或 URL) 在 HF…

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-xl|zero-a10g|t4-small|t4-medium|l4x1|l4x4|l40sx1|l40sx4|l40sx8|a10g-small|a10g-large|a10g-largex2|a10g-largex4|a100-large|a100x4|a100x8]: 硬體的型別,如同 HF Spaces。執行 ‘hf jobs hardware’ 列出可用的型別。預設為 cpu-basic
  • -e, --env TEXT: 設定環境變數。例如: —env ENV=value
  • -s, --secrets TEXT: 設定秘密環境變數。例如: —secrets SECRET=value 或 --secrets HF_TOKEN 傳遞你的 Hugging Face token。
  • -l, --label TEXT: 設定標籤。例如: —label KEY=VALUE 或 —label LABEL
  • --env-file TEXT: 讀取環境變數檔案。
  • --secrets-file TEXT: 讀取秘密環境變數檔案。
  • --timeout TEXT: 最長持續時間: 整數/浮點數,帶 s (秒, 預設), m (分鐘), h (小時) 或 d (天)。
  • -d, --detach: 在後臺執行 Job 並列印 Job 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 <command> --help 獲取有關命令的更多資訊。請訪問 https://huggingface.co/docs/huggingface_hub/en/guides/cli 閱讀文件。

hf lfs-enable-largefiles

配置你的倉庫以啟用上傳大於 5GB 的檔案。

此命令設定 git-lfs 以使用自定義分塊傳輸代理,從而能夠高效地分塊上傳大檔案。

用法:

$ 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:

  • info: 獲取 Hub 上模型的詳細資訊。
  • ls: 列出 Hub 上的模型。

hf models info

獲取 Hub 上模型的詳細資訊。

用法:

$ hf models info [OPTIONS] MODEL_ID

Arguments:

  • MODEL_ID: 模型 ID (例如 username/repo-name)。 [必需]

Options:

  • --revision TEXT: Git 修訂 ID,可以是分支名稱、標籤或提交雜湊。
  • --expand TEXT: 要展開的逗號分隔的屬性。例如: ‘—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 gpt2 —expand downloads,likes,tags

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

hf models ls

列出 Hub 上的模型。

用法:

$ hf models ls [OPTIONS]

Options:

  • --search TEXT: 搜尋查詢。
  • --author TEXT: 按作者或組織過濾。
  • --filter TEXT: 按標籤過濾(例如,“text-classification”)。可以使用多次。
  • --sort [created_at|downloads|last_modified|likes|trending_score]: 對結果進行排序。
  • --limit INTEGER: 限制結果數量。[預設值: 10]
  • --expand TEXT: 要展開的逗號分隔的屬性。例如: ‘—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。
  • --format [table|json]: 輸出格式(表格或 JSON)。[預設值: table]
  • -q, --quiet: 僅列印 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 <command> --help 獲取有關命令的更多資訊。請訪問 https://huggingface.co/docs/huggingface_hub/en/guides/cli 閱讀文件。

hf papers

與 Hub 上的論文進行互動。

用法:

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

Options:

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

Commands:

  • ls: 列出 Hub 上的每日論文。

hf papers ls

列出 Hub 上的每日論文。

用法:

$ hf papers ls [OPTIONS]

Options:

  • --date TEXT: 日期,ISO 格式 (YYYY-MM-DD) 或 ‘today’。
  • --sort [publishedAt|trending]: 排序結果。
  • --limit INTEGER: 限制結果數量。 [default: 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 <command> --help 獲取有關命令的更多資訊。請訪問 https://huggingface.co/docs/huggingface_hub/en/guides/cli 閱讀文件。

hf repo

管理 Hub 上的倉庫。

用法:

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

Options:

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

Commands:

  • branch: 管理 Hub 上倉庫的分支。
  • create: 在 Hub 上建立新倉庫。
  • delete: 從 Hub 刪除倉庫。
  • move: 將倉庫從一個名稱空間移動到…
  • settings: 更新倉庫的設定。
  • tag: 管理 Hub 上倉庫的標籤。

hf repo branch

管理 Hub 上倉庫的分支。

用法:

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

Options:

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

Commands:

  • create: 為倉庫在 Hub 上建立新分支。
  • delete: 從 Hub 倉庫刪除分支。

hf repo branch create

為倉庫在 Hub 上建立新分支。

用法:

$ hf repo branch create [OPTIONS] REPO_ID BRANCH

Arguments:

  • REPO_ID: 倉庫 ID(例如 username/repo-name)。[必需]
  • BRANCH: 要建立的分支名稱。 [必需]

Options:

  • --revision TEXT: Git 修訂 ID,可以是分支名稱、標籤或提交雜湊。
  • --token TEXT: 從 https://huggingface.co/settings/tokens 生成的使用者訪問令牌。
  • --repo-type [model|dataset|space]: 倉庫型別(模型、資料集或 Space)。[預設值: model]
  • --exist-ok / --no-exist-ok: 如果設定為 True,則在分支已存在時不會引發錯誤。 [default: no-exist-ok]
  • --help: 顯示此訊息並退出。

示例 $ hf repo branch create my-model dev $ hf repo branch create my-model dev —revision abc123

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

hf repo branch delete

從 Hub 倉庫刪除分支。

用法:

$ hf repo branch delete [OPTIONS] REPO_ID BRANCH

Arguments:

  • REPO_ID: 倉庫 ID(例如 username/repo-name)。[必需]
  • BRANCH: 要刪除的分支名稱。 [必需]

Options:

  • --token TEXT: 從 https://huggingface.co/settings/tokens 生成的使用者訪問令牌。
  • --repo-type [model|dataset|space]: 倉庫型別(模型、資料集或 Space)。[預設值: model]
  • --help: 顯示此訊息並退出。

示例 $ hf repo branch delete my-model dev

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

hf repo create

在 Hub 上建立新倉庫。

用法:

$ hf repo create [OPTIONS] REPO_ID

Arguments:

  • REPO_ID: 倉庫 ID(例如 username/repo-name)。[必需]

Options:

  • --repo-type [model|dataset|space]: 倉庫型別(模型、資料集或 Space)。[預設值: model]
  • --space-sdk TEXT: Hugging Face Spaces SDK 型別。當 —type 設定為 ‘space’ 時必需。
  • --private / --no-private: 是否建立私有倉庫 (如果倉庫在 Hub 上不存在)。如果倉庫已存在,則忽略。
  • --token TEXT: 從 https://huggingface.co/settings/tokens 生成的使用者訪問令牌。
  • --exist-ok / --no-exist-ok: 如果倉庫已存在,則不引發錯誤。 [default: no-exist-ok]
  • --resource-group-id TEXT: 要在其建立倉庫的資源組。資源組僅適用於 Enterprise Hub 組織。
  • --help: 顯示此訊息並退出。

示例 $ hf repo create my-model $ hf repo create my-dataset —repo-type dataset —private

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

hf repo delete

從 Hub 刪除倉庫。這是一個不可逆的操作。

用法:

$ hf repo delete [OPTIONS] REPO_ID

Arguments:

  • REPO_ID: 倉庫 ID(例如 username/repo-name)。[必需]

Options:

  • --repo-type [model|dataset|space]: 倉庫型別(模型、資料集或 Space)。[預設值: model]
  • --token TEXT: 從 https://huggingface.co/settings/tokens 生成的使用者訪問令牌。
  • --missing-ok / --no-missing-ok: 如果設定為 True,則在倉庫不存在時不會引發錯誤。 [default: no-missing-ok]
  • --help: 顯示此訊息並退出。

示例 $ hf repo delete my-model

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

hf repo move

將倉庫從一個名稱空間移動到另一個名稱空間。

用法:

$ hf repo move [OPTIONS] FROM_ID TO_ID

Arguments:

  • FROM_ID: 倉庫 ID (例如 username/repo-name)。 [必需]
  • TO_ID: 倉庫 ID (例如 username/repo-name)。 [必需]

Options:

  • --token TEXT: 從 https://huggingface.co/settings/tokens 生成的使用者訪問令牌。
  • --repo-type [model|dataset|space]: 倉庫型別(模型、資料集或 Space)。[預設值: model]
  • --help: 顯示此訊息並退出。

示例 $ hf repo move old-namespace/my-model new-namespace/my-model

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

hf repo settings

更新倉庫的設定。

用法:

$ hf repo settings [OPTIONS] REPO_ID

Arguments:

  • REPO_ID: 倉庫 ID(例如 username/repo-name)。[必需]

Options:

  • --gated [auto|manual|false]: 倉庫的受保護狀態。
  • --private / --no-private: 倉庫是否應該是私有的。
  • --token TEXT: 從 https://huggingface.co/settings/tokens 生成的使用者訪問令牌。
  • --repo-type [model|dataset|space]: 倉庫型別(模型、資料集或 Space)。[預設值: model]
  • --help: 顯示此訊息並退出。

示例 $ hf repo settings my-model —private $ hf repo settings my-model —gated auto

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

hf repo tag

管理 Hub 上倉庫的標籤。

用法:

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

Options:

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

Commands:

  • create: 為倉庫建立標籤。
  • delete: 刪除倉庫的標籤。
  • list: 列出倉庫的標籤。

hf repo tag create

為倉庫建立標籤。

用法:

$ hf repo tag create [OPTIONS] REPO_ID TAG

Arguments:

  • REPO_ID: 倉庫 ID(例如 username/repo-name)。[必需]
  • TAG: 要建立的標籤名稱。 [必需]

Options:

  • -m, --message TEXT: 要建立的標籤的描述。
  • --revision TEXT: Git 修訂 ID,可以是分支名稱、標籤或提交雜湊。
  • --token TEXT: 從 https://huggingface.co/settings/tokens 生成的使用者訪問令牌。
  • --repo-type [model|dataset|space]: 倉庫型別(模型、資料集或 Space)。[預設值: model]
  • --help: 顯示此訊息並退出。

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

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

hf repo tag delete

刪除倉庫的標籤。

用法:

$ hf repo tag delete [OPTIONS] REPO_ID TAG

Arguments:

  • REPO_ID: 倉庫 ID(例如 username/repo-name)。[必需]
  • TAG: 要刪除的標籤名稱。 [必需]

Options:

  • -y, --yes: 自動回答是
  • --token TEXT: 從 https://huggingface.co/settings/tokens 生成的使用者訪問令牌。
  • --repo-type [model|dataset|space]: 倉庫型別(模型、資料集或 Space)。[預設值: model]
  • --help: 顯示此訊息並退出。

示例 $ hf repo tag delete my-model v1.0

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

hf repo tag list

列出倉庫的標籤。

用法:

$ hf repo tag list [OPTIONS] REPO_ID

Arguments:

  • REPO_ID: 倉庫 ID(例如 username/repo-name)。[必需]

Options:

  • --token TEXT: 從 https://huggingface.co/settings/tokens 生成的使用者訪問令牌。
  • --repo-type [model|dataset|space]: 倉庫型別(模型、資料集或 Space)。[預設值: model]
  • --help: 顯示此訊息並退出。

示例 $ hf repo tag list my-model

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

hf repo-files

管理 Hub 上倉庫的檔案。

用法:

$ hf repo-files [OPTIONS] COMMAND [ARGS]...

Options:

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

Commands:

  • delete

hf repo-files delete

用法:

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

Arguments:

  • REPO_ID: 倉庫 ID(例如 username/repo-name)。[必需]
  • PATTERNS...: 用於匹配要刪除檔案的 Glob 模式。基於 fnmatch,'*' 遞迴匹配檔案。 [必需]

Options:

  • --repo-type [model|dataset|space]: 倉庫型別(模型、資料集或 Space)。[預設值: model]
  • --revision TEXT: Git 修訂 ID,可以是分支名稱、標籤或提交雜湊。
  • --commit-message TEXT: 生成的提交摘要 / 標題 / 第一行。
  • --commit-description TEXT: 生成的提交描述。
  • --create-pr / --no-create-pr: 是否為這些更改建立一個新的 Pull Request。 [default: no-create-pr]
  • --token TEXT: 從 https://huggingface.co/settings/tokens 生成的使用者訪問令牌。
  • --help: 顯示此訊息並退出。

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

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

hf skills

管理 AI 助手的技能。

用法:

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

Options:

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

Commands:

  • add: 下載一個技能並將其安裝給 AI…

hf skills add

下載一個技能並將其安裝給 AI 助手。

用法:

$ hf skills add [OPTIONS]

Options:

  • --claude: 安裝給 Claude。
  • --codex: 安裝給 Codex。
  • --opencode: 安裝給 OpenCode。
  • -g, --global: 全域性安裝 (使用者級別),而不是在當前專案目錄中。
  • --dest PATH: 安裝到自定義目的地 (技能目錄路徑)。
  • --force: 覆蓋目的地已存在的技能。
  • --help: 顯示此訊息並退出。

示例 $ hf skills add —claude $ hf skills add —claude —global $ hf skills add —codex —opencode

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

hf spaces

與 Hub 上的 Spaces 進行互動。

用法:

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

Options:

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

Commands:

  • info: 獲取 Hub 上 Space 的詳細資訊。
  • ls: 列出 Hub 上的 Spaces。

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: 要展開的逗號分隔的屬性。例如: ‘—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 ls

列出 Hub 上的 Spaces。

用法:

$ hf spaces ls [OPTIONS]

Options:

  • --search TEXT: 搜尋查詢。
  • --author TEXT: 按作者或組織過濾。
  • --filter TEXT: 按標籤過濾(例如,“text-classification”)。可以使用多次。
  • --sort [created_at|last_modified|likes|trending_score]: 排序結果。
  • --limit INTEGER: 限制結果數量。[預設值: 10]
  • --expand TEXT: 要展開的逗號分隔的屬性。例如: ‘—expand=likes,tags’。有效值: author, cardData, createdAt, datasets, disabled, lastModified, likes, models, private, resourceGroup, runtime, sdk, sha, siblings, subdomain, tags, trendingScore, usedStorage。
  • --format [table|json]: 輸出格式(表格或 JSON)。[預設值: table]
  • -q, --quiet: 僅列印 ID(每行一個)。
  • --token TEXT: 從 https://huggingface.co/settings/tokens 生成的使用者訪問令牌。
  • --help: 顯示此訊息並退出。

示例 $ hf spaces ls —limit 10 $ hf spaces ls —search “chatbot” —author huggingface

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

hf upload

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

用法:

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

Arguments:

  • REPO_ID: 倉庫 ID(例如 username/repo-name)。[必需]
  • [LOCAL_PATH]: 要上傳的檔案或資料夾的本地路徑。支援萬用字元模式。預設為當前目錄。
  • [PATH_IN_REPO]: 在倉庫中的檔案或資料夾的路徑。預設為檔案或資料夾的相對路徑。

Options:

  • --repo-type [model|dataset|space]: 倉庫型別(模型、資料集或 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 上傳。 [default: no-create-pr]
  • --every FLOAT: 如果設定,將計劃一個後臺作業,每 every 分鐘建立一個提交。
  • --token TEXT: 從 https://huggingface.co/settings/tokens 生成的使用者訪問令牌。
  • --quiet / --no-quiet: 停用進度條和警告;僅列印返回的路徑。 [default: no-quiet]
  • --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)。[必需]
  • LOCAL_PATH: 要上傳的資料夾的本地路徑。 [必需]

Options:

  • --repo-type [model|dataset|space]: 倉庫型別(模型、資料集或 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: 用於雜湊、上傳和提交檔案的 worker 數量。
  • --no-report / --no-no-report: 是否停用常規狀態報告。 [default: no-no-report]
  • --no-bars / --no-no-bars: 是否停用進度條。 [default: 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: 顯示此訊息並退出。
在 GitHub 上更新

© . This site is unofficial and not affiliated with Hugging Face, Inc.