huggingface-hub

Client library to download and publish models, datasets and other repos on the huggingface.co hub

Apache-2.0 292 个版本 Python >=3.10.0

Hugging Face, Inc. <julien@huggingface.co>

安装

pip install huggingface-hub

poetry add huggingface-hub

pipenv install huggingface-hub

conda install huggingface-hub

描述

huggingface_hub library logo

The official Python client for the Huggingface Hub.

English | Deutsch | Français | हिंदी | 한국어 | 中文 (简体)

Documentation: https://hf.co/docs/huggingface_hub

Source Code: https://github.com/huggingface/huggingface_hub

Welcome to the huggingface_hub library

The huggingface_hub library allows you to interact with the Hugging Face Hub, a platform democratizing open-source Machine Learning for creators and collaborators. Discover pre-trained models and datasets for your projects or play with the thousands of machine learning apps hosted on the Hub. You can also create and share your own models, datasets and demos with the community. The huggingface_hub library provides a simple way to do all these things with Python.

Key features

Download files from the Hub.
Upload files to the Hub.
Manage your repositories.
Run Inference on deployed models.
Search for models, datasets and Spaces.
Share Model Cards to document your models.
Engage with the community through PRs and comments.

Installation

Install the huggingface_hub package with pip:

pip install huggingface_hub

We recommend using uv for a fast and reliable install:

uv pip install huggingface_hub

In order to keep the package minimal by default, huggingface_hub comes with optional dependencies useful for some use cases. For example, if you want to use the MCP module, run:

pip install "huggingface_hub[mcp]"

To learn more about installation and optional dependencies, check out the installation guide.

Quick start

Download files

Download a single file

from huggingface_hub import hf_hub_download

hf_hub_download(repo_id="tiiuae/falcon-7b-instruct", filename="config.json")

Or an entire repository

from huggingface_hub import snapshot_download

snapshot_download("stabilityai/stable-diffusion-2-1")

Files will be downloaded in a local cache folder. More details in this guide.

The Hugging Face Hub uses tokens to authenticate applications (see docs). To log in your machine, run the following CLI:

hf auth login
# or using an environment variable
hf auth login --token $HUGGINGFACE_TOKEN

Create a repository

from huggingface_hub import create_repo

create_repo(repo_id="super-cool-model")

Upload files

Upload a single file

from huggingface_hub import upload_file

upload_file(
    path_or_fileobj="/home/lysandre/dummy-test/README.md",
    path_in_repo="README.md",
    repo_id="lysandre/test-model",
)

Or an entire folder

from huggingface_hub import upload_folder

upload_folder(
    folder_path="/path/to/local/space",
    repo_id="username/my-cool-space",
    repo_type="space",
)

For details in the upload guide.

Integrating to the Hub.

We're partnering with cool open source ML libraries to provide free model hosting and versioning. You can find the existing integrations here.

The advantages are:

Free model or dataset hosting for libraries and their users.
Built-in file versioning, even with very large files, thanks to a git-based approach.
In-browser widgets to play with the uploaded models.
Anyone can upload a new model for your library, they just need to add the corresponding tag for the model to be discoverable.
Fast downloads! We use Cloudfront (a CDN) to geo-replicate downloads so they're blazing fast from anywhere on the globe.
Usage stats and more features to come.

If you would like to integrate your library, feel free to open an issue to begin the discussion. We wrote a step-by-step guide with ❤️ showing how to do this integration.

Contributions (feature requests, bugs, etc.) are super welcome 💙💚💛💜🧡❤️

Everyone is welcome to contribute, and we value everybody's contribution. Code is not the only way to help the community. Answering questions, helping others, reaching out and improving the documentations are immensely valuable to the community. We wrote a contribution guide to summarize how to get started to contribute to this repository.

分类

Intended Audience :: Developers Intended Audience :: Education Intended Audience :: Science/Research License :: OSI Approved :: Apache Software License Operating System :: OS Independent Programming Language :: Python :: 3 Programming Language :: Python :: 3 :: Only Programming Language :: Python :: 3.10 Programming Language :: Python :: 3.11 Programming Language :: Python :: 3.12 Programming Language :: Python :: 3.13 Programming Language :: Python :: 3.14 Topic :: Scientific/Engineering :: Artificial Intelligence

版本列表

1.20.1 2026-06-18

1.20.0 2026-06-18

1.20.0rc0 2026-06-18

1.19.0 2026-06-11

1.19.0rc1 2026-06-11

1.19.0rc0 2026-06-11

1.18.0 2026-06-05

1.18.0rc0 2026-06-05

1.17.0 2026-05-28

1.17.0rc0 2026-05-28

1.16.4 2026-05-26

1.16.3 2026-05-26

1.16.1 2026-05-21

1.16.0 2026-05-21

1.16.0rc0 2026-05-21

1.15.0 2026-05-15

1.15.0rc0 2026-05-15

