chore(deps): update dependency huggingface-hub to v1 #95

konflux-internal-p02 · 2025-10-27T16:19:36Z

This PR contains the following updates:

Package	Change	Age	Confidence
huggingface-hub	`==0.29.0` -> `==1.2.3`

Release Notes

huggingface/huggingface_hub (huggingface-hub)

`v1.2.3`: [v1.2.3] Fix `private` default value in CLI

Compare Source

Patch release for #3618 by @Wauplin.

When creating a new repo, we should default to private=None instead of private=False. This is already the case when using the API but not when using the CLI. This is a bug likely introduced when switching to Typer. When defaulting to None, the repo visibility will default to False except if the organization has configured repos to be "private by default" (the check happens server-side, so it shouldn't be hardcoded client-side).

Full Changelog: huggingface/huggingface_hub@v1.2.2...v1.2.3

`v1.2.2`: [v1.2.2] Fix unbound local error in local folder metadata + fix `hf auth list` logs

Compare Source

Fix unbound local error when reading corrupted metadata files by @Wauplin in #3610
Fix auth_list not showing HF_TOKEN message when no stored tokens exist by @hanouticelina in #3608

Full Changelog: huggingface/huggingface_hub@v1.2.1...v1.2.2

`v1.2.1`

Compare Source

`v1.2.0`: v1.2.1: Smarter Rate Limit Handling, Daily Papers API and more QoL improvements!

Compare Source

🚦 Smarter Rate Limit Handling

We've improved how the huggingface_hub library handles rate limits from the Hub. When you hit a rate limit, you'll now see clear, actionable error messages telling you exactly how long to wait and how many requests you have left.

HfHubHTTPError: 429 Too Many Requests for url: https://huggingface.co/api/models/username/reponame.
Retry after 55 seconds (0/2500 requests remaining in current 300s window).

When a 429 error occurs, the SDK automatically parses the RateLimit header to extract the exact number of seconds until the rate limit resets, then waits precisely that duration before retrying. This applies to file downloads (i.e. Resolvers), uploads, and paginated Hub API calls (list_models, list_datasets, list_spaces, etc.).

More info about Hub rate limits in the docs 👉 here.

Parse rate limit headers for better 429 error messages by @hanouticelina in #3570

Use rate limit headers for smarter retry in http backoff by @hanouticelina in #3577

Harmonize retry behavior for metadata fetch and HfFileSystem by @hanouticelina in #3583

Add retry for preupload endpoint by @hanouticelina in #3588

Use default retry values in pagination by @hanouticelina in #3587

✨ HF API

Daily Papers endpoint: You can now programmatically access Hugging Face's daily papers feed. You can filter by week, month, or submitter, and sort by publication date or trending.

from huggingface_hub import list_daily_papers

for paper in list_daily_papers(date="2025-12-03"):
    print(paper.title)

### DeepSeek-V3.2: Pushing the Frontier of Open Large Language Models
### ToolOrchestra: Elevating Intelligence via Efficient Model and Tool Orchestration

### MultiShotMaster: A Controllable Multi-Shot Video Generation Framework
### Deep Research: A Systematic Survey

### MG-Nav: Dual-Scale Visual Navigation via Sparse Spatial Memory
...

Add daily papers endpoint by @BastienGimbert in #3502
Add more parameters to daily papers by @Samoed in #3585

Offline mode helper: we recommend using huggingface_hub.is_offline_mode() to check whether offline mode is enabled instead of checking HF_HUB_OFFLINE directly.

Add offline_mode helper by @Wauplin in #3593
Rename utility to is_offline_mode by @Wauplin #3598

Inference Endpoints: You can now configure scaling metrics and thresholds when deploying endpoints.

feat(endpoints): scaling metric and threshold by @oOraph in #3525

Exposed utilities: RepoFile and RepoFolder are now available at the root level for easier imports.

Expose RepoFile and RepoFolder at root level by @Wauplin in #3564

⚡️ Inference Providers

OVHcloud AI Endpoints was added as an official Inference Provider in v1.1.5. OVHcloud provides European-hosted, GDPR-compliant model serving for your AI applications.

import os
from huggingface_hub import InferenceClient

client = InferenceClient(
    api_key=os.environ["HF_TOKEN"],
)

completion = client.chat.completions.create(
    model="openai/gpt-oss-20b:ovhcloud",
    messages=[
        {
            "role": "user",
            "content": "What is the capital of France?"
        }
    ],
)

print(completion.choices[0].message)

Add OVHcloud AI Endpoints as an Inference Provider by @eliasto in #3541

We also added support for automatic speech recognition (ASR) with Replicate, so you can now transcribe audio files easily.

import os
from huggingface_hub import InferenceClient

client = InferenceClient(
    provider="replicate",
    api_key=os.environ["HF_TOKEN"],
)

output = client.automatic_speech_recognition("sample1.flac", model="openai/whisper-large-v3")

[Inference Providers] Add support for ASR with Replicate by @hanouticelina in #3538

The truncation_direction parameter in InferenceClient.feature_extraction ( (and its async counterpart) now uses lowercase values ("left"/"right" instead of "Left"/"Right") for consistency with other specs. The Async counterpart has been updated as well

[Inference] Use lowercase left/right truncation direction parameter by @Wauplin in #3548

📁 HfFileSystem

HfFileSystem: A new top-level hffs alias make working with the filesystem interface more convenient.

>>> from huggingface_hub import hffs
>>> with hffs.open("datasets/fka/awesome-chatgpt-prompts/prompts.csv", "r") as f:
...     print(f.readline())
"act","prompt"
"An Ethereum Developer","Imagine you are an experienced Ethereum developer tasked..."

[HfFileSystem] Add top level hffs by @lhoestq in #3556
[HfFileSystem] Add expand_info arg by @lhoestq in #3575

💔 Breaking Change

Paginated results when listing user access requests: list_pending_access_requests, list_accepted_access_requests, and list_rejected_access_requests now return an iterator instead of a list. This allows lazy loading of results for repositories with a large number of access requests. If you need a list, wrap the call with list(...).

Paginated results in list_user_access by @Wauplin in #3535

🔧 Other QoL Improvements

Better default for num_workers by @Qubitium in #3532
Avoid redundant call to the Xet connection info URL by @Wauplin in #3534
Pass through additional arguments from HfApi download utils by @schmrlng in #3531
Add optional cache to whoami by @Wauplin in #3568
Enhance repo_type_and_id_from_hf_id by @pulltheflower in #3507
Warn on server warning 'X-HF-Warning' by @Wauplin in #3589
Just print server warning without hardcoded client-side addition by @Wauplin in #3592
Decrease number of files before falling back to list_repo_tree in snapshot_download by @hanouticelina in #3565

📖 Documentation

[Docs] Update CLI installation guide by @hanouticelina in #3536
Fix: correct hf login example to hf auth login by @alisheryeginbay in #3590

🛠️ Small fixes and maintenance

🐛 Bug and typo fixes

[Inference] Fix zero shot classification output parsing by @hanouticelina in #3561
Fix FileNotFoundError in CLI update check by @hanouticelina in #3574
Fix HfHubHTTPError reduce error by adding factory function by @owenowenisme in #3579
Make 'name' optional in catalog deploy by @Wauplin in #3529
Do not use rich in tiny-agents CLI by @Wauplin in #3573
use constants.HF_HUB_ETAG_TIMEOUT as timeout for get_hf_file_metadata by @krrome in #3595

🏗️ Internal

Add huggingface_hub as dependency for hf by @Wauplin in #3527
Prepare for 1.2 release by @hanouticelina in #3528
[Internal] Fix CI by @hanouticelina in #3544
Fix test_list_spaces_linked in CI by @Wauplin in #3549
Fix minor things in CI by @Wauplin in #3558
[Internal] Fix quality by @hanouticelina in #3572
Fix quality by @hanouticelina in #3584

Significant community contributions

The following contributors have made significant changes to the library over the last release:

@schmrlng
- Pass through additional arguments from HfApi download utils (#3531)
@eliasto
- Add OVHcloud AI Endpoints as an Inference Provder (#3541)
@Boulaouaney
- Add uv support to installation scripts for faster package installation (#3486)
@pulltheflower
- Enhance repo_type_and_id_from_hf_id of hf_api (#3507)
@owenowenisme
- Fix HfHubHTTPError reduce error by adding factory function (#3579)
@BastienGimbert
- Add daily papers endpoint (#3502)
@Samoed
- Add more parameters to daily papers (#3585)

`v1.1.7`: [v1.1.7] Make `hffs` accessible at root-level

Compare Source

[HfFileSystem] Add top level hffs by @lhoestq #3556.

Example:

>>> from huggingface_hub import hffs
>>> with hffs.open("datasets/fka/awesome-chatgpt-prompts/prompts.csv", "r") as f:
...     print(f.readline())
...     print(f.readline())
"act","prompt"
"An Ethereum Developer","Imagine you are an experienced Ethereum developer tasked..."

Full Changelog: huggingface/huggingface_hub@v1.1.6...v1.1.7

`v1.1.6`: [v1.1.6] Fix incomplete file listing in `snapshot_download` + other bugfixes

Compare Source

This release includes multiple bug fixes:

decrease number of files before falling back to list_repo_tree in snapshot_download #3565 by @hanouticelina
Fix HfHubHTTPError reduce error by adding factory function #3579 by @owenowenisme
Fix FileNotFoundError in CLI update check #3574 by @hanouticelina
Do not use rich in tiny-agents CLI #3573 by @Wauplin

Full Changelog: huggingface/huggingface_hub@v1.1.5...v1.1.6

`v1.1.5`: [v1.1.5] Welcoming OVHcloud AI Endpoints as a new Inference Provider & More

Compare Source

⚡️ New Inference Provider: OVHcloud AI Endpoints

OVHcloud AI Endpoints is now an official Inference Provider on Hugging Face! 🎉
OVHcloud delivers fast, production ready inference on secure, sovereign, fully 🇪🇺 European infrastructure - combining advanced features with competitive pricing.

import os
from huggingface_hub import InferenceClient

client = InferenceClient(
    api_key=os.environ["HF_TOKEN"],
)

completion = client.chat.completions.create(
    model="openai/gpt-oss-20b:ovhcloud",
    messages=[
        {
            "role": "user",
            "content": "What is the capital of France?"
        }
    ],
)

print(completion.choices[0].message)

More snippets examples in the provider documentation 👉 here.

Add OVHcloud AI Endpoints as an Inference Provder in #3541 by @eliasto

QoL Improvements

Installing the CLI is now much faster, thanks to @Boulaouaney for adding support for uv, bringing faster package installation.

Add uv support to installation scripts for faster package installation in #3486 by @Boulaouaney

Bug Fixes

This release also includes the following bug fixes:

[Collections] Add collections to collections by slug id in #3551 by @hanouticelina
[CLI] Respect HF_DEBUG environment variable in #3562 by @hanouticelina
[Inference] fix zero shot classification output parsing in #3561 by @hanouticelina

`v1.1.4`: [v1.1.4] Paginated results in list_user_access

Compare Source

Paginated results in list_user_access by @Wauplin in #3535
⚠️ This patch release is a breaking chance but necessary to reflect API update made server-side.

Full Changelog: huggingface/huggingface_hub@v1.1.3...v1.1.4

`v1.1.3`: [v1.1.3] Avoid HTTP 429 on downloads + fix missing arguments in download API

Compare Source

Make 'name' optional in catalog deploy by @Wauplin in #3529
Pass through additional arguments from HfApi download utils by @schmrlng in #3531
Avoid redundant call to the Xet connection info URL by @Wauplin in #3534
- => this PR fixes HTTP 429 rate limit issues happening when downloading a very large dataset of small files

Full Changelog: huggingface/huggingface_hub@v1.1.0...v1.1.3

🚀 Optimized Download Experience

⚡ This release significantly improves the file download experience by making it faster and cleaning up the terminal output.

snapshot_download is now always multi-threaded, leading to significant performance gains. We removed a previous limitation, as Xet's internal resource management ensures we can parallelize downloads safely without resource contention. A sample benchmark showed this made the download much faster!

Additionally, the output for snapshot_download and hf download CLI is now much less verbose. Per file logs are hidden by default, and all individual progress bars are combined into a single progress bar, resulting in a much cleaner output.

Multi-threaded snapshot download by @Wauplin in #3522
Compact output in snapshot_download and hf download by @Wauplin in #3523

Inference Providers

🆕 WaveSpeedAI is now an official Inference Provider on Hugging Face! 🎉 WaveSpeedAI provides fast, scalable, and cost-effective model serving for creative AI applications, supporting text-to-image, image-to-image, text-to-video, and image-to-video tasks. 🎨

import os
from huggingface_hub import InferenceClient

client = InferenceClient(
    provider="wavespeed",
    api_key=os.environ["HF_TOKEN"],
)

video = client.text_to_video(
    "A cat riding a bike",
    model="Wan-AI/Wan2.2-TI2V-5B",
)

More snippets examples in the provider documentation 👉 here.

We also added support for image-segmentation task for fal, enabling state-of-the-art background removal with RMBG v2.0.

import os
from huggingface_hub import InferenceClient

client = InferenceClient(
    provider="fal-ai",
    api_key=os.environ["HF_TOKEN"],
)

output = client.image_segmentation("cats.jpg", model="briaai/RMBG-2.0")

[inference provider] Add wavespeed.ai as an inference provider by @arabot777 in #3474
[Inference Providers] implement image-segmentation for fal by @hanouticelina in #3521

🦾 CLI continues to get even better!

Following the complete revamp of the Hugging Face CLI in v1.0, this release builds on that foundation by adding powerful new features and improving accessibility.

New `hf` PyPI Package

To make the CLI even easier to access, we've published a new, minimal PyPI package: hf. This package installs the hf CLI tool and It's perfect for quick, isolated execution with modern tools like uvx.

### Run the CLI without installing it
> uvx hf auth whoami

⚠️ Note: This package is for the CLI only. Attempting to import hf in a Python script will correctly raise an ImportError.

A big thank you to @thorwhalen for generously transferring the hf package name to us on PyPI. This will make the CLI much more accessible for all Hugging Face users. 🤗

Upload hf CLI to PyPI by @Wauplin in #3511

Manage Inference Endpoints

A new command group, hf endpoints, has been added to deploy and manage your Inference Endpoints directly from the terminal.

This provides "one-liners" for deploying, deleting, updating, and monitoring endpoints. The CLI offers two clear paths for deployment: hf endpoints deploy for standard Hub models and hf endpoints catalog deploy for optimized Model Catalog configurations.

> hf endpoints --help
Usage: hf endpoints [OPTIONS] COMMAND [ARGS]...

  Manage Hugging Face Inference Endpoints.

Options:
  --help  Show this message and exit.

Commands:
  catalog        Interact with the Inference Endpoints catalog.
  delete         Delete an Inference Endpoint permanently.
  deploy         Deploy an Inference Endpoint from a Hub repository.
  describe       Get information about an existing endpoint.
  ls             Lists all Inference Endpoints for the given namespace.
  pause          Pause an Inference Endpoint.
  resume         Resume an Inference Endpoint.
  scale-to-zero  Scale an Inference Endpoint to zero.
  update         Update an existing endpoint.

[CLI] Add Inference Endpoints Commands by @hanouticelina in #3428

Verify Cache Integrity

A new command, hf cache verify, has been added to check your cached files against their checksums on the Hub. This is a great tool to ensure your local cache is not corrupted and is in sync with the remote repository.

> hf cache verify --help
Usage: hf cache verify [OPTIONS] REPO_ID

  Verify checksums for a single repo revision from cache or a local directory.

  Examples:
  - Verify main revision in cache: `hf cache verify gpt2`
  - Verify specific revision: `hf cache verify gpt2 --revision refs/pr/1`
  - Verify dataset: `hf cache verify karpathy/fineweb-edu-100b-shuffle --repo-type dataset`
  - Verify local dir: `hf cache verify deepseek-ai/DeepSeek-OCR --local-dir /path/to/repo`

Arguments:
  REPO_ID  The ID of the repo (e.g. `username/repo-name`).  [required]

Options:
  --repo-type [model|dataset|space]
                                  The type of repository (model, dataset, or
                                  space).  [default: model]
  --revision TEXT                 Git revision id which can be a branch name,
                                  a tag, or a commit hash.
  --cache-dir TEXT                Cache directory to use when verifying files
                                  from cache (defaults to Hugging Face cache).
  --local-dir TEXT                If set, verify files under this directory
                                  instead of the cache.
  --fail-on-missing-files         Fail if some files exist on the remote but
                                  are missing locally.
  --fail-on-extra-files           Fail if some files exist locally but are not
                                  present on the remote revision.
  --token TEXT                    A User Access Token generated from
                                  https://huggingface.co/settings/tokens.
  --help                          Show this message and exit.

[CLI] Add hf cache verify by @hanouticelina in #3461

Cache Sorting and Limiting

Managing your local cache is now easier. The hf cache ls command has been enhanced with two new options:

--sort: Sort your cache by accessed, modified, name, or size. You can also specify order (e.g., modified:asc to find the oldest files).
--limit: Get just the top N results after sorting (e.g., --limit 10).

### List top 10 most recently accessed repos
> hf cache ls --sort accessed --limit 10

### Find the 5 largest repos you haven't used in over a year
> hf cache ls --filter "accessed>1y" --sort size --limit 5

Add sort and limit parameters in hf cache ls by @Wauplin in #3510

Finally, we've patched the CLI installer script to fix a bug for zsh users. The installer now works correctly across all common shells.

Use hf installer with bash by @Wauplin in #3498
make installer work for zsh by @hanouticelina in #3513

🔧 Other

We've fixed a bug in HfFileSystem where the instance cache would break when using multiprocessing with the "fork" start method.

[HfFileSystem] improve cache for multiprocessing fork and multithreading by @lhoestq in #3500

🌍 Documentation

Thanks to @BastienGimbert for translating the README to French 🇫🇷 🤗

i18n: add French README translation by @BastienGimbert in #3490

and Thanks to @didier-durand for fixing multiple language typos in the library! 🤗

[Doc]: fix various typos in different files by @didier-durand in #3499
[Doc]: fix various typos in different files by @didier-durand in #3509
[Doc]: fix various typos in different files by @didier-durand in #3514
[Doc]: fix various typos in different files by @didier-durand in #3517
[Doc]: fix various typos in different files by @didier-durand in #3497

🛠️ Small fixes and maintenance

🐛 Bug and typo fixes

Close HTTP sessions on fork by @Wauplin in #3508
Fix some outdated docs by @Wauplin in #3495

🏗️ internal

Remove aiohttp dependency by @Wauplin in #3488
Prepare for 1.1.0 by @Wauplin in #3489
Fix type annotations in inference codegen by @Wauplin in #3496
Add CI + official support for Python 3.14 by @Wauplin in #3483
[Internal] Fix quality issue generated from update-inference-types workflow by @hanouticelina in #3516

Significant community contributions

The following contributors have made significant changes to the library over the last release:

@arabot777
- [inference provider] Add wavespeed.ai as an inference provider (#3474)
@BastienGimbert
- i18n: add French README translation (#3490)
@didier-durand
- [Doc]: fix various typos in different files (#3497)
- [Doc]: fix various typos in different files (#3499)
- [Doc]: fix various typos in different files (#3509)
- [Doc]: fix various typos in different files (#3514)
- [Doc]: fix various typos in different files (#3517)

`v1.0.1`: [v1.0.1] Remove `aiohttp` from extra dependencies

Compare Source

In huggingface_hub v1.0 release, we've removed our dependency on aiohttp to replace it with httpx but we forgot to remove it from the huggingface_hub[inference] extra dependencies in setup.py. This patch release removes it, making the inference extra removed as well.

The internal method _import_aiohttp being unused, it has been removed as well.

Remove aiohttp dependency by @Wauplin in #3488

Full Changelog: huggingface/huggingface_hub@v1.0.0...v1.0.1

`v1.0.0`: v1.0: Building for the Next Decade

Compare Source

Check out our blog post announcement!

🚀 HTTPx migration

The huggingface_hub library now uses httpx instead of requests for HTTP requests. This change was made to improve performance and to support both synchronous and asynchronous requests the same way. We therefore dropped both requests and aiohttp dependencies.

The get_session and hf_raise_for_status still exist and respectively returns an httpx.Client and processes a httpx.Response object. An additional get_async_client utility has been added for async logic.

The exhaustive list of breaking changes can be found here.

[1.0] Httpx migration by @Wauplin in #3328
Fix async client hook by @Wauplin in #3433
Fix hf_raise_for_status on async stream + tests by @Wauplin in #3442
[v1.0] Update "HTTP backend" docs + git_vs_http guide by @Wauplin in #3357

🪄 CLI revamp

huggingface_hub 1.0 marks a complete transformation of our command-line experience. We've reimagined the CLI from the ground up, creating a tool that feels native to modern ML workflows while maintaining the simplicity the community love.

One CLI to Rule: Goodbye `huggingface-cli`

This release marks the end of an era with the complete removal of the huggingface-cli command. The new hf command (introduced in v0.34.0) takes its place with a cleaner, more intuitive design that follows a logical "resource-action" pattern. This breaking change simplifies the user experience and aligns with modern CLI conventions - no more typing those extra 11 characters!

Remove huggingface-cli entirely in favor of hf by @Wauplin in #3404

`hf` CLI Revamp

The new CLI introduces a comprehensive set of commands for repository and file management that expose powerful HfApi functionality directly from the terminal:

> hf repo --help
Usage: hf repo [OPTIONS] COMMAND [ARGS]...

  Manage repos on the Hub.

Options:
  --help  Show this message and exit.

Commands:
  branch    Manage branches for a repo on the Hub.
  create    Create a new repo on the Hub.
  delete    Delete a repo from the Hub.
  move      Move a repository from a namespace to another namespace.
  settings  Update the settings of a repository.
  tag       Manage tags for a repo on the Hub.

A dry run mode has been added to hf download, which lets you preview exactly what will be downloaded before committing to the transfer—showing file sizes, what's already cached, and total bandwidth requirements in a clean table format:

> hf download gpt2 --dry-run   
[dry-run] Fetching 26 files: 100%|██████████████████████████████████████████████████████████| 26/26 [00:00<00:00, 50.66it/s]
[dry-run] Will download 26 files (out of 26) totalling 5.6G.
File                              Bytes to download 
--------------------------------- ----------------- 
.gitattributes                    445.0             
64-8bits.tflite                   125.2M            
64-fp16.tflite                    248.3M            
64.tflite                         495.8M            
README.md                         8.1K              
config.json                       665.0             
flax_model.msgpack                497.8M            
generation_config.json            124.0             
merges.txt                        456.3K            
model.safetensors                 548.1M            
onnx/config.json                  879.0             
onnx/decoder_model.onnx           653.7M            
onnx/decoder_model_merged.onnx    655.2M 
...

The CLI now provides intelligent shell auto-completion that suggests available commands, subcommands, options, and arguments as you type - making command discovery effortless and reducing the need to constantly check --help.

The CLI now also checks for updates in the background, ensuring you never miss important improvements or security fixes. Once every 24 hours, the CLI silently checks PyPI for newer versions and notifies you when an update is available - with personalized upgrade instructions based on your installation method.

The cache management CLI has been completely revamped with the removal of hf scan cache and hf scan delete in favor of docker-inspired commands that are more intuitive. The new hf cache ls provides rich filtering capabilities, hf cache rm enables targeted deletion, and hf cache prune cleans up detached revisions.

### List cached repos
>>> hf cache ls
ID                          SIZE     LAST_ACCESSED LAST_MODIFIED REFS        
--------------------------- -------- ------------- ------------- ----------- 
dataset/nyu-mll/glue          157.4M 2 days ago    2 days ago    main script 
model/LiquidAI/LFM2-VL-1.6B     3.2G 4 days ago    4 days ago    main        
model/microsoft/UserLM-8b      32.1G 4 days ago    4 days ago    main  

Found 3 repo(s) for a total of 5 revision(s) and 35.5G on disk.

### List cached repos with filters
>>> hf cache ls --filter "type=model" --filter "size>3G" --filter "accessed>7d"

### Output in different format
>>> hf cache ls --format json
>>> hf cache ls --revisions  # Replaces the old --verbose flag

### Cache removal
>>> hf cache rm model/meta-llama/Llama-2-70b-hf
>>> hf cache rm $(hf cache ls --filter "accessed>1y" -q)  # Remove old items

### Clean up detached revisions
hf cache prune  # Removes all unreferenced revisions

Under the hood, this transformation is powered by Typer, significantly reducing boilerplate and making the CLI easier to maintain and extend with new features.

Refactor CLI implementation using Typer by @hanouticelina in #3365
Add new HF commands by @hanouticelina in #3384
Document new HF commands by @hanouticelina in #3393
Implement dry run mode in download CLI by @Wauplin in #3407
[hf CLI] check for updates and notify user by @Wauplin in #3418
Print version only in CLI by @Wauplin (direct commit on v1.0-release)
Disable rich in CLI by @Wauplin in #3427
[CLI] Revamp hf cache by @hanouticelina in #3439
[CLI] Update cache CLI docs and migration guide by @hanouticelina in #3450

CLI Installation: Zero-Friction Setup

The new cross-platform installers simplify CLI installation by creating isolated sandboxed environments without interfering with your existing Python setup or project dependencies. The installers work seamlessly across macOS, Linux, and Windows, automatically handling dependencies and PATH configuration.

### On macOS and Linux
>>> curl -LsSf https://hf.co/cli/install.sh | sh

### On Windows
>>> powershell -ExecutionPolicy ByPass -c "irm https://hf.co/cli/install.ps1 | iex"

Finally, the [cli] extra has been removed - The CLI now ships with the core huggingface_hub package.

Add cross-platform CLI Installers by @hanouticelina in #3378
update installers paths by @hanouticelina in #3400
[CLI] Remove [cli] extra by @hanouticelina in #3451

💔 Breaking changes

The v1.0 release is a major milestone for the huggingface_hub library. It marks our commitment to API stability and the maturity of the library. We have made several improvements and breaking changes to make the library more robust and easier to use. A migration guide has been written to reduce friction as much as possible: https://huggingface.co/docs/huggingface_hub/concepts/migration.

[v1.0] feat: add migration guide for v1.0 by @google-labs-jules[bot] in #3360

We'll list all breaking changes below:

Minimum Python version is now 3.9 (instead of 3.8).
- Bump minimal version to Python3.9 by @Wauplin in #3343
HTTP backend migrated from requests to httpx. Expect some breaking changes on advances features and errors. The exhaustive list can be found here.
- [1.0] Httpx migration by @Wauplin in #3328
The deprecated huggingface-cli has been removed, hf (introduced in v0.34) replaces it with a clearer ressource-action CLI.
- Remove huggingface-cli entirely in favor of hf by @Wauplin in #3404
The [cli] extra has been removed - The CLI now ships with the core huggingface_hub package.
- [CLI] Remove [cli] extra by @hanouticelina in #3451
Long deprecated classes like HfFolder, InferenceAPI, and Repository have been removed.
- Remove HfFolder and InferenceAPI classes by @Wauplin in #3344
- [v1.0] Remove Repository class by @Wauplin in #3346
constant.hf_cache_home have been removed. Use constants.HF_HOME instead.
use_auth_token is not supported anymore. Use token instead. Previously using use_auth_token automatically redirected to token with a warning
removed get_token_permission. Became useless when fine-grained tokens arrived.
removed update_repo_visibility. Use update_repo_settings instead.
removed is_write_action is all build_hf_headers methods. Not relevant since fine-grained tokens arrived.
removed write_permission arg from login method. Not relevant anymore.
renamed login(new_session) to login(skip_if_logged_in) in login methods. Not announced but hopefully very little friction. Only some notebooks to update on the Hub (will do it once released)
removed resume_download / force_filename / local_dir_use_symlinks parameters from hf_hub_download/snapshot_download (and mixins)
removed library / language / tags / task from list_models args
upload_file/upload_folder now returns a url to the commit created on the Hub as any other method creating a commit (create_commit, delete_file, etc.)
- [v1.0] Remove more deprecated stuff by @Wauplin in #3345
require keyword arguments on login methods
- Remove _deprecate_positional_args on login methods by @Wauplin in #3349
Remove any Keras 2.x and tensorflow-related code
- [v1.0] Remove keras2 utilities by @Wauplin in #3352
- [v1.0] Remove anything tensorflow-related + deps by @Wauplin in #3354

[v1.0] Remove imports kept only for backward compatibility by @Wauplin in #3350

Removed hf_transfer support. hf_xet is now the default upload/download manager
- Remove any hf-transfer related code by @Wauplin in #3444

mention two other breaking changes in migration guide by @hanouticelina in #3473

🔧 Other

Inference Providers

Routing for Chat Completion API in Inference Providers is now done server-side. This saves 1 HTTP call + allows us to centralize logic to route requests to the correct provider. In the future, it enables use cases like choosing fastest or cheapest provider directly.

[InferenceClient] Server-side auto-routing for conversational task by @Wauplin in #3448

Also some updates in the docs:

[Inference Docs] Update supported inference providers table by @hanouticelina in #3482

@strict Typed Dict

We've added support for TypedDict to our @strict framework, which is our data validation tool for dataclasses. Typed dicts are now converted to dataclasses on-the-fly for validation, without mutating the input data. This logic is currently used by transformers to validate config files but is library-agnostic and can therefore be used by anyone. More details in this guide.

from typing import Annotated, TypedDict
from huggingface_hub.dataclasses import validate_typed_dict

def positive_int(value: int):
    if not value >= 0:
        raise ValueError(f"Value must be positive, got {value}")

class User(TypedDict):
    name: str
    age: Annotated[int, positive_int]

### Valid data
validate_typed_dict(User, {"name": "John", "age": 30})

Strict typed dict validator by @Wauplin in #3408

List organization followers

Added a HfApi.list_organization_followers endpoint to list followers of an organization, similar to the existing one for user's followers.

add list_organization_followers helper for /api/organizations/{org}/followers by @BastienGimbert in #3467

🛠️ Small fixes and maintenance

🐛 Bug and typo fixes

Add quotes for better shell compatibility by @aopstudio in #3369
update the sentence_similarity docstring by @tolgaakar in #3374
Do not retry on 429 (only on 5xx) by @Wauplin in #3377
Use git xet transfer to check if xet is enabled by @hanouticelina in #3381
[type validation] skip unresolved forward ref by @zucchini-nlp in #3376
Use all tools unless explicit allowed_tools by @Mithil467 in #3397
[Inference] Fix target size mapping for fal-ai's image-to-image by @hanouticelina in #3399
Replace pkgx install instruction with uv by @gary149 in #3420
The error message as previously displayed... by @goldnode in #3405
Make HfHubHTTPError inherit from OSError by @Wauplin in #3387
Fix proxy environment variables not used in v1.0 by [@Wauplin](https://redirect.g

Configuration

📅 Schedule: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).

🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.

♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

🔕 Ignore: Close this PR and you won't be reminded about this update again.

If you want to rebase/retry this PR, check this box

To execute skipped test pipelines write comment /ok-to-test.

Documentation

Find out how to configure dependency updates in MintMaker documentation or see all available configuration options in Renovate documentation.

Signed-off-by: konflux-internal-p02 <170854209+konflux-internal-p02[bot]@users.noreply.github.com>

chore(deps): update dependency huggingface-hub to v1

1f45ce4

Signed-off-by: konflux-internal-p02 <170854209+konflux-internal-p02[bot]@users.noreply.github.com>

konflux-internal-p02 bot requested review from leseb and terrytangyuan as code owners October 27, 2025 16:19

konflux-internal-p02 bot changed the title ~~chore(deps): update dependency huggingface-hub to v1~~ chore(deps): update dependency huggingface-hub to v1 - autoclosed Oct 27, 2025

konflux-internal-p02 bot closed this Oct 27, 2025

konflux-internal-p02 bot deleted the konflux/mintmaker/rhoai-2.24/huggingface-hub-1.x branch October 27, 2025 20:10

konflux-internal-p02 bot restored the konflux/mintmaker/rhoai-2.24/huggingface-hub-1.x branch October 27, 2025 20:17

konflux-internal-p02 bot changed the title ~~chore(deps): update dependency huggingface-hub to v1 - autoclosed~~ chore(deps): update dependency huggingface-hub to v1 Oct 27, 2025

konflux-internal-p02 bot reopened this Oct 27, 2025

konflux-internal-p02 bot changed the title ~~chore(deps): update dependency huggingface-hub to v1~~ chore(deps): update dependency huggingface-hub to v1 - autoclosed Oct 28, 2025

konflux-internal-p02 bot closed this Oct 28, 2025

konflux-internal-p02 bot deleted the konflux/mintmaker/rhoai-2.24/huggingface-hub-1.x branch October 28, 2025 00:09

konflux-internal-p02 bot changed the title ~~chore(deps): update dependency huggingface-hub to v1 - autoclosed~~ chore(deps): update dependency huggingface-hub to v1 Oct 28, 2025

konflux-internal-p02 bot restored the konflux/mintmaker/rhoai-2.24/huggingface-hub-1.x branch October 28, 2025 00:18

konflux-internal-p02 bot reopened this Oct 28, 2025

konflux-internal-p02 bot changed the title ~~chore(deps): update dependency huggingface-hub to v1~~ chore(deps): update dependency huggingface-hub to v1 - autoclosed Oct 28, 2025

konflux-internal-p02 bot closed this Oct 28, 2025

konflux-internal-p02 bot deleted the konflux/mintmaker/rhoai-2.24/huggingface-hub-1.x branch October 28, 2025 04:10

konflux-internal-p02 bot changed the title ~~chore(deps): update dependency huggingface-hub to v1 - autoclosed~~ chore(deps): update dependency huggingface-hub to v1 Oct 28, 2025

konflux-internal-p02 bot restored the konflux/mintmaker/rhoai-2.24/huggingface-hub-1.x branch October 28, 2025 04:19

konflux-internal-p02 bot reopened this Oct 28, 2025

konflux-internal-p02 bot changed the title ~~chore(deps): update dependency huggingface-hub to v1~~ chore(deps): update dependency huggingface-hub to v1 - autoclosed Oct 28, 2025

konflux-internal-p02 bot closed this Oct 28, 2025

konflux-internal-p02 bot deleted the konflux/mintmaker/rhoai-2.24/huggingface-hub-1.x branch October 28, 2025 08:09

konflux-internal-p02 bot changed the title ~~chore(deps): update dependency huggingface-hub to v1 - autoclosed~~ chore(deps): update dependency huggingface-hub to v1 Oct 28, 2025

konflux-internal-p02 bot restored the konflux/mintmaker/rhoai-2.24/huggingface-hub-1.x branch October 28, 2025 08:16

konflux-internal-p02 bot reopened this Oct 28, 2025

konflux-internal-p02 bot changed the title ~~chore(deps): update dependency huggingface-hub to v1~~ chore(deps): update dependency huggingface-hub to v1 - autoclosed Oct 28, 2025

konflux-internal-p02 bot closed this Oct 28, 2025

konflux-internal-p02 bot deleted the konflux/mintmaker/rhoai-2.24/huggingface-hub-1.x branch October 28, 2025 12:10