hf-cli

インストール: curl -LsSf https://hf.co/cli/install.sh | bash -s

Hugging Face Hub CLI ツール hf が利用可能です。重要: hf コマンドは非推奨の huggingface-cli コマンドに代わります。

hf --help を使用して利用可能な機能を表示してください。認証コマンドはすべて hf auth 配下にあることに注意してください（例: hf auth whoami）。

huggingface_hub v1.15.0 で生成されました。再生成するには hf skills add --force を実行してください。

コマンド

• hf download REPO_ID — Hub からファイルをダウンロードします。[--type CHOICE --revision TEXT --include TEXT --exclude TEXT --cache-dir TEXT --local-dir TEXT --force-download --dry-run --max-workers INTEGER --format CHOICE]
• hf env — 環境に関する情報を出力します。[--format CHOICE]
• 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 CHOICE]
• hf update — hf CLI を最新バージョンに更新します。[--format CHOICE]
• hf upload REPO_ID — ファイルまたはフォルダを Hub にアップロードします。シングルコミットアップロードに推奨されます。[--type CHOICE --revision TEXT --private --include TEXT --exclude TEXT --delete TEXT --commit-message TEXT --commit-description TEXT --create-pr --every FLOAT --format CHOICE]
• hf upload-large-folder REPO_ID LOCAL_PATH — 大きなフォルダを Hub にアップロードします。再開可能なアップロードに推奨されます。[--type CHOICE --revision TEXT --private --include TEXT --exclude TEXT --num-workers INTEGER --no-report --no-bars --format CHOICE]
• hf version — hf バージョンに関する情報を出力します。[--format CHOICE]

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

• hf auth list — 保存されているすべてのアクセストークンをリスト表示します。[--format CHOICE]
• hf auth login — huggingface.co/settings/tokens からのトークンでログインします。[--add-to-git-credential --force --format CHOICE]
• hf auth logout — 特定のトークンからログアウトします。[--token-name TEXT --format CHOICE]
• hf auth switch — アクセストークン間で切り替えます。[--token-name TEXT --add-to-git-credential --format CHOICE]
• hf auth token — 現在のアクセストークンを標準出力に出力します。[--format CHOICE]
• hf auth whoami — ログインしている huggingface.co アカウントを確認します。[--format CHOICE]

hf buckets — バケットと対話するコマンド。

• hf buckets cp SRC — ファイルをバケットへ、またはバケットから、コピーします。[--format CHOICE]
• hf buckets create BUCKET_ID — 新しいバケットを作成します。[--private --region CHOICE --exist-ok --format CHOICE]
• hf buckets delete BUCKET_ID — バケットを削除します。[--yes --missing-ok --format CHOICE]
• hf buckets info BUCKET_ID — バケットに関する情報を取得します。[--format CHOICE]
• hf buckets list — バケット、またはバケット内のファイルをリスト表示します。[--human-readable --tree --recursive --search TEXT --format CHOICE]
• hf buckets move FROM_ID TO_ID — バケットを新しい名前または名前空間に移動（名前変更）します。[--format CHOICE]
• hf buckets remove ARGUMENT — バケットからファイルを削除します。[--recursive --yes --dry-run --include TEXT --exclude TEXT --format CHOICE]
• 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 CHOICE]

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

• hf cache list — キャッシュされたリポジトリまたはリビジョンをリスト表示します。[--cache-dir TEXT --revisions --filter TEXT --sort CHOICE --limit INTEGER --format CHOICE]
• hf cache prune — キャッシュから切り離されたリビジョンを削除します。[--cache-dir TEXT --yes --dry-run --format CHOICE]
• hf cache rm TARGETS — キャッシュされたリポジトリまたはリビジョンを削除します。[--cache-dir TEXT --yes --dry-run --format CHOICE]
• hf cache verify REPO_ID — キャッシュまたはローカルディレクトリから単一のリポジトリリビジョンのチェックサムを検証します。[--type CHOICE --revision TEXT --cache-dir TEXT --local-dir TEXT --fail-on-missing-files --fail-on-extra-files --format CHOICE]

