huggingface/huggingface_hub

これは何？

主な機能

• 01単一ファイルまたはリポジトリ全体をローカルキャッシュにダウンロードする。
• 02モデル、データセット、Spacesにファイルやフォルダをアップロードする。
• 03PythonまたはターミナルからHubのリポジトリを作成、管理する。
• 04Hub上のモデル、データセット、Spacesを検索する。
• 05デプロイ済みモデルで推論を実行し、Hugging Faceのインフラ上でジョブを起動する。
• 06対話操作なしでの利用を含め、Hubのアクセストークンで認証する。

ユースケース

• 学習または推論パイプラインに、事前学習済みモデルの重みをダウンロードする。
• 学習スクリプトからモデルのチェックポイントやデータセットをHubに公開する。
• ターミナルやCIジョブから、ローカルフォルダをHubのストレージバケットに同期する。
• hf CLIを通じて、コーディングエージェントがHubのリポジトリを操作できるようにする。

クイックスタート

1. 1

   hf CLIをインストールする（macOSとLinux）

   curl -LsSf https://hf.co/cli/install.sh | bash
2. 2

   Hubにログインする

   hf auth login
3. 3

   モデルをダウンロードする

   hf download Qwen/Qwen3-0.6B

使う前に知っておきたいこと

• !非公開リポジトリをアップロードまたは管理するには、Hugging Faceのアカウントとトークンが必要です。

トピック

よくある質問

huggingface_hub とは？

Hugging Face Hubのリポジトリをダウンロード、アップロード、管理する公式CLI（hf）とPythonクライアント。 huggingface_hubは、機械学習モデル、データセット、SpacesをホスティングするプラットフォームであるHugging Face Hubの公式Pythonライブラリ兼コマンドラインツールです。Pythonコードやターミナルから、ファイルのダウンロードとアップロード、リポジトリの作成と管理、Hubの検索、デプロイ済みモデルでの推論、Hugging Faceのインフラ上でのジョブの起動ができます。

huggingface_hub は無料で使えますか？ライセンスは？

huggingface_hub は Apache-2.0 ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

huggingface_hub は今もメンテナンスされていますか？

活発にメンテナンス中。huggingface_hub の最終コミットは 2026年10月19日 です。

huggingface_hub は何に使えますか？

学習または推論パイプラインに、事前学習済みモデルの重みをダウンロードする。 学習スクリプトからモデルのチェックポイントやデータセットをHubに公開する。 ターミナルやCIジョブから、ローカルフォルダをHubのストレージバケットに同期する。 hf CLIを通じて、コーディングエージェントがHubのリポジトリを操作できるようにする。

huggingface_hub のインストール方法は？

hf CLIをインストールする（macOSとLinux）: curl -LsSf https://hf.co/cli/install.sh | bash Hubにログインする: hf auth login モデルをダウンロードする: hf download Qwen/Qwen3-0.6B

huggingface_hub はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/huggingface/huggingface_hub