●Change8

Migrating to HuggingFace Hub v1.9.0.rc0

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

Released: 4/2/2026

2
Breaking Changes
2
Migration Steps
5
Affected Symbols

⚠️ Check Your Code

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

huggingface_hub.HfApi.set_space_volumeshuggingface_hub.create_repohuggingface_hub.duplicate_repohf CLI commands (models ls|info, datasets ls|info|parquet|sql, spaces ls|info, papers ls|search|info, auth whoami)@strict dataclass validation

Breaking Changes

●Issue #1

The deprecated persistent storage feature is replaced by the new mounted volumes feature for Hugging Face Spaces. Users relying on persistent storage must migrate to using the new Volume API or CLI flags.

●Issue #2

The minimum required Python version has been bumped from 3.9 to 3.10.

Migration Steps

  1. 1
    If using persistent storage in Spaces, migrate configuration to use the new `Volume` API or CLI `--volume` / `-v` flags.
  2. 2
    Ensure your Python environment is running Python 3.10 or newer.

Release Summary

This release introduces mounted volumes for Hugging Face Spaces, replacing deprecated persistent storage, and significantly enhances the CLI by adding agent-aware output formatting and support for installing marketplace skills.

Need More Details?

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

View Full Changelog