このプロジェクトについて

huggingface_hub は、オープンソースの機械学習モデル、データセット、デモを共有するプラットフォームである Hugging Face Hub の公式コマンドラインインターフェース兼 Python クライアントです。このプロジェクトは両方のインターフェースを 1 つのパッケージで提供します。ターミナルで使用する `hf` CLI と、`huggingface_hub` Python ライブラリです。 インストールは、macOS、Linux、Windows 向けのスタンドアロンインストーラスクリプト、または Python パッケージ用の pip/uv を通じて行えます。pip/uv でインストールする場合は CLI も同時にインストールされます。オプションの依存関係グループ(たとえば MCP モジュール)により、デフォルトのインストールは最小限に保たれます。 README に記載されている主な機能: - 個別ファイルまたはリポジトリ全体のダウンロード。ファイルはローカルのキャッシュフォルダーに保存されます。 - 単一ファイルまたはフォルダー全体をモデル、データセット、Space リポジトリへアップロード。 - Hub 上でのリポジトリの作成と管理。 - デプロイされたモデルに対する推論の実行。 - Hugging Face インフラストラクチャ上での Jobs の実行。 - モデル、データセット、Spaces の検索。 - モデルを文書化するためのモデルカードの共有。 - プルリクエストやコメントを通じたコミュニティとの交流。 CLI は人間とコーディングエージェントの両方のために明確に設計されています。エージェントから呼び出された場合にはコマンド出力が適応され、Claude Code、Codex、Cursor、OpenCode などのツール向けに生成されたスキルリファレンスをインストールできます。認証には Hub トークンを使用し、自動化環境向けの非対話型トークンオプションも用意されています。 README では、他のオープンソース ML ライブラリとの統合についても言及されており、モデルとデータセットの無料ホスティング、Xet ストレージバックエンドによる大容量ファイルのファイルバージョニング、ブラウザー内ウィジェット、CDN による高速ダウンロード、利用統計を提供します。機能リクエストとバグ報告に関するコントリビューションガイダンスも提供されています。