# What changed in huggingface-hub

> 27 changes in huggingface-hub 2 from its official release notes, upgrade guides and advisories: 5 breaking, 2 new APIs and options. Each one cited. Sources checked 2026-10-20. HTML: https://unstale.sh/pypi/huggingface-hub/

To see which of these apply to a repository, run `npx @unstale/cli init` in it.

## huggingface-hub 2

### Breaking changes

- Prints one snapshot and exits by default instead of streaming until the job completes; use -f/--follow for live stats. (2.2.0) — [release notes](https://github.com/huggingface/huggingface_hub/releases/tag/v2.2.0)
- Listing a newly created empty bucket returns an empty list instead of raising FileNotFoundError. (2.2.0) — [release notes](https://github.com/huggingface/huggingface_hub/releases/tag/v2.2.0)
- Raises FileNotFoundError instead of ValueError when the checkpoint path does not exist. (2.2.0) — [release notes](https://github.com/huggingface/huggingface_hub/releases/tag/v2.2.0)
- Raises ValueError when given an empty list. (2.2.0) — [release notes](https://github.com/huggingface/huggingface_hub/releases/tag/v2.2.0)
- The CLI command was renamed from hf spaces zero-gpu-quota to hf spaces zero-gpu quota. (2.1.1) — [release notes](https://github.com/huggingface/huggingface_hub/releases/tag/v2.1.1)

### New APIs and options

- Snapshot output supports json, agent, and quiet formats, which output the raw API metrics. (2.2.0) — [release notes](https://github.com/huggingface/huggingface_hub/releases/tag/v2.2.0)
- Adds a follow parameter defaulting to False, so the method returns the current sample; pass True to stream until the job completes. (2.2.0) — [release notes](https://github.com/huggingface/huggingface_hub/releases/tag/v2.2.0)

### Performance

- Planning cache pruning no longer scales quadratically with the number of files per revision. (2.2.0) — [release notes](https://github.com/huggingface/huggingface_hub/releases/tag/v2.2.0)
- Planning cache removal no longer scales quadratically with the number of files per revision. (2.2.0) — [release notes](https://github.com/huggingface/huggingface_hub/releases/tag/v2.2.0)

### Behavior and default changes

- Warns when allow or ignore patterns match no files. (2.2.0) — [release notes](https://github.com/huggingface/huggingface_hub/releases/tag/v2.2.0)

### Tooling

- The package is now installed on Windows ARM64. (2.2.0) — [release notes](https://github.com/huggingface/huggingface_hub/releases/tag/v2.2.0)

### Fixes and other changes

- Fixes a race that could skip the first scheduled push. (2.2.0) — [release notes](https://github.com/huggingface/huggingface_hub/releases/tag/v2.2.0)
- The CLI reads the file as UTF-8 and strips the BOM. (2.2.0) — [release notes](https://github.com/huggingface/huggingface_hub/releases/tag/v2.2.0)
- On Windows, quoted glob patterns are no longer expanded into local file names before reaching the command. (2.2.0) — [release notes](https://github.com/huggingface/huggingface_hub/releases/tag/v2.2.0)
- Without -f, logs no longer hang while the job keeps printing. (2.2.0) — [release notes](https://github.com/huggingface/huggingface_hub/releases/tag/v2.2.0)
- Prints [] when no job is running. (2.2.0) — [release notes](https://github.com/huggingface/huggingface_hub/releases/tag/v2.2.0)
- No longer fails when one of the requested jobs has finished. (2.2.0) — [release notes](https://github.com/huggingface/huggingface_hub/releases/tag/v2.2.0)
- Without -f, logs no longer hang while the job keeps printing. (2.2.0) — [release notes](https://github.com/huggingface/huggingface_hub/releases/tag/v2.2.0)
- Uploads existing paths containing glob characters as-is. (2.2.0) — [release notes](https://github.com/huggingface/huggingface_hub/releases/tag/v2.2.0)
- Concurrent downloads now see the resolved version, preventing parallel downloads from incorrectly skipping Xet. (2.2.0) — [release notes](https://github.com/huggingface/huggingface_hub/releases/tag/v2.2.0)
- With refresh=True, clears cached not-found results so newly created repos, branches, or buckets are recognized. (2.2.0) — [release notes](https://github.com/huggingface/huggingface_hub/releases/tag/v2.2.0)
- Clears cached not-found results for the specified path, so newly created repos, branches, or buckets are recognized. (2.2.0) — [release notes](https://github.com/huggingface/huggingface_hub/releases/tag/v2.2.0)
- Directory listings replace cached listings rather than append, avoiding duplicates, stale deleted files, and incorrect bucket-folder listings. (2.2.0) — [release notes](https://github.com/huggingface/huggingface_hub/releases/tag/v2.2.0)
- Card validation now respects the configured endpoint. (2.2.0) — [release notes](https://github.com/huggingface/huggingface_hub/releases/tag/v2.2.0)
- Redirect handling now considers the port. (2.2.0) — [release notes](https://github.com/huggingface/huggingface_hub/releases/tag/v2.2.0)
- The CLI reads the file as UTF-8 and strips the BOM. (2.2.0) — [release notes](https://github.com/huggingface/huggingface_hub/releases/tag/v2.2.0)
- Works offline with a pinned revision. (2.2.0) — [release notes](https://github.com/huggingface/huggingface_hub/releases/tag/v2.2.0)