hf collections — Hub 上のコレクションと対話します。

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

hf datasets — Hub 上のデータセットと対話します。

• hf datasets card DATASET_ID — Hub 上のデータセットのデータセットカード（README）を取得します。[--metadata --text --format CHOICE]
• hf datasets info DATASET_ID — Hub 上のデータセットに関する情報を取得します。[--revision TEXT --expand TEXT --format CHOICE]
• hf datasets leaderboard DATASET_ID — データセットリーダーボードからモデルスコアをリスト表示します。このコマンドはタスクに最適なモデルを見つけたり、ベンチマークスコアでモデルを比較したりするのに役立ちます。利用可能なリーダーボードのリストを表示するには「hf datasets ls --filter benchmark:official」を使用してください。[--limit INTEGER --format CHOICE]
• hf datasets list — Hub 上のデータセット、またはデータセットリポジトリ内のファイルをリスト表示します。[--search TEXT --author TEXT --filter TEXT --sort CHOICE --limit INTEGER --expand TEXT --human-readable --tree --recursive --revision TEXT --format CHOICE]
• hf datasets parquet DATASET_ID — データセットで利用可能な parquet ファイル URL をリスト表示します。[--subset TEXT --split TEXT --format CHOICE]
• hf datasets sql SQL — DuckDB を使用してデータセット parquet URL に対して raw SQL クエリを実行します。[--format CHOICE]

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

• hf discussions close REPO_ID NUM — ディスカッションまたはプルリクエストをクローズします。[--comment TEXT --yes --type CHOICE --format CHOICE]
• hf discussions comment REPO_ID NUM — ディスカッションまたはプルリクエストにコメントします。[--body TEXT --body-file PATH --type CHOICE --format CHOICE]
• hf discussions create REPO_ID --title TEXT — リポジトリ上に新しいディスカッションまたはプルリクエストを作成します。[--body TEXT --body-file PATH --pull-request --type CHOICE --format CHOICE]
• hf discussions diff REPO_ID NUM — プルリクエストの差分を表示します。[--type CHOICE --format CHOICE]
• hf discussions info REPO_ID NUM — ディスカッションまたはプルリクエストに関する情報を取得します。[--type CHOICE --format CHOICE]
• hf discussions list REPO_ID — リポジトリ上のディスカッションとプルリクエストをリスト表示します。[--status CHOICE --kind CHOICE --author TEXT --limit INTEGER --type CHOICE --format CHOICE]
• hf discussions merge REPO_ID NUM — プルリクエストをマージします。[--comment TEXT --yes --type CHOICE --format CHOICE]
• hf discussions rename REPO_ID NUM NEW_TITLE — ディスカッションまたはプルリクエストの名前を変更します。[--type CHOICE --format CHOICE]
• hf discussions reopen REPO_ID NUM — クローズされたディスカッションまたはプルリクエストを再度開きます。[--comment TEXT --yes --type CHOICE --format CHOICE]

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

• hf endpoints catalog deploy --repo TEXT — モデルカタログから Inference Endpoint をデプロイします。[--name TEXT --accelerator TEXT --namespace TEXT --format CHOICE]
• hf endpoints catalog list — 利用可能なカタログモデルをリスト表示します。[--format CHOICE]
• hf endpoints delete NAME — Inference Endpoint を完全に削除します。[--namespace TEXT --yes --format CHOICE]
• 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 CHOICE --scaling-threshold FLOAT --format CHOICE]
• hf endpoints describe NAME — 既存のエンドポイントに関する情報を取得します。[--namespace TEXT --format CHOICE]
• hf endpoints list — 指定された名前空間のすべての Inference Endpoints をリスト表示します。[--namespace TEXT --format CHOICE]
• hf endpoints pause NAME — Inference Endpoint を一時停止します。[--namespace TEXT --format CHOICE]
• hf endpoints resume NAME — Inference Endpoint を再開します。[--namespace TEXT --fail-if-already-running --format CHOICE]
• hf endpoints scale-to-zero NAME — Inference Endpoint をゼロにスケールします。[--namespace TEXT --format CHOICE]
• 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 CHOICE --scaling-threshold FLOAT --format CHOICE]

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

