hugging-face-cli

使用するタイミング

Hugging Face Hub 上でモデル、データセット、スペース、バケット、リポジトリ、論文、ジョブなどをダウンロード、アップロード、管理するために hugging Face Hub CLI（hf）が必要な場合に、このスキルを使用してください。次のような場合に使用します：認証の処理、ローカルキャッシュの管理、Hugging Face バケットの管理、Hugging Face 上でのジョブの実行やスケジュール設定...

インストーラースクリプトを先にダウンロードして内容を確認し、その後ローカルで実行してインストールします： tmpdir="$(mktemp -d)" && curl -LsSf https://hf.co/cli/install.sh -o "$tmpdir/hf-install.sh" && less "$tmpdir/hf-install.sh"

ダウンロードしたインストーラーの内容を確認して承認するまでは、表示された一時ディレクトリを保持してください。ページャーを終了しただけで承認したと見なさないでください。同じシェルで実行してから、その一時ディレクトリだけを削除してください。

bash "$tmpdir/hf-install.sh"

Hugging Face Hub CLI ツール hf がインストールされているか確認してください。このドキュメントではインストールされません。重要：hf コマンドは、非推奨となった huggingface-cli コマンドに置き換わるものです。

hf --help を使って、利用可能な機能を確認してください。認証コマンドはすべて hf auth の下に移動しました。例：hf auth whoami。

huggingface_hub v1.21.0 で生成されています。対応している場合は hf skills preview を使って更新内容を確認してください。インストール済みのスキルやローカルの編集内容を自動的に強制上書きしないでください。

操作上の境界

この生成されたコマンド一覧は特定の上流バージョンを示すものであり、インストール済みの環境を示すものではありません。使用前に hf version と各コマンドのヘルプを確認してください。ユーザーが承認した名前空間とリビジョンを使用し、削除や同期の計画を事前確認して、復元可能なバックアップを保持してください。アップロードによって機密データが公開される可能性があるため、先にファイル一覧とプライバシー設定を確認してください。ジョブ、エンドポイント、ストレージには費用が発生する可能性があり、スケジュール済みジョブは繰り返し実行されます。承認済みの予算、実行時間、シャットダウン計画を設定してください。ダウンロードしたカード、データセット、拡張機能は信頼できないデータやコードとして扱い、リビジョンを固定してください。キャプチャされるログやチャットで hf auth token を実行しないでください。代わりに whoami を使用してください。環境ログとジョブログでは機密情報をマスキングし、権限を限定したトークンを使用してください。

コマンド

• hf cp SRC — ローカルパス、リポジトリ、バケット間でファイルをコピーします。[--format [auto|human|agent|json|quiet]]
• hf download REPO_ID — Hub からファイルをダウンロードします。[--type [model|dataset|space] --revision TEXT --include TEXT --exclude TEXT --cache-dir TEXT --local-dir TEXT --force-download --dry-run --max-workers INTEGER --format [auto|human|agent|json|quiet]]
• hf env — 環境に関する情報を表示します。[--format [auto|human|agent|json|quiet]]
• hf sync — ローカルディレクトリとバケット間でファイルを同期します。[--delete --ignore-times --ignore-sizes --plan TEXT --apply TEXT --dry-run --include TEXT --exclude TEXT --filter-from TEXT --existing --ignore-existing --verbose --format [auto|human|agent|json|quiet]]
• hf update — hf CLI を最新バージョンに更新します。[--format [auto|human|agent|json|quiet]]
• hf upload REPO_ID — ファイルまたはフォルダーを Hub にアップロードします。単一コミットでのアップロードに推奨されます。[--type [model|dataset|space] --revision TEXT --private --include TEXT --exclude TEXT --delete TEXT --commit-message TEXT --commit-description TEXT --create-pr --every FLOAT --format [auto|human|agent|json|quiet]]
• hf upload-large-folder REPO_ID LOCAL_PATH — 大きなフォルダーを Hub にアップロードします。再開可能なアップロードに推奨されます。[--type [model|dataset|space] --revision TEXT --private --include TEXT --exclude TEXT --num-workers INTEGER --no-report --no-bars --format [auto|human|agent|json|quiet]]
• hf version — hf のバージョン情報を表示します。[--format [auto|human|agent|json|quiet]]

hf auth — 認証を管理します（ログイン、ログアウトなど）。

