v1.14.0
Breaking Changes📦 huggingface-hubView on GitHub →
⚠ 1 breaking✨ 6 features🐛 4 fixes🔧 11 symbols
Summary
This release introduces comprehensive CLI management for Space secrets and environment variables, alongside rsync-style trailing slash support for bucket folder copies. Several CLI command updates and bug fixes were also implemented, including renaming `hf skills upgrade` to `hf skills update`.
⚠️ Breaking Changes
- The CLI command `hf skills upgrade` has been renamed to `hf skills update`. Users must switch to using `hf skills update`.
Migration Steps
- Replace usage of `hf skills upgrade` with `hf skills update` in CLI scripts.
✨ New Features
- Introduced new `hf spaces secrets` subgroup for managing write-only Space secrets via CLI (add, list, delete).
- Introduced new `hf spaces variables` subgroup for managing readable Space environment variables via CLI (add, list, delete).
- CLI secret/variable addition commands now support multiple `-s`/`-e` flags and loading from dotenv files using `--secrets-file`/`-env-file`.
- Python API `HfApi.get_space_secrets()` now returns secret metadata (key, description, timestamp) without revealing secret values.
- `hf buckets cp` now supports rsync-style trailing slash semantics for folder copies: trailing slash copies contents, omitting it nests the source folder.
- CLI shortcut added: `hf -v` now prints the version.
🐛 Bug Fixes
- When copying files using `hf buckets cp`, `copy_files` now raises an explicit `EntryNotFoundError` if the source path resolves to no files, instead of silently succeeding.
- Progress bars are removed from `hf skills update` command output.
- Default limit for list commands in CLI increased from 10 to 30.
- Status updates (spinners/progress) on `hf extensions install` and `hf spaces dev-mode` are suppressed when using `--format json`, `--quiet`, or `--format agent`.