1.14.0 2026-05-06

1.14.0rc0 2026-05-06

1.13.0 2026-04-30

1.13.0rc0 2026-04-30

1.12.2 2026-04-29

1.12.1 2026-04-29

1.12.0 2026-04-24

1.12.0rc1 2026-04-24

1.12.0rc0 2026-04-24

1.11.0 2026-04-16

1.11.0rc0 2026-04-16

1.10.2 2026-04-14

1.10.1 2026-04-09

1.10.0 2026-04-09

1.10.0rc1 2026-04-09

1.10.0rc0 2026-04-09

1.9.2 2026-04-08

1.9.1 2026-04-07

1.9.0 2026-04-03

1.9.0rc0 2026-04-02

1.8.0 2026-03-25

1.8.0rc0 2026-03-25

1.7.2 2026-03-20

1.7.1 2026-03-13

1.7.0 2026-03-13

1.7.0rc1 2026-03-12

1.7.0rc0 2026-03-12

1.6.0 2026-03-06

1.6.0rc0 2026-03-06

1.5.0 2026-02-26

1.5.0rc0 2026-02-26

1.4.1 2026-02-06

1.4.0 2026-02-04

1.4.0rc0 2026-02-03

1.3.7 2026-02-02

1.3.5 2026-01-29

1.3.4 2026-01-26

1.3.3 2026-01-22

1.3.2 2026-01-14

1.3.1 2026-01-09

1.3.0 2026-01-09

1.3.0rc0 2026-01-08

1.2.4 2026-01-06

1.2.3 2025-12-12

1.2.2 2025-12-10

1.2.1 2025-12-05

1.2.0 2025-12-05

1.2.0rc0 2025-12-04

1.1.7 2025-12-01

1.1.6 2025-11-28

1.1.5 2025-11-20

1.1.4 2025-11-13

1.1.3 2025-11-13

1.1.2 2025-11-06

1.1.1 2025-11-05

1.1.0 2025-11-05

1.1.0rc2 2025-11-05

1.1.0rc1 2025-11-05

1.1.0rc0 2025-11-05

1.0.1 2025-10-28

1.0.0 2025-10-27

1.0.0rc7 2025-10-21

1.0.0rc6 2025-10-13

1.0.0rc5 2025-10-10

1.0.0rc4 2025-10-08

1.0.0rc3 2025-10-08

1.0.0rc2 2025-09-25

1.0.0rc1 2025-09-24

1.0.0rc0 2025-09-15

0.36.2 2026-02-06

0.36.1 2026-02-02

0.36.0 2025-10-23

0.36.0rc0 2025-10-21

0.35.3 2025-09-29

0.35.2 2025-09-29

0.35.1 2025-09-23

0.35.0 2025-09-16

0.35.0rc1 2025-09-16

0.35.0rc0 2025-07-24

0.34.6 2025-09-16

0.34.5 2025-09-15

0.34.4 2025-08-08

0.34.3 2025-07-29

0.34.2 2025-07-28

0.34.1 2025-07-25

0.34.0 2025-07-25

0.34.0rc0 2025-07-24

0.33.5 2025-07-24

0.33.4 2025-07-11

0.33.3 2025-07-11

0.33.2 2025-07-02

0.33.1 2025-06-25

0.33.0 2025-06-11

0.33.0rc0 2025-06-11

0.32.6 2025-06-11

0.32.5 2025-06-10

0.32.4 2025-06-03

0.32.3 2025-05-30

0.32.2 2025-05-27

0.32.1 2025-05-26

0.32.0 2025-05-23

0.32.0rc1 2025-05-23

0.32.0rc0 2025-05-22

0.31.4 2025-05-19

0.31.3 2025-05-19

0.31.2 2025-05-13

0.31.1 2025-05-07

0.31.0 2025-05-07

0.31.0rc0 2025-05-06

0.30.2 2025-04-08

0.30.1 2025-03-31

0.30.0 2025-03-31

0.30.0rc3 2025-03-28

0.30.0rc2 2025-03-27

0.30.0rc1 2025-03-27

0.30.0rc0 2025-03-27

0.29.3 2025-03-11

0.29.2 2025-03-05

0.29.1 2025-02-20

0.29.0 2025-02-19

0.29.3rc0 2025-03-11

0.29.0rc7 2025-02-18

0.29.0rc6 2025-02-18

0.29.0rc5 2025-02-18

0.29.0rc4 2025-02-18

0.29.0rc3 2025-02-18

0.29.0rc2 2025-02-18

0.29.0rc1 2025-02-18

0.29.0rc0 2025-02-18

0.28.1 2025-01-30

0.28.0 2025-01-28

0.28.0rc5 2025-01-28

0.28.0rc4 2025-01-28

0.28.0rc3 2025-01-28

0.28.0rc2 2025-01-28

0.28.0rc1 2025-01-28

