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: Recent upstream push was on 2026-09-02, and the latest documented update (v1.29.0 on 2026-08-27) followed shortly after, indicating ongoing development rather than maintenance mode.
- Update cadence: In August 2026 there are multiple updates clustered within weeks (for example, v1.25.0, v1.25.1, v1.26.0, v1.26.1, v1.27.0, v1.28.0, v1.29.0), suggesting a typical cadence of about 1 to 2 weeks for minor updates, with occasional patch releases.
AI summary generated
Recent updates
v1.30.0
v1.30.0 adds richer filtering for `hf jobs scheduled ls` (status, labels, and name) and introduces repo-aware revision pinning via `ResolvedRevision`. It also relaxes hf-inference task gating for conversational chat completion models and updates file resolution to follow redirects across Hub hosts more reliably.
BreakingFeaturesv1.29.0
v1.29.0 focuses on improving large Xet downloads by reusing cached connection info (fewer Hub API calls), adds the ability to change bucket visibility, and includes security fixes for bucket sync path traversal and safetensors extension-confusion. It also refreshes some CLI help rendering behavior for Click 8.5, tightens sandbox documentation/security messaging, and tweaks inference error messaging for 504 timeouts.
BreakingSecurityFeaturesv1.25.1
Release v1.25.1 contains essentially no documented changes in the provided release notes (only a changelog comparison link). The code diff shows a small version bump and a meaningful modification to the sandbox bootstrap process related to how the server artifact is downloaded and authenticated.
v1.26.1
v1.26.1 primarily adds support for a new inference provider, Baseten, by wiring it into the inference client provider routing. The release notes provided do not list any specific changes beyond a changelog link, so the Baseten addition and related doc/CLI updates are not explicitly documented here.
Featuresv1.28.0
This release introduces the new `hf endpoints hardware` command (and `list_inference_endpoints_hardware()` in the SDK) to discover deployable Inference Endpoint hardware combinations with quota and pricing. It also extends managed engine image support for Inference Endpoints by changing the `custom_image` payload shape, and adds parallelism-related CLI flags for vLLM and SGLang.
BreakingFeaturesv1.27.0
v1.27.0 adds automatic management of the `hf-cli` AI-agent skill, including global installation by default in the standalone installers, periodic (daily) local hints when the skill is missing or out of date, and an `hf update` refresh flow that respects opting out. It also extends Inference Endpoints to allow `--container-command` and `--container-args` without requiring `--custom-image`, supports those settings via `endpoints update` and the underlying Python API, and introduces the new Baseten inference provider for conversational chat completions.
BreakingFeaturesv1.26.0
v1.26.0 introduces a new revision-pinning mechanism via `HfApi.resolve_revision` and `ResolvedRevision`, so multi-file downloads can be pinned to the same commit with fewer HTTP requests. It also ships security hardening for `local_dir` and sandbox bootstrap, adds organization resource group support for Jobs and Collections, and improves the Jobs CLI to surface and filter by job name.
BreakingSecurityFeaturesv1.25.0
v1.25.0 introduces automatic job naming at creation time, along with progress bar and cache diagnostics improvements. It also adds a `timeout` parameter to safetensors metadata parsing, plus several bug fixes across jobs, cache handling, repocard parsing, and file system streaming.
Featuresv1.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.