Sourced from huggingface-hub's releases.

v1.0: Building for the Next Decade

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.

... (truncated)

• cd57d24 Release: v1.0.0
• e5532d9 [Inference Docs] Update supported inference providers table (#3482)
• 17101d6 mention two other breaking changes in migration guide (#3473)
• 56ea455 Update hf-xet version, update related xet docs (#3475)
• 39ebbc0 add support for platform.machine()=="ARM64" (#3465)
• d15ae13 [internal] Remove lfs multipart test (#3471)
• ef2f8b6 add list_organization_followers helper for /api/organizations/{org}/followers...
• b8bb902 Fix ty in CI (#3470)
• 52c718a V1.0 release (#3464)
• 61bc87e backward compatible cli tracking (v0.x) (#3460)
• Additional commits viewable in compare view

You can trigger Dependabot actions by commenting on this PR:

• @dependabot rebase will rebase this PR
• @dependabot recreate will recreate this PR, overwriting any edits that have been made to it
• @dependabot merge will merge this PR after your CI passes on it
• @dependabot squash and merge will squash and merge this PR after your CI passes on it
• @dependabot cancel merge will cancel a previously requested merge and block automerging
• @dependabot reopen will reopen this PR if it is closed
• @dependabot close will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually
• @dependabot show <dependency name> ignore conditions will show all of the ignore conditions of the specified dependency
• @dependabot ignore this major version will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this minor version will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this dependency will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)