Hugging Face CLI アップデート: hf コマンドへの移行

Hugging Face は公式に huggingface-cli を hf に名称変更し、使いやすさと発見性を向上させるために再編成されたコマンド構造を導入しました。このアップデートにより、ユーザーが Hub とやり取りする方法が簡素化され、同時にスクリプトや Docker イメージを Hugging Face インフラ上で実行する新しいサービス hf jobs が導入されます。

新しいコマンド構造と構文

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）でタスクを実行できます。

例コマンド:

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

利用可能な hf jobs サブコマンド:

  • run: ジョブを実行します。
  • ps: アクティブなジョブを一覧表示します。
  • logs: 特定のジョブのログを取得します。
  • inspect: 1つまたは複数のジョブに関する詳細情報を表示します。
  • cancel: ジョブをキャンセルします。
  • uv: HF インフラ上で UV を使用し、インライン依存関係付きの Python スクリプトを実行します。

Sources