• hf auth list — 保存されているすべてのアクセストークンを一覧表示します。[--format [auto|human|agent|json|quiet]]
• hf auth login — ブラウザー、または huggingface.co/settings/tokens のトークンを使ってログインします。[--add-to-git-credential --force --format [auto|human|agent|json|quiet]]
• hf auth logout — 指定したトークンからログアウトします。[--token-name TEXT --format [auto|human|agent|json|quiet]]
• hf auth switch — アクセストークンを切り替えます。[--token-name TEXT --add-to-git-credential --format [auto|human|agent|json|quiet]]
• hf auth token — 現在のアクセストークンを標準出力に表示します。[--format [auto|human|agent|json|quiet]]
• hf auth whoami — ログイン中の huggingface.co アカウントを確認します。[--format [auto|human|agent|json|quiet]]

hf buckets — バケットを操作するコマンドです。

• hf buckets cp SRC — ローカルパス、リポジトリ、バケット間でファイルをコピーします。[--format [auto|human|agent|json|quiet]]
• hf buckets create BUCKET_ID — 新しいバケットを作成します。[--private --region [us|eu] --exist-ok --format [auto|human|agent|json|quiet]]
• hf buckets delete BUCKET_ID — バケットを削除します。[--yes --missing-ok --format [auto|human|agent|json|quiet]]
• hf buckets info BUCKET_ID — バケットの情報を取得します。[--format [auto|human|agent|json|quiet]]
• hf buckets list — バケットまたはバケット内のファイルを一覧表示します。[--human-readable --tree --recursive --search TEXT --format [auto|human|agent|json|quiet]]
• hf buckets move FROM_ID TO_ID — バケットを新しい名前または名前空間に移動（名前を変更）します。[--format [auto|human|agent|json|quiet]]
• hf buckets remove ARGUMENT — バケットからファイルを削除します。[--recursive --yes --dry-run --include TEXT --exclude TEXT --format [auto|human|agent|json|quiet]]
• hf buckets sync — ローカルディレクトリとバケット間でファイルを同期します。[--delete --ignore-times --ignore-sizes --plan TEXT --apply TEXT --dry-run --include TEXT --exclude TEXT --filter-from TEXT --existing --ignore-existing --verbose --format [auto|human|agent|json|quiet]]

hf cache — ローカルキャッシュディレクトリを管理します。

• hf cache list — キャッシュされたリポジトリまたはリビジョンを一覧表示します。[--cache-dir TEXT --revisions --filter TEXT --sort [accessed|accessed:asc|accessed:desc|modified|modified:asc|modified:desc|name|name:asc|name:desc|size|size:asc|size:desc] --limit INTEGER --format [auto|human|agent|json|quiet]]
• hf cache prune — キャッシュから切り離されたリビジョンを削除します。[--cache-dir TEXT --yes --dry-run --format [auto|human|agent|json|quiet]]
• hf cache rm TARGETS — キャッシュされたリポジトリまたはリビジョンを削除します。[--cache-dir TEXT --yes --dry-run --format [auto|human|agent|json|quiet]]
• hf cache verify REPO_ID — キャッシュまたはローカルディレクトリにある単一のリポジトリリビジョンのチェックサムを検証します。[--type [model|dataset|space] --revision TEXT --cache-dir TEXT --local-dir TEXT --fail-on-missing-files --fail-on-extra-files --format [auto|human|agent|json|quiet]]

hf collections — Hub 上のコレクションを操作します。

• hf collections add-item COLLECTION_SLUG ITEM_ID ITEM_TYPE — コレクションにアイテムを追加します。[--note TEXT --exists-ok --format [auto|human|agent|json|quiet]]
• hf collections create TITLE — Hub に新しいコレクションを作成します。[--namespace TEXT --description TEXT --private --exists-ok --format [auto|human|agent|json|quiet]]
• hf collections delete COLLECTION_SLUG — Hub からコレクションを削除します。[--missing-ok --format [auto|human|agent|json|quiet]]
• hf collections delete-item COLLECTION_SLUG ITEM_OBJECT_ID — コレクションからアイテムを削除します。[--missing-ok --format [auto|human|agent|json|quiet]]
• hf collections info COLLECTION_SLUG — Hub 上のコレクション情報を取得します。[--format [auto|human|agent|json|quiet]]
• hf collections list — Hub 上のコレクションを一覧表示します。[--owner TEXT --item TEXT --sort [lastModified|trending|upvotes] --limit INTEGER --format [auto|human|agent|json|quiet]]
• hf collections update COLLECTION_SLUG — Hub 上のコレクションのメタデータを更新します。[--title TEXT --description TEXT --position INTEGER --private --theme TEXT --format [auto|human|agent|json|quiet]]
• hf collections update-item COLLECTION_SLUG ITEM_OBJECT_ID — コレクション内のアイテムを更新します。[--note TEXT --position INTEGER --format [auto|human|agent|json|quiet]]

