●Change8

Migrating to HuggingFace Hub v1.3.0.rc0

Version v1.3.0.rc0 introduces 1 breaking change. This guide details how to update your code.

Released: 1/8/2026

1
Breaking Changes
2
Migration Steps
10
Affected Symbols

⚠️ Check Your Code

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

list_modelslist_datasetslist_spacesHfApi.fetch_jobs_metricshf modelshf datasetshf spaceshf repo infohf jobs statsdataclass_with_extra

Breaking Changes

●Issue #1

The `direction` parameter in `list_models`, `list_datasets`, and `list_spaces` is now deprecated and ignored. Sorting is always descending.

Migration Steps

  1. 1
    If you were relying on the `direction` parameter in `list_models`, `list_datasets`, or `list_spaces`, remove it from your calls, as sorting is now always descending.
  2. 2
    To install the `transformers` CLI, use the updated installer scripts with the `--with-transformers` flag if needed.

Release Summary

This release significantly reorganizes the CLI with dedicated discovery commands (`hf models`, `hf datasets`, `hf spaces`) and introduces real-time job monitoring via `hf jobs stats`. A breaking change removes the unused `direction` parameter from repository listing methods.

Need More Details?

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

View Full Changelog