Hugging Face Hub’s official `huggingface_hub` Python client and `hf` CLI to interact with Hugging Face Hub. Use it to download and upload models and related files, search the Hub, and perform Hub tasks like running inference or jobs.
Project status
- Actively maintained, the last upstream push was 2026-07-17 and the recent updates include v1.24.0 plus release-candidate builds (rc2, rc3), indicating ongoing development.
- Apparent cadence is very high recently, multiple updates occurred within minutes on 2026-07-17 (rc2, rc3, then v1.24.0), suggesting fast iteration rather than a long release gap.
AI summary generated
Recent updates
v1.24.0
v1.24.0 documents new optional naming support for Jobs via both the CLI and Python APIs, plus documentation updates and a bug fix for xet download rate display. The provided code diff (v1.24.0.rc3 to v1.24.0) shows only a version string change in the package __init__.py.
Featuresv1.24.0.rc3
This release (v1.24.0.rc3) contains no documented release notes from the publisher. The only observed code change is a patch-level update to the package version string.
v1.24.0.rc2
No release notes were provided for v1.24.0.rc2, so there is no publisher-documented information about new features, bug fixes, or breaking changes. Treat this release as a candidate for code-level review (diff/changelog scan) before upgrading, especially if you rely on recently changed APIs or behavior.
v1.23.0
v1.23.0 adds official Space template support (Python API and CLI) and introduces an `hf extensions update` command to keep installed CLI extensions current. It also improves Xet download progress reporting by displaying separate transfer and reconstruction progress bars, and makes the built-in `hf-cli` skill installable offline by generating it locally.
Featuresv1.22.0
v1.22.0 adds a new Sandboxes API and corresponding `hf sandbox` CLI built on top of Jobs, plus improvements to `snapshot_download` using an on-disk per-commit tree cache. It also rebuilds the entire `hf` CLI on top of Click 8.x instead of Typer, aiming to preserve `--help` output and shell completion behavior. Additionally, it introduces the Jobs sync_job_volume functionality and scheduled job triggering helpers.
BreakingFeaturesv1.20.1
v1.20.1 contains only a small internal code change set, with a package version bump and refactoring of the OAuth device login helpers. The diff shows the device OAuth implementation being moved under a different module path, and all in-repo imports updated accordingly.
v1.21.0
This release overhauls the Jobs listing experience by adding server-side filtering (status, labels) and true pagination for both the Python API and the `hf` CLI. It also renames the CLI command from `hf jobs ps` to `hf jobs ls` while keeping `ps` and `list` as aliases. Additionally, there are reliability and import-related fixes (including the previously reported circular import regression) and some smaller internal improvements.
BreakingFeaturesv1.20.0
v1.20.0 introduces browser-based OAuth login via an OAuth Device Code flow, a revamped streamed multi-commit folder upload pipeline (powered by Xet when available), and new Jobs and Spaces primitives for waiting on terminal states plus SSH support. It also extends Inference Endpoints deploy with custom container flags and updates several CLI and API behaviors around IDs/URIs and error messaging.
BreakingFeaturesv1.19.0
v1.19.0 adds keyless CI/CD authentication via Trusted Publishers (OIDC token exchange), support for `hf://` URIs in `hf upload` and `hf download`, and the ability for Jobs to expose container ports through the public jobs proxy. It also migrates Xet optimized upload/download internals to the session-based `XetSession` API, and includes various CLI UX and bug fix improvements.
BreakingFeaturesv1.18.0
v1.18.0 introduces a unified `hf cp` CLI command that replaces the previous bucket-specific copy workflows, adds support for pasting Hugging Face web URLs into URI parsing, and includes an interactive “city skyline” easter egg for repo exploration. On the library side, concurrent download correctness is improved by changing the download behavior to never resume incomplete partial files (to avoid cache corruption when file locking is broken).
BreakingFeaturesv1.17.0
v1.17.0 adds cross-repository copy capabilities to the Hub commit API and introduces new CLI commands including `hf spaces ssh` and `hf repos ls`. It also refactors CLI output handling (new `out`/`OutputFormat` flow, improved human table sizing and numeric alignment) and decouples Jobs hardware from Spaces hardware with a new `JobHardware` enum and `JobHardwareInfo` type.
BreakingFeaturesv1.16.4
v1.16.4 is a hotfix release focused on dependency compatibility for the CLI. It adjusts the allowed versions of `typer` and adds `click` as an explicit dependency.