hf datasets — Hub 上のデータセットを操作します。

• hf datasets card DATASET_ID — Hub 上のデータセットのデータセットカード（README）を取得します。[--metadata --text --format [auto|human|agent|json|quiet]]
• hf datasets info DATASET_ID — Hub 上のデータセット情報を取得します。[--revision TEXT --expand TEXT --format [auto|human|agent|json|quiet]]
• hf datasets leaderboard DATASET_ID — データセットのリーダーボードからモデルのスコアを一覧表示します。このコマンドを使うと、タスクに最適なモデルを見つけたり、ベンチマークスコアでモデルを比較したりできます。利用可能なリーダーボードを一覧表示するには、hf datasets ls --filter benchmark:official を使用します。[--limit INTEGER --format [auto|human|agent|json|quiet]]
• hf datasets list — Hub 上のデータセット、またはデータセットリポジトリ内のファイルを一覧表示します。[--search TEXT --author TEXT --filter TEXT --sort [created_at|downloads|last_modified|likes|trending_score] --limit INTEGER --expand TEXT --human-readable --tree --recursive --revision TEXT --format [auto|human|agent|json|quiet]]
• hf datasets parquet DATASET_ID — データセットで利用可能な Parquet ファイルの URL を一覧表示します。[--subset TEXT --split TEXT --format [auto|human|agent|json|quiet]]
• hf datasets sql SQL — データセットの Parquet URL に対して DuckDB で生の SQL クエリを実行します。[--format [auto|human|agent|json|quiet]]

hf discussions — Hub 上のディスカッションとプルリクエストを管理します。

• hf discussions close REPO_ID NUM — ディスカッションまたはプルリクエストをクローズします。[--comment TEXT --yes --type [model|dataset|space] --format [auto|human|agent|json|quiet]]
• hf discussions comment REPO_ID NUM — ディスカッションまたはプルリクエストにコメントします。[--body TEXT --body-file PATH --type [model|dataset|space] --format [auto|human|agent|json|quiet]]
• hf discussions create REPO_ID --title TEXT — リポジトリに新しいディスカッションまたはプルリクエストを作成します。[--body TEXT --body-file PATH --pull-request --type [model|dataset|space] --format [auto|human|agent|json|quiet]]
• hf discussions diff REPO_ID NUM — プルリクエストの差分を表示します。[--type [model|dataset|space] --format [auto|human|agent|json|quiet]]
• hf discussions info REPO_ID NUM — ディスカッションまたはプルリクエストの情報を取得します。[--type [model|dataset|space] --format [auto|human|agent|json|quiet]]
• hf discussions list REPO_ID — リポジトリ上のディスカッションとプルリクエストを一覧表示します。[--status [open|closed|merged|draft|all] --kind [all|discussion|pull_request] --author TEXT --limit INTEGER --type [model|dataset|space] --format [auto|human|agent|json|quiet]]
• hf discussions merge REPO_ID NUM — プルリクエストをマージします。[--comment TEXT --yes --type [model|dataset|space] --format [auto|human|agent|json|quiet]]
• hf discussions rename REPO_ID NUM NEW_TITLE — ディスカッションまたはプルリクエストの名前を変更します。[--type [model|dataset|space] --format [auto|human|agent|json|quiet]]
• hf discussions reopen REPO_ID NUM — クローズ済みのディスカッションまたはプルリクエストを再オープンします。[--comment TEXT --yes --type [model|dataset|space] --format [auto|human|agent|json|quiet]]

hf endpoints — Hugging Face Inference Endpoints を管理します。

