huggingface-hub

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

huggingface-hub Permissive license Apache-2.0 Active ★ 3,798 v1.27.0 released 2026-08-07

Install

huggingface-hub on PyPI

pip

pip install huggingface-hub

uv

uv add huggingface-hub

poetry

poetry add huggingface-hub

Package facts

License	Apache-2.0 (permissive)
Python support	supports the current Python release (>=3.10.0)
Install friction	low — pure-Python wheel
Runtime dependencies	9 — click, filelock, fsspec, hf-xet, httpx, packaging, pyyaml, tqdm, typing-extensions
Maintenance	actively maintained — 6 days since the last release
Last repo commit	2026-08-13
First released	2020-12-23
Popularity	one of the 100 most-downloaded packages on PyPI (30-day window, as of 2026-08-13)
Known vulnerabilities	none known (OSV.dev, checked 2026-08-13)

Evidence: huggingface_hub-1.27.0-py3-none-any.whl

Keywords: model-hub, machine-learning, models, natural-language-processing, deep-learning, pytorch, pretrained-models

Intended Audience :: DevelopersIntended Audience :: EducationIntended Audience :: Science/ResearchLicense :: OSI Approved :: Apache Software LicenseOperating System :: OS IndependentProgramming Language :: Python :: 3Programming Language :: Python :: 3 :: OnlyProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Topic :: Scientific/Engineering :: Artificial Intelligence

About huggingface-hub

from the package's own PyPI description — quoted content, verbatim

The official CLI and Python client for the Hugging Face Hub. <a href="#what-is-huggingface_hub">About</a> · <a href="https://huggingface.co/docs/huggingface_hub">Documentation</a> · <a href="https://huggingface.co/docs/huggingface_hub/en/installation">Install</a> · <a href="https://huggingface.co/docs/huggingface_hub/en/guides/cli">CLI Guide</a> · <a href="https://github.com/huggingface/huggingface_hub/blob/main/CONTRIBUTING.md">Contributing</a>

<a href="https://huggingface.co/docs/huggingface_hub/en/index"><img...

Read as markdown · JSON record · Source repository · Homepage

AI interpretation — verify before relying

AI-generated interpretation of the package facts above; every digit, version, license, or vulnerability id it cites is grounded in the facts already shown on this page

Official Python client and CLI for the Hugging Face Hub, enabling download and upload of models, datasets, and repositories, plus inference execution and repository management.

Low install friction with a pure-Python wheel and nine stable runtime dependencies including click, filelock, fsspec, httpx, packaging, pyyaml, tqdm, typing-extensions, and hf-xet. Active maintenance with a release 6 days ago.

Apache-2.0 permissive license allows commercial use, modification, and redistribution with minimal restrictions, making it suitable for most projects.

Usage

pip install huggingface_hub

from huggingface_hub import hf_hub_download
hf_hub_download(repo_id="zai-org/GLM-5.2", filename="config.json")

Requires Python >=3.10.0

Verdict: A mature, actively maintained top-100 PyPI package with permissive Apache-2.0 licensing and low install friction. No known vulnerabilities and broad Python 3.10+ support make it a reliable choice for integrating with the Hugging Face Hub ecosystem.

Needs verification

Whether hf-xet introduces any platform-specific or compilation requirements beyond what the wheel distribution handles
Performance characteristics or rate-limiting behavior when downloading large models or datasets
GitHub star count and repository activity level beyond the 6-day release cadence

hugging face model downloadhuggingface hub clientmachine learning model repositorypretrained model managementml model hub integrationhuggingface api pythonmodel inference api client