HuggingFace CLI

このページの HuggingFace CLI は、公式リポジトリ huggingface/skills の hf-cli スキルです。hf コマンドラインツールの完全で最新のリファレンスをエージェントに渡し、Hugging Face Hub でのモデル検索、ファイル転送、リポジトリや Spaces の管理、計算資源の起動をフラグを推測せずに行えるようにします。Hugging Face は最初に入れるべきスキルとして推奨しており、リポジトリ内の他のスキルもこれを前提にしています。

スキルファイルはローカルにインストールされた CLI から生成されます（2026-09-23 に確認した版は huggingface_hub v1.32.0 から生成）。CLI を更新したら hf skills add --force で再生成できます。hf が非推奨の huggingface-cli を置き換え、ログインは hf auth 配下に移ったことも明記されています。

主な機能

• 転送：hf download、hf upload、hf cp、hf sync。--include/--exclude フィルタと --dry-run に対応。
• リポジトリと共同作業：hf repos create、hf discussions（Hub のプルリクエストの作成、diff 表示、コメント、マージ）、hf collections。
• 検索：hf models list、hf datasets list、hf spaces search、hf papers search、hf papers read（論文を markdown で読む）。
• データ：hf datasets parquet でシャード URL を一覧し、hf datasets sql で DuckDB の SQL を実行。
• 計算資源：hf jobs run、hf jobs uv run、Inference Endpoints 用の hf endpoints deploy、実験的な hf sandbox VM。
• ストレージとキャッシュ：hf buckets、hf cache list、hf cache prune、hf cache verify。
• エージェント向け出力：多くのコマンドが --format agent または --format json に対応し、表よりも解析しやすい形式で返します。

使用シナリオ

• フラグを調べずに、エージェントにモデルやデータセットをプロジェクトへ取得させる。
• Hub のプルリクエストをターミナルからレビューしてマージする。
• ダウンロード前にデータセットを SQL で確認する。

料金

スキルと CLI は無料のオープンソースです（リポジトリは Apache-2.0）。Jobs、sandbox、Inference Endpoints など有料の計算資源を起動するコマンドは、Hugging Face アカウントに課金されます。

はじめに

1. CLI をインストール：curl -LsSf https://hf.co/cli/install.sh | bash -s、続けて hf auth login（または HF_TOKEN を設定）。
2. Claude Code で：/plugin marketplace add huggingface/skills、次に /plugin install hf-cli@huggingface/skills。
3. 同じスキルは Cursor Marketplace と Codex Plugins Directory にもあり、Gemini CLI ではリポジトリを拡張機能として入れられます。
4. ほかのワークフロースキルは必要になったら hf skills add <skill-name> で追加します。

制約：スキルは長く（英語で約 3,800 語）、起動のたびにコンテキストを消費します。CLI を更新しても再生成しなければ内容が古くなります。hf buckets delete のような破壊的コマンドは人が確認すべきです。

よくある質問

huggingface-cli はまだ使えますか？

非推奨です。スキルと CLI ドキュメントはどちらも hf を案内しています。

ほかの Hugging Face スキルも必要ですか？

不要です。まずこれを入れ、学習や評価のワークフローが必要になったら追加してください。

代替案

• HuggingFace Datasets：Dataset Viewer API に特化した、より狭いスキル。
• HuggingFace Tool Builder：Hub API 上に再利用できるスクリプトを作成。
• Hugging Face：プラットフォーム自体のページ。

まとめ

エージェントが Hub を扱うなら、まず hf-cli を入れてください。フラグの推測を実際のコマンド一覧に置き換えられます。詳しくは skills カテゴリ と hugging-face タグ へ。