• hf endpoints catalog deploy --repo TEXT — Model Catalog から Inference Endpoint をデプロイします。[--name TEXT --accelerator TEXT --namespace TEXT --format [auto|human|agent|json|quiet]]
• hf endpoints catalog list — 利用可能な Catalog モデルを一覧表示します。[--format [auto|human|agent|json|quiet]]
• hf endpoints delete NAME — Inference Endpoint を完全に削除します。[--namespace TEXT --yes --format [auto|human|agent|json|quiet]]
• hf endpoints deploy NAME --repo TEXT --framework TEXT --accelerator TEXT --instance-size TEXT --instance-type TEXT --region TEXT --vendor TEXT — Hub リポジトリから Inference Endpoint をデプロイします。[--namespace TEXT --task TEXT --min-replica INTEGER --max-replica INTEGER --scale-to-zero-timeout INTEGER --scaling-metric [pendingRequests|hardwareUsage] --scaling-threshold FLOAT --revision TEXT --custom-image TEXT --health-route TEXT --port INTEGER --container-command TEXT --container-args TEXT --env TEXT --env-file TEXT --secrets TEXT --secrets-file TEXT --type [public|protected|authenticated|private] --format [auto|human|agent|json|quiet]]
• hf endpoints describe NAME — 既存のエンドポイントの情報を取得します。[--namespace TEXT --format [auto|human|agent|json|quiet]]
• hf endpoints list — 指定したネームスペースのすべての Inference Endpoints を一覧表示します。[--namespace TEXT --format [auto|human|agent|json|quiet]]
• hf endpoints pause NAME — Inference Endpoint を一時停止します。[--namespace TEXT --format [auto|human|agent|json|quiet]]
• hf endpoints resume NAME — Inference Endpoint を再開します。[--namespace TEXT --fail-if-already-running --format [auto|human|agent|json|quiet]]
• hf endpoints scale-to-zero NAME — Inference Endpoint をゼロにスケールします。[--namespace TEXT --format [auto|human|agent|json|quiet]]
• hf endpoints update NAME — 既存のエンドポイントを更新します。[--namespace TEXT --repo TEXT --accelerator TEXT --instance-size TEXT --instance-type TEXT --framework TEXT --revision TEXT --task TEXT --min-replica INTEGER --max-replica INTEGER --scale-to-zero-timeout INTEGER --scaling-metric [pendingRequests|hardwareUsage] --scaling-threshold FLOAT --format [auto|human|agent|json|quiet]]

hf extensions — hf CLI 拡張機能を管理します。

• hf extensions exec NAME — インストール済みの拡張機能を実行します。
• hf extensions install REPO_ID — 公開されている GitHub リポジトリから拡張機能をインストールします。[--force --format [auto|human|agent|json|quiet]]
• hf extensions list — インストール済みの拡張機能コマンドを一覧表示します。[--format [auto|human|agent|json|quiet]]
• hf extensions remove NAME — インストール済みの拡張機能を削除します。[--format [auto|human|agent|json|quiet]]
• hf extensions search — GitHub で利用できる拡張機能（hf-extension トピックが付いたもの）を検索します。[--format [auto|human|agent|json|quiet]]

hf jobs — Hub 上で Jobs を実行、管理します。

