●Change8

Migrating to HuggingFace Hub v1.13.0

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

Released: 4/30/2026

2
Breaking Changes
3
Migration Steps
17
Affected Symbols

⚠️ Check Your Code

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

hf models cardhf datasets cardhf spaces cardhf models lshf datasets lshf spaces lshf datasets leaderboardhf spaces pausehf spaces restarthf spaces settingshf spaces hardwarehf updateparse_hf_uriHfUriparse_hf_mountHfMounthf_hub_download

Breaking Changes

●Issue #1

The blocking interactive Y/n auto-update prompt at CLI startup has been removed. Automation relying on this prompt will now hang unless the new `hf update` command is used or `HF_HUB_DISABLE_UPDATE_CHECK=1` is set.

●Issue #2

The old method for uploading local scripts to Jobs using base64 encoding in an environment variable has been removed. Jobs scripts are now transported via bucket/mount, requiring jobs to read scripts from `/data/` inside the container.

Migration Steps

  1. 1
    If relying on the startup auto-update prompt for automation, switch to calling `hf update` explicitly or set the environment variable `HF_HUB_DISABLE_UPDATE_CHECK=1`.
  2. 2
    If using Jobs script uploads, ensure scripts are read from `/data/` within the job container, as the old base64 environment variable transport is removed.
  3. 3
    If you were using per-command formatting flags like `--format` or `--json`, these are now global and should work on all commands automatically.

Release Summary

This release significantly enhances the CLI with new commands for repository exploration, Space management, and global output formatting. It also centralizes URI parsing logic and replaces the blocking auto-update prompt with an explicit `hf update` command.

Need More Details?

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

View Full Changelog