0.28.0rc0 2025-01-28

0.27.1 2025-01-06

0.27.0 2024-12-16

0.27.0rc1 2024-12-16

0.27.0rc0 2024-12-13

0.26.5 2024-12-06

0.26.4 2024-12-06

0.26.3 2024-11-28

0.26.2 2024-10-28

0.26.1 2024-10-21

0.26.0 2024-10-18

0.26.0rc0 2024-10-17

0.25.2 2024-10-09

0.25.1 2024-09-23

0.25.0 2024-09-17

0.25.0rc1 2024-09-17

0.25.0rc0 2024-09-16

0.24.7 2024-09-12

0.24.6 2024-08-19

0.24.5 2024-07-31

0.24.4 2024-07-31

0.24.3 2024-07-29

0.24.2 2024-07-24

0.24.1 2024-07-23

0.24.0 2024-07-18

0.24.0rc0 2024-07-17

0.23.5 2024-07-16

0.23.4 2024-06-14

0.23.3 2024-06-05

0.23.2 2024-05-27

0.23.1 2024-05-21

0.23.0 2024-05-02

0.23.0rc1 2024-04-30

0.23.0rc0 2024-04-30

0.22.2 2024-03-29

0.22.1 2024-03-26

0.22.0 2024-03-25

0.22.0rc1 2024-03-25

0.22.0rc0 2024-03-21

0.21.4 2024-03-06

0.21.3 2024-02-29

0.21.2 2024-02-28

0.21.1 2024-02-27

0.21.0 2024-02-27

0.21.0rc0 2024-02-27

0.20.3 2024-01-22

0.20.2 2024-01-05

0.20.1 2023-12-20

0.20.0 2023-12-20

0.20.0rc1 2023-12-19

0.20.0rc0 2023-12-19

0.19.4 2023-11-16

0.19.3 2023-11-15

0.19.2 2023-11-15

0.19.1 2023-11-13

0.19.0 2023-11-08

0.19.0rc0 2023-11-06

0.18.0 2023-10-10

0.18.0rc0 2023-10-06

0.17.3 2023-09-26

0.17.2 2023-09-18

0.17.1 2023-09-11

0.17.0 2023-09-11

0.17.0rc0 2023-09-08

0.16.4 2023-07-07

0.16.3 2023-07-07

0.16.2 2023-07-05

0.16.1 2023-07-05

0.16.0rc0 2023-07-04

0.15.1 2023-06-01

0.15.0 2023-06-01

0.15.0rc0 2023-06-01

0.14.1 2023-04-25

0.14.0 2023-04-24

0.14.0rc1 2023-04-20

0.14.0rc0 2023-04-18

0.13.4 2023-04-06

0.13.3 2023-03-20

0.13.2 2023-03-13

0.13.1 2023-03-09

0.13.0 2023-03-08

0.13.0rc1 2023-03-08

0.13.0rc0 2023-03-08

0.12.1 2023-02-17

0.12.0 2023-01-25

0.12.0rc0 2023-01-20

0.11.1 2022-11-28

0.11.0 2022-11-16

0.11.0rc1 2022-11-15

0.11.0rc0 2022-11-14

0.10.1 2022-10-11

0.10.0 2022-09-28

0.10.0rc3 2022-09-27

0.10.0rc1 2022-09-27

0.10.0rc0 2022-09-26

0.9.1 2022-08-25

0.9.0 2022-08-23

0.9.0.dev0 2022-08-18

0.9.0rc3 2022-08-23

0.9.0rc2 2022-08-18

0.9.0rc0 2022-08-18

0.8.1 2022-06-21

0.8.0 2022-06-16

0.8.0rc4 2022-06-20

0.8.0rc3 2022-06-17

0.8.0rc2 2022-06-16

0.8.0rc1 2022-06-16

0.8.0rc0 2022-06-15

0.7.0 2022-05-24

0.7.0rc0 2022-05-24

0.6.0 2022-05-11

0.6.0rc0 2022-05-09

0.5.1 2022-04-06

0.5.0 2022-04-05

0.4.0 2022-01-11

0.2.1 2021-12-03

0.2.0 2021-12-01

0.1.2 2021-11-08

0.1.1 2021-11-05

0.1.0 2021-11-02

0.0.19 2021-10-06

0.0.18 2021-10-04

0.0.17 2021-09-14

0.0.16 2021-08-27

0.0.15 2021-07-28

0.0.14 2021-07-16

0.0.13 2021-06-28

0.0.12 2021-06-23

0.0.11 2021-06-23

0.0.10 2021-06-08

0.0.9 2021-05-20

0.0.8 2021-04-07

0.0.7 2021-03-18

0.0.6 2021-03-02

0.0.5 2021-03-02

0.0.2 2021-02-12

0.0.1 2020-12-23

0.0.3rc2 2021-02-23

0.0.3rc1 2021-02-20