• hf jobs cancel JOB_ID — ジョブをキャンセルします [--namespace TEXT --format [auto|human|agent|json|quiet]]
• hf jobs hardware — ジョブで利用可能なハードウェアオプションを一覧表示します [--format [auto|human|agent|json|quiet]]
• hf jobs inspect JOB_IDS — 1 つ以上のジョブに関する詳細情報を表示します [--namespace TEXT --format [auto|human|agent|json|quiet]]
• hf jobs labels JOB_ID — ジョブのラベルを更新します。既存のラベルはすべて置き換えられます。 [--label TEXT --clear --namespace TEXT --format [auto|human|agent|json|quiet]]
• hf jobs list — ジョブを一覧表示します。 [--all --status [COMPLETED|CANCELED|ERROR|DELETED|SCHEDULING|RUNNING] --label TEXT --limit INTEGER --namespace TEXT --filter TEXT --format [auto|human|agent|json|quiet]]
• hf jobs logs JOB_ID — ジョブのログを取得します。 [--follow --tail INTEGER --namespace TEXT --format [auto|human|agent|json|quiet]]
• hf jobs run IMAGE COMMAND — ジョブを実行します。 [--env TEXT --secrets TEXT --label TEXT --volume TEXT --env-file TEXT --secrets-file TEXT --flavor [cpu-basic|cpu-upgrade|cpu-performance|cpu-xl|t4-small|t4-medium|l4x1|l4x4|l40sx1|l40sx4|l40sx8|a10g-small|a10g-large|a10g-largex2|a10g-largex4|a100-large|a100x4|a100x8|h200|h200x2|h200x4|h200x8|rtx-pro-6000|rtx-pro-6000x2|rtx-pro-6000x4|rtx-pro-6000x8] --timeout TEXT --detach --expose INTEGER --ssh --namespace TEXT]
• hf jobs scheduled delete SCHEDULED_JOB_ID — スケジュールされたジョブを削除します。 [--namespace TEXT --format [auto|human|agent|json|quiet]]
• hf jobs scheduled inspect SCHEDULED_JOB_IDS — 1 つ以上のスケジュールされたジョブに関する詳細情報を表示します [--namespace TEXT --format [auto|human|agent|json|quiet]]
• hf jobs scheduled labels SCHEDULED_JOB_ID — スケジュールされたジョブのラベルを更新します。既存のラベルはすべて置き換えられます。 [--label TEXT --clear --namespace TEXT --format [auto|human|agent|json|quiet]]
• hf jobs scheduled list — スケジュールされたジョブを一覧表示します [--all --namespace TEXT --filter TEXT --format [auto|human|agent|json|quiet]]
• hf jobs scheduled resume SCHEDULED_JOB_ID — スケジュールされたジョブを再開（一時停止の解除）します。 [--namespace TEXT --format [auto|human|agent|json|quiet]]
• hf jobs scheduled run SCHEDULE IMAGE COMMAND — ジョブをスケジュールします。 [--suspend --concurrency --env TEXT --secrets TEXT --label TEXT --volume TEXT --env-file TEXT --secrets-file TEXT --flavor [cpu-basic|cpu-upgrade|cpu-performance|cpu-xl|t4-small|t4-medium|l4x1|l4x4|l40sx1|l40sx4|l40sx8|a10g-small|a10g-large|a10g-largex2|a10g-largex4|a100-large|a100x4|a100x8|h200|h200x2|h200x4|h200x8|rtx-pro-6000|rtx-pro-6000x2|rtx-pro-6000x4|rtx-pro-6000x8] --timeout TEXT --expose INTEGER --namespace TEXT]
• hf jobs scheduled suspend SCHEDULED_JOB_ID — スケジュールされたジョブを中断（一時停止）します。 [--namespace TEXT --format [auto|human|agent|json|quiet]]
• hf jobs scheduled uv run SCHEDULE SCRIPT — HF インフラストラクチャ上で UV スクリプト（ローカルファイルまたは URL）を実行します [--suspend --concurrency --image TEXT --flavor [cpu-basic|cpu-upgrade|cpu-performance|cpu-xl|t4-small|t4-medium|l4x1|l4x4|l40sx1|l40sx4|l40sx8|a10g-small|a10g-large|a10g-largex2|a10g-largex4|a100-large|a100x4|a100x8|h200|h200x2|h200x4|h200x8|rtx-pro-6000|rtx-pro-6000x2|rtx-pro-6000x4|rtx-pro-6000x8] --env TEXT --secrets TEXT --label TEXT --volume TEXT --env-file TEXT --secrets-file TEXT --timeout TEXT --expose INTEGER --namespace TEXT --with TEXT --python TEXT]
• hf jobs ssh JOB_ID — 実行中のジョブに SSH 接続します。 [--identity-file PATH --dry-run --namespace TEXT --format [auto|human|agent|json|quiet]]
• hf jobs stats — ジョブのリソース使用統計とメトリクスを取得します [--namespace TEXT --format [auto|human|agent|json|quiet]]
• hf jobs uv run SCRIPT — HF インフラストラクチャ上で UV スクリプト（ローカルファイルまたは URL）を実行します [--image TEXT --flavor [cpu-basic|cpu-upgrade|cpu-performance|cpu-xl|t4-small|t4-medium|l4x1|l4x4|l40sx1|l40sx4|l40sx8|a10g-small|a10g-large|a10g-largex2|a10g-largex4|a100-large|a100x4|a100x8|h200|h200x2|h200x4|h200x8|rtx-pro-6000|rtx-pro-6000x2|rtx-pro-6000x4|rtx-pro-6000x8] --env TEXT --secrets TEXT --label TEXT --volume TEXT --env-file TEXT --secrets-file TEXT --timeout TEXT --detach --expose INTEGER --ssh --namespace TEXT --with TEXT --python TEXT]
• hf jobs wait JOB_IDS — 1 つ以上のジョブが終了状態に達するまで待機します。 [--timeout TEXT --namespace TEXT --format [auto|human|agent|json|quiet]]

hf models — Hub 上のモデルを操作します。