• hf extensions exec NAME — インストール済みの拡張機能を実行します。
• hf extensions install REPO_ID — パブリック GitHub リポジトリから拡張機能をインストールします。[--force --format CHOICE]
• hf extensions list — インストール済みの拡張機能コマンドをリスト表示します。[--format CHOICE]
• hf extensions remove NAME — インストール済みの拡張機能を削除します。[--format CHOICE]
• hf extensions search — GitHub で利用可能な拡張機能（「hf-extension」トピックでタグ付けされた）を検索します。[--format CHOICE]

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

• hf jobs cancel JOB_ID — ジョブをキャンセルします。[--namespace TEXT --format CHOICE]
• hf jobs hardware — ジョブで利用可能なハードウェアオプションをリスト表示します。[--format CHOICE]
• hf jobs inspect JOB_IDS — 1 つ以上のジョブの詳細情報を表示します。[--namespace TEXT --format CHOICE]
• hf jobs logs JOB_ID — ジョブのログを取得します。[--follow --tail INTEGER --namespace TEXT --format CHOICE]
• hf jobs ps — ジョブをリスト表示します。[--all --namespace TEXT --filter TEXT --format TEXT --quiet]
• hf jobs run IMAGE COMMAND — ジョブを実行します。[--env TEXT --secrets TEXT --label TEXT --volume TEXT --env-file TEXT --secrets-file TEXT --flavor CHOICE --timeout TEXT --detach --namespace TEXT]
• hf jobs scheduled delete SCHEDULED_JOB_ID — スケジュール済みジョブを削除します。[--namespace TEXT --format CHOICE]
• hf jobs scheduled inspect SCHEDULED_JOB_IDS — 1 つ以上のスケジュール済みジョブの詳細情報を表示します。[--namespace TEXT --format CHOICE]
• hf jobs scheduled ps — スケジュール済みジョブをリスト表示します。[--all --namespace TEXT --filter TEXT --format TEXT --quiet]
• hf jobs scheduled resume SCHEDULED_JOB_ID — スケジュール済みジョブを再開（一時停止解除）します。[--namespace TEXT --format CHOICE]
• hf jobs scheduled run SCHEDULE IMAGE COMMAND — ジョブをスケジュールします。[--suspend --concurrency --env TEXT --secrets TEXT --label TEXT --volume TEXT --env-file TEXT --secrets-file TEXT --flavor CHOICE --timeout TEXT --namespace TEXT]
• hf jobs scheduled suspend SCHEDULED_JOB_ID — スケジュール済みジョブを一時停止します。[--namespace TEXT --format CHOICE]
• hf jobs scheduled uv run SCHEDULE SCRIPT — HF インフラストラクチャで UV スクリプト（ローカルファイルまたは URL）を実行します。[--suspend --concurrency --image TEXT --flavor CHOICE --env TEXT --secrets TEXT --label TEXT --volume TEXT --env-file TEXT --secrets-file TEXT --timeout TEXT --namespace TEXT --with TEXT --python TEXT]
• hf jobs stats — ジョブのリソース使用統計とメトリックスを取得します。[--namespace TEXT --format CHOICE]
• hf jobs uv run SCRIPT — HF インフラストラクチャで UV スクリプト（ローカルファイルまたは URL）を実行します。[--image TEXT --flavor CHOICE --env TEXT --secrets TEXT --label TEXT --volume TEXT --env-file TEXT --secrets-file TEXT --timeout TEXT --detach --namespace TEXT --with TEXT --python TEXT]

