●Change8

v1.3.0.rc0

Breaking Changes
📦 huggingface-hubView on GitHub →
⚠ 1 breaking✨ 8 features🐛 5 fixes⚡ 1 deprecations🔧 10 symbols

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.

⚠️ Breaking Changes

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

Migration Steps

  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. To install the `transformers` CLI, use the updated installer scripts with the `--with-transformers` flag if needed.

✨ New Features

  • CLI reorganized with dedicated discovery commands: `hf models`, `hf datasets`, and `hf spaces` (e.g., `hf models ls --author=Qwen`).
  • Added support to install the `transformers` CLI alongside `huggingface_hub` CLI using installer scripts (`--with-transformers` flag).
  • New `hf jobs stats` command introduced for real-time monitoring of running jobs (CPU, memory, network, GPU usage).
  • New `HfApi.fetch_jobs_metrics()` method added for fetching job metrics programmatically.
  • Added `--expand` parameter to `hf repo info` command.
  • Support for 'x | y' syntax in strict dataclasses.
  • Implemented `http_backoff` for LFS batch/verify/completion endpoints.
  • Added support for local folders safetensors metadata.

🐛 Bug Fixes

  • Fixed unbound local error when reading corrupted metadata files.
  • Fixed CLI: `hf repo list` private argument defaulting to `None` instead of `False`.
  • Fixed `create_repo` returning the wrong `repo_id`.
  • Fixed job-related APIs to use `self.endpoint` for custom endpoint support.
  • Fixed hf-xet version mismatch.

Affected Symbols

list_modelslist_datasetslist_spacesHfApi.fetch_jobs_metricshf modelshf datasetshf spaceshf repo infohf jobs statsdataclass_with_extra

⚡ Deprecations

  • The `direction` parameter in `list_models`, `list_datasets`, and `list_spaces` is deprecated as it is no longer used.