• hf models card MODEL_ID — Hub 上のモデルのモデルカード（README）を取得します。[--metadata --text --format [auto|human|agent|json|quiet]]
• hf models info MODEL_ID — Hub 上のモデルに関する情報を取得します。[--revision TEXT --expand TEXT --format [auto|human|agent|json|quiet]]
• hf models list — Hub 上のモデル、またはモデルリポジトリ内のファイルを一覧表示します。[--search TEXT --author TEXT --filter TEXT --num-parameters TEXT --sort [created_at|downloads|last_modified|likes|trending_score] --limit INTEGER --expand TEXT --human-readable --tree --recursive --revision TEXT --format [auto|human|agent|json|quiet]]

hf papers — Hub 上の論文を操作します。

• hf papers info PAPER_ID — Hub 上の論文に関する情報を取得します。[--format [auto|human|agent|json|quiet]]
• hf papers list — Hub 上のデイリーペーパーを一覧表示します。[--date TEXT --week TEXT --month TEXT --submitter TEXT --sort [publishedAt|trending] --limit INTEGER --format [auto|human|agent|json|quiet]]
• hf papers read PAPER_ID — 論文を markdown として読み取ります。[--format [auto|human|agent|json|quiet]]
• hf papers search QUERY — Hub 上の論文を検索します。[--limit INTEGER --format [auto|human|agent|json|quiet]]

hf repos — Hub 上のリポジトリを管理します。

• hf repos branch create REPO_ID BRANCH — Hub 上のリポジトリに新しいブランチを作成します。[--revision TEXT --type [model|dataset|space] --exist-ok --format [auto|human|agent|json|quiet]]
• hf repos branch delete REPO_ID BRANCH — Hub 上のリポジトリからブランチを削除します。[--type [model|dataset|space] --format [auto|human|agent|json|quiet]]
• hf repos cp SRC — ローカルパス、リポジトリ、バケット間でファイルをコピーします。[--format [auto|human|agent|json|quiet]]
• hf repos create REPO_ID — Hub 上に新しいリポジトリを作成します。[--type [model|dataset|space] --space-sdk TEXT --private --public --protected --exist-ok --resource-group-id TEXT --region [us|eu] --flavor [cpu-basic|cpu-upgrade|zero-a10g|t4-small|t4-medium|l4x1|l4x4|l40sx1|l40sx4|l40sx8|a10g-small|a10g-large|a10g-largex2|a10g-largex4|a100-large|a100x4|a100x8] --storage [small|medium|large] --sleep-time INTEGER --secrets TEXT --secrets-file TEXT --env TEXT --env-file TEXT --volume TEXT --format [auto|human|agent|json|quiet]]
• hf repos delete REPO_ID — Hub 上のリポジトリを削除します。これは取り消しできない操作です。[--type [model|dataset|space] --missing-ok --yes --format [auto|human|agent|json|quiet]]
• hf repos delete-files REPO_ID PATTERNS — Hub 上のリポジトリからファイルを削除します。[--type [model|dataset|space] --revision TEXT --commit-message TEXT --commit-description TEXT --create-pr --format [auto|human|agent|json|quiet]]
• hf repos duplicate FROM_ID — Hub 上のリポジトリ（モデル、データセット、Space）を複製します。[--type [model|dataset|space] --private --public --protected --exist-ok --flavor [cpu-basic|cpu-upgrade|zero-a10g|t4-small|t4-medium|l4x1|l4x4|l40sx1|l40sx4|l40sx8|a10g-small|a10g-large|a10g-largex2|a10g-largex4|a100-large|a100x4|a100x8] --storage [small|medium|large] --sleep-time INTEGER --secrets TEXT --secrets-file TEXT --env TEXT --env-file TEXT --volume TEXT --format [auto|human|agent|json|quiet]]
• hf repos list — すべてのリポジトリ（モデル、データセット、Space、バケット）をストレージ情報とともに一覧表示します。[--namespace TEXT --type [model|dataset|space|bucket] --search TEXT --limit INTEGER --explore --format [auto|human|agent|json|quiet]]
• hf repos move FROM_ID TO_ID — リポジトリをある名前空間から別の名前空間へ移動します。[--type [model|dataset|space] --format [auto|human|agent|json|quiet]]
• hf repos settings REPO_ID — リポジトリの設定を更新します。[--gated [auto|manual|false] --private --public --protected --type [model|dataset|space] --format [auto|human|agent|json|quiet]]
• hf repos tag create REPO_ID TAG — リポジトリのタグを作成します。[--message TEXT --revision TEXT --type [model|dataset|space] --format [auto|human|agent|json|quiet]]
• hf repos tag delete REPO_ID TAG — リポジトリのタグを削除します。[--yes --type [model|dataset|space] --format [auto|human|agent|json|quiet]]
• hf repos tag list REPO_ID — リポジトリのタグを一覧表示します。[--type [model|dataset|space] --format [auto|human|agent|json|quiet]]

