v1.7.0

This release brings major improvements to the hf CLI with extension discoverability, unified list commands, and multiple QoL improvements in the CLI.

🎉 The Homebrew formula of the Hugging Face CLI has been renamed to hf. Existing users just need to run brew update - Homebrew handles the rename automatically. New users can install with brew install hf.

🧩 CLI Extensions: pip-installable packages and discoverability

The hf CLI extensions system gets a major upgrade in this release. Extensions can now be full Python packages (with a pyproject.toml) installed in isolated virtual environments, in addition to the existing shell script approach. This means extension authors can use Python dependencies without conflicting with the user's system. The install command auto-detects whether a GitHub repo is a script or a Python package and handles both transparently.

A new hf extensions search command lets users discover available extensions directly from the terminal by querying GitHub repositories tagged with the hf-extension topic. Results are sorted by stars and show whether each extension is already installed locally. Additionally, a comprehensive guide on how to build, publish, and make extensions discoverable has been added to the documentation.

# Install a Python-based extension
hf extensions install alvarobartt/hf-mem

# Discover available extensions
hf extensions search
NAME   REPO                    STARS DESCRIPTION                         INSTALLED
------ ----------------------- ----- ----------------------------------- ---------
claude hanouticelina/hf-claude     2 Extension for `hf` CLI to launch... yes
agents hanouticelina/hf-agents       HF extension to run local coding...

[CLI] Add pip installable repos support to hf extensions by @Wauplin in #3892
[CLI] Add hf extensions search command by @julien-c in #3905
[Docs] How to build a CLI extension guide by @Wauplin in #3908

📚 Documentation: Create a CLI extension

🔐 `hf auth login` CLI update

A new --force flag lets you explicitly go through the full login flow again when needed, for example to switch tokens.

# Already logged in — returns immediately
hf auth login

# Force re-login to switch tokens
hf auth login --force

Default to skipping login if already logged in and add --force flag by @hanouticelina in #3920

📚 Documentation: CLI guide

📦 Xet optimizations and fixes

hf-xet has been bumped to v1.4.2 with some optimizations:

Avoid duplicate sha256 computation when uploading to a model/dataset repo
Skip sha256 computation when uploading to a bucket This should greatly improve upload speed of large files.

The hf-xet bump also comes with a fix for deadlocks / stall on large file downloads.

See hf-xet release notes for more details.

feat: pass pre-computed SHA-256 to hf_xet upload by @XciD in #3876
feat: pass skip_sha256=True to hf_xet for bucket uploads by @Wauplin in #3900

🖥️ CLI QoL Improvements

Add num_parameters filtering to hf API and CLI by @evalstate in #3897 — docs
[CLI] Normalize all list/ls commands to use list | ls alias by @julien-c in #3901
[CLI] Add --format and --quiet options to hf papers ls by @julien-c in #3903
[CLI] Add hidden --json shorthand for --format json by @Wauplin in #3919
Allow 'hf skills add' default directory by @Wauplin in #3923

🔧 Other QoL Improvements

Add used_storage field to ModelInfo, DatasetInfo, and SpaceInfo by @julien-c in #3911
Make sure all expand attributes are official ModelInfo/DatasetInfo/SpaceInfo by @Wauplin in #3918

📖 Documentation

[Docs] Update some community CLI examples by @Wauplin in #3899
[Docs] Update Homebrew install command to hf by @julien-c in #3902

🐛 Bug and typo fixes

snapshot_download operation raises the generic exception even when actual error is different. by @pavankumarch470 in #3914

🏗️ Internal

[Internal] Don't trigger Skills sync workflow on release candidate by @hanouticelina in #3893
[Internal] Fix skills path in Skills sync workflow by @hanouticelina in #3894
[CI] All-in-one Github Action for releases by @Wauplin in #3916