Hugging Face CLI 更新：轉換至 hf 指令

Hugging Face 已正式將 huggingface-cli 改名為 hf，並引入重新組織的指令結構，以提升人體工學與可發現性。此更新簡化了使用者與 Hub 的互動，同時推出 hf jobs，這是一項在 Hugging Face 基礎設施上執行腳本與 Docker 映像的新服務。

新指令結構與語法

hf CLI 採用可預測的 hf <resource> <action> 語法。此重新組織拋棄了先前較不一致的指令結構，改為更直觀的格式，將指令依其管理的資源分組。

核心指令群組

大多數功能現在依照特定資源分類。主要的指令群組包括：

  • hf auth：管理驗證，包括登入、登出以及在存取令牌之間切換。
  • hf cache：處理本機快取目錄。
  • hf repo：管理 Hub 上的倉庫。
  • hf repo-files：管理倉庫內的檔案。
  • hf upload 與 hf download：由於使用頻率高，仍保留在根層級。

安裝與驗證

要使用新 CLI，使用者必須安裝或更新 huggingface_hub 套件：

pip install -U huggingface_hub

安裝成功後，可執行 hf version 進行驗證，該指令會回傳 huggingface_hub 的版本（例如，0.34.0 版）。

從 huggingface-cli 遷移

儘管舊版 huggingface-cli 仍可使用以確保平順過渡，但已被棄用。使用舊指令時會觸發警告，指示使用者改用新的 hf 等價指令。

驗證變更

遷移過程中最重要的變更是驗證指令。以下為對應範例：

  • huggingface-cli login → hf auth login
  • huggingface-cli whoami → hf auth whoami
  • huggingface-cli logout → hf auth logout

介紹 hf jobs

hf jobs 是一項新服務，允許使用者在 Hugging Face 基礎設施上以即付即用的計費模式執行腳本或 Docker 映像。此服務僅對 Pro 用戶以及 Team 或 Enterprise 組織開放。

功能與指令集合

hf jobs 的指令集合受到 Docker CLI 的啟發，允許在特定硬體規格（例如 A10G GPU）上執行任務。

Example Command:

hf jobs run --flavor=a10g-small ubuntu nvidia-smi

可用的 hf jobs 子指令：

  • run：執行工作。
  • ps：列出執行中的工作。
  • logs：取得特定工作的日誌。
  • inspect：顯示一或多個工作的詳細資訊。
  • cancel：取消工作。
  • uv：在 HF 基礎設施上使用 UV 執行帶有內嵌相依性的 Python 腳本。

Sources