hf skills — AI アシスタント向けのスキルを管理します。

• hf skills add — Hugging Face のスキルをダウンロードし、AI アシスタントにインストールします。[--claude --global --dest PATH --force --format [auto|human|agent|json|quiet]]
• hf skills list — Hugging Face マーケットプレイスで利用可能なスキルを一覧表示します。[--format [auto|human|agent|json|quiet]]
• hf skills preview — 生成された hf-cli SKILL.md を標準出力に出力します。[--format [auto|human|agent|json|quiet]]
• hf skills update — インストール済みの Hugging Face マーケットプレイスのスキルを更新します。[--claude --global --dest PATH --format [auto|human|agent|json|quiet]]

hf spaces — Hub 上の Spaces を操作します。

• hf spaces card SPACE_ID — Hub 上の Space の Space カード (README) を取得します。[--metadata --text --format [auto|human|agent|json|quiet]]
• hf spaces dev-mode SPACE_ID — Space の開発モードを有効または無効にします。[--stop --format [auto|human|agent|json|quiet]]
• hf spaces hardware — Spaces で利用可能なハードウェアオプションを一覧表示します。[--format [auto|human|agent|json|quiet]]
• hf spaces hot-reload SPACE_ID — 完全な再ビルドと再起動を行わずに、Space の任意の Python ファイルをホットリロードします。[--local-file PATH --skip-checks --skip-summary --format [auto|human|agent|json|quiet]]
• hf spaces info SPACE_ID — Hub 上の Space に関する情報を取得します。[--revision TEXT --expand TEXT --format [auto|human|agent|json|quiet]]
• hf spaces list — Hub 上の Spaces、または Space リポジトリ内のファイルを一覧表示します。[--search TEXT --author TEXT --filter TEXT --sort [created_at|last_modified|likes|trending_score] --limit INTEGER --expand TEXT --human-readable --tree --recursive --revision TEXT --format [auto|human|agent|json|quiet]]
• hf spaces logs SPACE_ID — Space の実行ログまたはビルドログを取得します。[--build --follow --tail INTEGER --format [auto|human|agent|json|quiet]]
• hf spaces pause SPACE_ID — Space を一時停止します。[--format [auto|human|agent|json|quiet]]
• hf spaces restart SPACE_ID — Space を再起動します。[--factory-reboot --format [auto|human|agent|json|quiet]]
• hf spaces search QUERY — セマンティック検索を使用して Hub 上の Spaces を検索します。[--filter TEXT --sdk TEXT --include-non-running --description --limit INTEGER --format [auto|human|agent|json|quiet]]
• hf spaces secrets add SPACE_ID — Space のシークレットを追加または更新します。[--secrets TEXT --secrets-file TEXT --format [auto|human|agent|json|quiet]]
• hf spaces secrets delete SPACE_ID KEY — Space からシークレットを削除します。[--yes --format [auto|human|agent|json|quiet]]
• hf spaces secrets list SPACE_ID — Space のシークレットを一覧表示します。シークレットの値は書き込み専用であり、返されません。[--format [auto|human|agent|json|quiet]]
• hf spaces settings SPACE_ID — Space の設定を更新します。[--sleep-time INTEGER --hardware [cpu-basic|cpu-upgrade|zero-a10g|t4-small|t4-medium|l4x1|l4x4|l40sx1|l40sx4|l40sx8|a10g-small|a10g-large|a10g-largex2|a10g-largex4|a100-large|a100x4|a100x8] --format [auto|human|agent|json|quiet]]
• hf spaces ssh SPACE_ID — Space の開発モードコンテナに SSH 接続します。[--identity-file PATH --dry-run --auto --format [auto|human|agent|json|quiet]]
• hf spaces variables add SPACE_ID — Space の環境変数を追加または更新します。[--env TEXT --env-file TEXT --format [auto|human|agent|json|quiet]]
• hf spaces variables delete SPACE_ID KEY — Space から環境変数を削除します。[--yes --format [auto|human|agent|json|quiet]]
• hf spaces variables list SPACE_ID — Space の環境変数を一覧表示します。[--format [auto|human|agent|json|quiet]]
• hf spaces volumes delete SPACE_ID — Space からすべてのボリュームを削除します。[--yes --format [auto|human|agent|json|quiet]]
• hf spaces volumes list SPACE_ID — Space にマウントされているボリュームを一覧表示します。[--format [auto|human|agent|json|quiet]]
• hf spaces volumes set SPACE_ID — Space のボリュームを設定 (置換) します。[--volume TEXT --format [auto|human|agent|json|quiet]]
• hf spaces wait SPACE_ID — Space のビルドまたは起動が完了するまで待機します。[--timeout TEXT --format [auto|human|agent|json|quiet]]

