●Change8

Migrating to HuggingFace Hub v1.17.0

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

Released: 5/28/2026

2
Breaking Changes
6
Migration Steps
14
Affected Symbols

⚠️ Check Your Code

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

CommitOperationCopycopy_fileshf buckets cphf spaces sshhf repos lshf jobs pshf jobs scheduled psJobHardwareJobHardwareInfolist_jobs_hardwarelfshf_file_systemrepocard_dataurllib3

Breaking Changes

●Issue #1

The Together ASR task has been removed, which drops the dependency on urllib3.

●Issue #2

The CLI command structure for `hf jobs` has been migrated to use the `out` singleton. Specifically, `hf jobs ps` and `hf jobs scheduled ps` no longer support `--format table` or `-q`. JSON output for `hf jobs ps` now flattens `command` to a string and `status` to a stage string.

Migration Steps

  1. 1
    If you relied on the Together ASR task, you may need to find an alternative, as it has been removed.
  2. 2
    When using `hf jobs ps` or `hf jobs scheduled ps`, replace `--format table` or `-q` with `--format auto|human|agent|json|quiet` as appropriate.
  3. 3
    Review JSON output parsing for `hf jobs ps` as `command` and `status` fields have been flattened/changed.
  4. 4
    Ensure your SSH public key is registered in your HF user settings if you plan to use `hf spaces ssh`.
  5. 5
    If using CLI hardware/flavor flags, note that validation is looser; ensure you are using valid flavors if strict validation is required.
  6. 6
    Explicitly add `click` as a dependency if you were relying on it being implicitly installed via an older version of `typer`.

Release Summary

This release introduces significant CLI enhancements, including cross-repository file copying and SSH access to Spaces. It also decouples Job hardware definitions from Space hardware and improves CLI table formatting.

Need More Details?

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

View Full Changelog