hf models — Hub 上のモデルと対話します。

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

hf papers — Hub 上のペーパーと対話します。

• hf papers info PAPER_ID — Hub 上のペーパーに関する情報を取得します。[--format CHOICE]
• hf papers list — Hub 上の日次ペーパーをリスト表示します。[--date TEXT --week TEXT --month TEXT --submitter TEXT --sort CHOICE --limit INTEGER --format CHOICE]
• hf papers read PAPER_ID — ペーパーを markdown として読みます。[--format CHOICE]
• hf papers search QUERY — Hub 上のペーパーを検索します。[--limit INTEGER --format CHOICE]

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

• hf repos branch create REPO_ID BRANCH — Hub 上のリポジトリ用に新しいブランチを作成します。[--revision TEXT --type CHOICE --exist-ok --format CHOICE]
• hf repos branch delete REPO_ID BRANCH — Hub 上のリポジトリからブランチを削除します。[--type CHOICE --format CHOICE]
• hf repos create REPO_ID — Hub 上に新しいリポジトリを作成します。[--type CHOICE --space-sdk TEXT --private --public --protected --exist-ok --resource-group-id TEXT --region CHOICE --flavor CHOICE --storage CHOICE --sleep-time INTEGER --secrets TEXT --secrets-file TEXT --env TEXT --env-file TEXT --volume TEXT --format CHOICE]
• hf repos delete REPO_ID — Hub からリポジトリを削除します。これは取り消せない操作です。[--type CHOICE --missing-ok --yes --format CHOICE]
• hf repos delete-files REPO_ID PATTERNS — Hub 上のリポジトリからファイルを削除します。[--type CHOICE --revision TEXT --commit-message TEXT --commit-description TEXT --create-pr --format CHOICE]
• hf repos duplicate FROM_ID — Hub 上でリポジトリを複製します（モデル、データセット、または Space）。[--type CHOICE --private --public --protected --exist-ok --flavor CHOICE --storage CHOICE --sleep-time INTEGER --secrets TEXT --secrets-file TEXT --env TEXT --env-file TEXT --volume TEXT --format CHOICE]
• hf repos move FROM_ID TO_ID — リポジトリをある名前空間から別の名前空間に移動します。[--type CHOICE --format CHOICE]
• hf repos settings REPO_ID — リポジトリの設定を更新します。[--gated CHOICE --private --public --protected --type CHOICE --format CHOICE]
• hf repos tag create REPO_ID TAG — リポジトリ用のタグを作成します。[--message TEXT --revision TEXT --type CHOICE --format CHOICE]
• hf repos tag delete REPO_ID TAG — リポジトリ用のタグを削除します。[--yes --type CHOICE --format CHOICE]
• hf repos tag list REPO_ID — リポジトリ用のタグをリスト表示します。[--type CHOICE --format CHOICE]

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

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

hf spaces — Hub 上の Space と対話します。

