Hub Python 庫文件
hf
並獲得增強的文件體驗
開始使用
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_IDArguments:
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] TITLEArguments:
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_SLUGArguments:
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_IDArguments:
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_SLUGArguments:
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 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_SLUGArguments:
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_IDArguments:
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_IDArguments:
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.json,data/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:
--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] NAMEArguments:
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] NAMEArguments:
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] NAMEArguments:
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:
--token TEXT: 從 https://huggingface.co/settings/tokens 生成的使用者訪問令牌。--help: 顯示此訊息並退出。
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] NAMEArguments:
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] NAMEArguments:
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] NAMEArguments:
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] NAMEArguments:
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_IDArguments:
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_IDArguments:
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: 列出計劃 Jobresume: 恢復 (取消暫停) 一個計劃 Job。run: 計劃一個 Job。suspend: 暫停 (暫停) 一個計劃 Job。uv: 在 HF 基礎設施上計劃 UV 指令碼。
hf jobs scheduled delete
刪除一個計劃 Job。
用法:
$ hf jobs scheduled delete [OPTIONS] SCHEDULED_JOB_IDArguments:
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_IDArguments:
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_IDArguments:
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] PATHArguments:
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_IDArguments:
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 BRANCHArguments:
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 BRANCHArguments:
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_IDArguments:
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_IDArguments:
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_IDArguments:
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_IDArguments:
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 TAGArguments:
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 TAGArguments:
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_IDArguments:
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_IDArguments:
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_PATHArguments:
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: 顯示此訊息並退出。