hf webhooks — Hub 上の Webhook を管理します。

• hf webhooks create --watch TEXT — 新しい Webhook を作成します。[--url TEXT --job-id TEXT --domain [repo|discussions] --secret TEXT --format [auto|human|agent|json|quiet]]
• hf webhooks delete WEBHOOK_ID — Webhook を完全に削除します。[--yes --format [auto|human|agent|json|quiet]]
• hf webhooks disable WEBHOOK_ID — 有効な Webhook を無効にします。[--format [auto|human|agent|json|quiet]]
• hf webhooks enable WEBHOOK_ID — 無効な Webhook を有効にします。[--format [auto|human|agent|json|quiet]]
• hf webhooks info WEBHOOK_ID — 単一の Webhook の詳細をすべて表示します。[--format [auto|human|agent|json|quiet]]
• hf webhooks list — 現在のユーザーのすべての Webhook を一覧表示します。[--format [auto|human|agent|json|quiet]]
• hf webhooks update WEBHOOK_ID — 既存の Webhook を更新します。指定したオプションのみが変更されます。[--url TEXT --watch TEXT --domain [repo|discussions] --secret TEXT --format [auto|human|agent|json|quiet]]

共通オプション

• --format — 出力形式：--format json（または --json）、または --format table（デフォルト）。
• -q / --quiet — 出力を抑制します（1 行につき ID を 1 つ表示）。
• --revision — ブランチ名、タグ、またはコミットハッシュを指定できる Git リビジョン ID です。
• --token — ユーザーアクセストークンを使用します。--token を渡す代わりに、HF_TOKEN 環境変数を設定することを推奨します。
• --type — リポジトリの種類（model、dataset、space）。

リポジトリをローカルファイルシステムとしてマウントする

Hub リポジトリやバケットを、ダウンロード、コピー、待ち時間なしでローカルファイルシステムとしてマウントするには、hf-mount を使用します。ファイルは必要に応じて取得されます。GitHub：https://github.com/huggingface/hf-mount

まずインストーラースクリプトをダウンロードして内容を確認し、その後ローカルで実行してインストールします： tmpdir="$(mktemp -d)" && curl -fsSL https://raw.githubusercontent.com/huggingface/hf-mount/main/install.sh -o "$tmpdir/hf-mount-install.sh" && less "$tmpdir/hf-mount-install.sh"

ダウンロードしたスクリプトを確認して承認してから、別途実行してください： sh "$tmpdir/hf-mount-install.sh"

コマンドの例：

• hf-mount start repo openai-community/gpt2 /path/to/approved-empty-mountpoint — リポジトリをマウントします（読み取り専用）
• hf-mount start bucket myuser/my-bucket /path/to/approved-empty-mountpoint — バケットをマウントします（読み書き可能）
• hf-mount status / hf-mount stop /tmp/data — 一覧表示またはマウント解除

ヒント

• 使用可能なオプション、説明、使用方法、実際の例については、hf <command> --help を使用してください
• HF_TOKEN 環境変数（推奨）または --token で認証します
• hf update で CLI を更新します（検出されたインストール方法に適したコマンドを使用します）

例

ユーザーのリクエスト：

このタスクでは @hugging-face-cli を使用してください：Hugging Face Hub CLI（hf）を使って、Hugging Face Hub 上のモデル、データセット、スペース、バケット、リポジトリ、論文、ジョブなどをダウンロード、アップロード、管理します。

制限事項

• タスクが上流の製品または API の対象範囲に明確に合致する場合にのみ、このスキルを使用してください。
• 変更を加える前に、コマンド、API の動作、料金、クォータ、認証情報、デプロイへの影響を、最新の公式ドキュメントで確認してください。
• 生成された例を、環境固有のテスト、セキュリティレビュー、または破壊的な操作や費用のかかる操作に対するユーザーの承認の代わりとして扱わないでください。