• hf spaces card SPACE_ID — Hub 上の Space の Space カード（README）を取得します。[--metadata --text --format CHOICE]
• hf spaces dev-mode SPACE_ID — Space 上で開発モードを有効または無効にします。[--stop --format CHOICE]
• hf spaces hardware — Space で利用可能なハードウェアオプションをリスト表示します。[--format CHOICE]
• hf spaces hot-reload SPACE_ID — フルリビルド + 再起動なしで Space の Python ファイルをホットリロードします。[--local-file PATH --skip-checks --skip-summary --format CHOICE]
• hf spaces info SPACE_ID — Hub 上の Space に関する情報を取得します。[--revision TEXT --expand TEXT --format CHOICE]
• hf spaces list — Hub 上の Space、または Space リポジトリ内のファイルをリスト表示します。[--search TEXT --author TEXT --filter TEXT --sort CHOICE --limit INTEGER --expand TEXT --human-readable --tree --recursive --revision TEXT --format CHOICE]
• hf spaces logs SPACE_ID — Space の実行またはビルドログを取得します。[--build --follow --tail INTEGER --format CHOICE]
• hf spaces pause SPACE_ID — Space を一時停止します。[--format CHOICE]
• hf spaces restart SPACE_ID — Space を再起動します。[--factory-reboot --format CHOICE]
• hf spaces search QUERY — セマンティック検索を使用して Hub 上の Space を検索します。[--filter TEXT --sdk TEXT --include-non-running --description --limit INTEGER --format CHOICE]
• hf spaces secrets add SPACE_ID — Space 用のシークレットを追加または更新します。[--secrets TEXT --secrets-file TEXT --format CHOICE]
• hf spaces secrets delete SPACE_ID KEY — Space からシークレットを削除します。[--yes --format CHOICE]
• hf spaces secrets list SPACE_ID — Space 用のシークレットをリスト表示します。シークレット値は書き込み専用で返されません。[--format CHOICE]
• hf spaces settings SPACE_ID — Space の設定を更新します。[--sleep-time INTEGER --hardware CHOICE --format CHOICE]
• hf spaces variables add SPACE_ID — Space 用の環境変数を追加または更新します。[--env TEXT --env-file TEXT --format CHOICE]
• hf spaces variables delete SPACE_ID KEY — Space から環境変数を削除します。[--yes --format CHOICE]
• hf spaces variables list SPACE_ID — Space 用の環境変数をリスト表示します。[--format CHOICE]
• hf spaces volumes delete SPACE_ID — Space からすべてのボリュームを削除します。[--yes --format CHOICE]
• hf spaces volumes list SPACE_ID — Space にマウントされたボリュームをリスト表示します。[--format CHOICE]
• hf spaces volumes set SPACE_ID — Space 用のボリュームを設定（置換）します。[--volume TEXT --format CHOICE]

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

• hf webhooks create --watch TEXT — 新しい webhook を作成します。[--url TEXT --job-id TEXT --domain CHOICE --secret TEXT --format CHOICE]
• hf webhooks delete WEBHOOK_ID — webhook を完全に削除します。[--yes --format CHOICE]
• hf webhooks disable WEBHOOK_ID — アクティブな webhook を無効にします。[--format CHOICE]
• hf webhooks enable WEBHOOK_ID — 無効な webhook を有効にします。[--format CHOICE]
• hf webhooks info WEBHOOK_ID — 単一の webhook の完全な詳細を表示します。[--format CHOICE]
• hf webhooks list — 現在のユーザーのすべての webhook をリスト表示します。[--format CHOICE]
• hf webhooks update WEBHOOK_ID — 既存の webhook を更新します。提供されたオプションのみが変更されます。[--url TEXT --watch TEXT --domain CHOICE --secret TEXT --format CHOICE]

一般的なオプション

• --format — 出力形式: --format json（または --json）または --format table（デフォルト）。
• -q / --quiet — ID のみを出力します（1 行に 1 つ）。
• --revision — ブランチ名、タグ、またはコミットハッシュに指定できる Git リビジョン ID。
• --token — ユーザーアクセストークンを使用します。--token を渡す代わりに HF_TOKEN 環境変数を設定することをお勧めします。
• --type — リポジトリのタイプ（モデル、データセット、または Space）。

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

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

インストール: curl -fsSL https://raw.githubusercontent.com/huggingface/hf-mount/main/install.sh | sh

コマンドの例：

• hf-mount start repo openai-community/gpt2 /tmp/gpt2 — リポジトリをマウント（読み取り専用）
• hf-mount start --hf-token $HF_TOKEN bucket myuser/my-bucket /tmp/data — バケットをマウント（読み書き可能）
• hf-mount status / hf-mount stop /tmp/data — リスト表示またはアンマウント

ヒント

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