huggingface-hub について
Hugging Face CLIの`hf`は、コマンドラインからHubのリポジトリ、モデル、データセット、Spacesを管理します。計算、ストレージ、ディスカッション、自動化にも対応します。
主な機能
- 01Hubファイルのダウンロードとアップロード
- 02認証トークンの管理
- 03リポジトリの作成と整理
- 04モデル、データセット、論文の閲覧
- 05エンドポイント、ジョブ、Spacesの管理
- 06バケット、キャッシュ、Webhookの操作
活用シーン
- 01Hubアセットのダウンロードやアップロード
- 02リポジトリのブランチやプルリクエストの管理
- 03ジョブの実行や推論エンドポイントの管理
- 04バケットの同期とHubワークフローの自動化
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/huggingface-hubを入力して読み込まれたか確認します。
詳細
Hugging Face CLI（hf）リファレンスガイド
hf コマンドは、Hugging Face Hub を操作するための最新のコマンドラインインターフェースです。リポジトリ、モデル、データセット、Spaces を管理するツールを提供します。
IMPORTANT:
hfコマンドは、現在非推奨となっているhuggingface-cliコマンドに代わるものです。
クイックスタート
- インストール：
curl -LsSf https://hf.co/cli/install.sh | bash -s - ヘルプ：
hf --helpを使用すると、利用可能なすべての機能と実例を確認できます。 - 認証：
HF_TOKEN環境変数または--tokenフラグを使用する方法を推奨します。
主なコマンド
一般的な操作
hf download REPO_ID：Hub からファイルをダウンロードします。hf upload REPO_ID：ファイルやフォルダーをアップロードします（単一コミットの場合に推奨。大きなディレクトリの再開可能なアップロードにも対応します）。hf upload-large-folder REPO_ID LOCAL_PATH：［非推奨］ — 代わりにhf uploadを使用してください。hf sync：ローカルディレクトリとバケット間でファイルを同期します。hf env/hf version：環境とバージョンの詳細を表示します。
認証（hf auth）
login/logout：huggingface.co/settings/tokensのトークンを使用してセッションを管理します。list/switch：保存済みの複数のアクセストークンを管理し、切り替えます。whoami：現在ログインしているアカウントを確認します。
リポジトリ管理（hf repos）
create/delete：リポジトリを作成または完全に削除します。duplicate：モデル、データセット、または Space を新しい ID に複製します。move：リポジトリを別の名前空間に移動します。branch/tag：Git のような参照を管理します。delete-files：パターンを使用して特定のファイルを削除します。
Hub の各種機能
データセットとモデル
- データセット：
hf datasets list、info、parquet（parquet の URL を一覧表示）。 - SQL クエリ：
hf datasets sql SQL— データセットの parquet URL に対して、DuckDB 経由で生の SQL を実行します。 - モデル：
hf models listとinfo。 - 論文：
hf papers ls— 日刊論文を表示します。
ディスカッションとプルリクエスト（hf discussions）
- Hub へのコントリビューションのライフサイクルを管理します：
list、create、info、comment、close、reopen、rename。 diff：PR の変更内容を表示します。merge：プルリクエストを確定します。
インフラストラクチャとコンピューティング
- エンドポイント： Inference Endpoints をデプロイして管理します（
deploy、pause、resume、scale-to-zero、catalog）。 - ジョブ： HF インフラストラクチャ上でコンピューティングタスクを実行します。インライン依存関係を指定して Python スクリプトを実行する
hf jobs uvや、リソースを監視するstatsが含まれます。 - Spaces： インタラクティブアプリを管理します。完全に再起動せずに Python ファイルを更新する
dev-modeとhot-reloadが含まれます。
ストレージと自動化
- バケット： S3 のような包括的なバケット管理（
create、cp、mv、rm、sync）。 - キャッシュ：
list、prune（切り離されたリビジョンを削除）、verify（チェックサムを確認）を使ってローカルストレージを管理します。 - Webhook： Hub の Webhook を管理してワークフローを自動化します（
create、watch、enable/disable）。 - コレクション： Hub のアイテムをコレクションに整理します（
add-item、update、list）。
高度な使い方とヒント
グローバルフラグ
--format json：機械可読な出力を生成し、自動化に使用できます。-q/--quiet：出力を ID のみに制限します。
拡張機能とスキル
- 拡張機能：
hf extensions install REPO_IDを使用し、GitHub リポジトリ経由で CLI の機能を拡張します。 - スキル：
hf skills addを使用して AI アシスタントのスキルを管理します。
コメント
Markdown 対応