●Change8

Migrating to HuggingFace Hub v1.19.0.rc1

Version v1.19.0.rc1 introduces 2 breaking changes. This guide details how to update your code.

Released: 6/11/2026

2
Breaking Changes
3
Migration Steps
10
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

hf uploadhf downloadhf jobs runhf jobs uv runJobStatusget_token()hf_xetXetSessionget_xet_session()xet_connection_info_refresh_url()

Breaking Changes

●Issue #1

When using `hf upload` or `hf download` with an `hf://` URI, positional arguments for repo ID, `--repo-type`, or `--revision` are no longer accepted or take precedence. The URI must be the single source of truth. If a URI is used, passing `--repo-type` or `--revision` will raise an error. Similarly, a path specified within the URI cannot be combined with positional filenames (download) or `path_in_repo` (upload).

●Issue #2

All Xet upload and download code must migrate from the old function-based `hf_xet` API to the new session-based `XetSession` API (requires `hf-xet >= 1.5.0`). Token refresh logic must use the centralized `xet_connection_info_refresh_url()` builder, and progress reporting must adhere to the new `(group_report, item_reports)` contract.

Migration Steps

  1. 1
    If using Xet functionality, migrate all code from the function-based `hf_xet` API to the session-based `XetSession` API (ensure `hf-xet >= 1.5.0`).
  2. 2
    If using Xet token refresh or progress reporting, update logic to use `xet_connection_info_refresh_url()` and the `(group_report, item_reports)` contract, respectively.
  3. 3
    When using `hf upload` or `hf download`, prefer using the `hf://` URI format and remove reliance on separate `--repo-type` or `--revision` flags if they conflict with the URI content.

Release Summary

This release introduces secure Keyless CI/CD authentication via OIDC and enhances the CLI by supporting `hf://` URIs for uploads and downloads. It also exposes job container ports through the public jobs proxy and migrates Xet functionality to a new session-based API.

Need More Details?

View the full release notes and all changes for HuggingFace Hub v1.19.0.rc1.

View Full Changelog