[CLI] Add `hf update` + drop interactive update prompt by Wauplin · Pull Request #4131 · huggingface/huggingface_hub

Wauplin · 2026-04-22T14:42:48Z

Follow-up after discussion in #3983 (comment) (also see internal slack thread)

Summary

Drop the blocking interactive Y/n auto-update prompt at CLI startup. TTY detection was catching too many non-interactive contexts (CI runners, Homebrew post-install hooks, Jupyter) and hanging automation.
Replace it with a single stderr warning that points at the new hf update command.
Add hf update (grouped under help like env/version): detects how hf was installed (brew / standalone installer / pip) and runs the right command. Hints at hf skills upgrade on success so installed agent skills stay in sync with the new command surface.
Add HF_HUB_DISABLE_UPDATE_CHECK=1 to silence the startup PyPI check entirely (offline CI, quieter shell output). The check was already a no-op on dev / pre-release versions and 24h-cached.

Breaking change

The interactive auto-update prompt is gone. Users who relied on pressing Enter to accept an upgrade will now get a warning and run hf update themselves. No flag change, no scripting breakage — the prompt only ran in TTY sessions.

Notes / decisions

Removed _prompt_autoupdate entirely rather than gating it on a new heuristic. Once the prompt is gone the leftover check is just a 24h-cached PyPI GET + one stderr line — both harmless in CI. HF_HUB_DISABLE_UPDATE_CHECK is the only opt-out; no auto-detection of CI/NONINTERACTIVE/Jupyter (no premature abstraction).
Early-return inside _check_cli_update, not the outer check_cli_update wrapper — keeps the exception-swallowing guarantee.
hf update has no flags (no --yes): the user already opted in by running it. Transformers is not updateable from hf update — the helper still exists but isn't exposed.
Registered under topic="help" next to env/version — it's installation meta, not a Hub operation.
The skill's "Commands" section is regenerated automatically from the Typer tree, so hf update shows up without touching build_skill_md. Added a single tip bullet to _SKILL_TIPS.

Note

Medium Risk
Alters CLI startup behavior and introduces a new command that shells out to platform/package-manager update commands, so failures or mis-detected install methods could impact user workflows (though core Hub operations are unchanged).

Overview
Adds a new hf update command (wired into hf via system.update + _cli_utils.run_update) that detects the CLI installation method (Homebrew/standalone installer/pip) and runs the appropriate upgrade command, then hints to refresh installed skills.

Changes the CLI startup PyPI version check to be non-interactive by removing the blocking Y/n auto-update prompt and always emitting a one-line hint (pointing at hf update for huggingface_hub), with a new HF_HUB_DISABLE_UPDATE_CHECK env var to skip the check entirely.

Updates docs and generated CLI reference to document hf update and HF_HUB_DISABLE_UPDATE_CHECK, and adds a short tip in skills docs about upgrading via hf update.

^{Reviewed by Cursor Bugbot for commit d210829. Bugbot is set up for automated code reviews on this repo. Configure here.}

- Replace the blocking Y/n auto-update prompt with a one-line stderr warning pointing to `hf upgrade` - New `hf upgrade` command (under `help` topic) that picks the right command for the detected install method (brew/hf_installer/pip) - New `HF_HUB_NO_UPDATE_CHECK` env var to silence the startup PyPI check entirely (handy for CI / quieter shells)

Surface non-zero pip/brew/installer exits via `typer.Exit` so scripts and CI can detect upgrade failures. Matches the convention in extensions.py.

cursor

Cursor Bugbot has reviewed your changes and found 2 potential issues.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 2a09347. Configure here.}

bot-ci-comment · 2026-04-22T14:58:58Z

The docs for this PR live here. All of your documentation changes will be reflected on that endpoint. The docs are available until 30 days after the last update.

Join the list[str] update_command with spaces before interpolating into the user-facing message, so it displays as a shell command rather than a Python repr like ['python', '-m', 'pip', ...]. Co-authored-by: Lucain <Wauplin@users.noreply.github.com>

Wauplin

✔️

…ace_hub into cli-upgrade-command

julien-c · 2026-04-22T16:08:57Z

Sounds reasonable.

hanouticelina

it works and looks good to me! thanks 👍

huggingface-hub-bot · 2026-04-30T11:57:53Z

This PR has been shipped as part of the v1.13.0 release.

julien-c · 2026-04-30T13:46:48Z

+    if returncode != 0:
+        raise typer.Exit(code=returncode)
+    out.hint(
+        "You may also want to run `hf skills upgrade` to refresh any installed skills "


maybe should be update for consistency

Per Julien's feedback in #4131. No backward compat alias kept.

Per Julien's feedback in #4131. No backward-compat alias kept.

cursor Bot reviewed Apr 22, 2026

View reviewed changes

Comment thread src/huggingface_hub/cli/system.py Outdated

Comment thread src/huggingface_hub/cli/_cli_utils.py Outdated

Wauplin added 5 commits April 22, 2026 16:47

[CLI] Mention hf upgrade in the installation guide

2ecd462

gint, not warning

f67c00d

HF_HUB_DISABLE_UPDATE_CHECK

be4ab97

[CLI] Propagate subprocess exit code from hf upgrade

0d26a82

Surface non-zero pip/brew/installer exits via `typer.Exit` so scripts and CI can detect upgrade failures. Matches the convention in extensions.py.

better

2a09347

cursor Bot reviewed Apr 22, 2026

View reviewed changes

Comment thread src/huggingface_hub/cli/_cli_utils.py Outdated

Comment thread src/huggingface_hub/cli/_cli_utils.py

Wauplin mentioned this pull request Apr 22, 2026

Interactive CLI autoupdate prompt #3983

Merged

Wauplin and others added 3 commits April 22, 2026 17:04

a

2360629

docstring

5eb9183

Wauplin changed the title ~~[CLI] Add hf upgrade + drop interactive update prompt~~ [CLI] Add hf update + drop interactive update prompt Apr 22, 2026

Wauplin added 3 commits April 22, 2026 17:27

hf update

699111f

update

09ed664

update

050148e

Wauplin commented Apr 22, 2026

View reviewed changes

Wauplin requested a review from hanouticelina April 22, 2026 15:30

Wauplin and others added 3 commits April 22, 2026 17:34

Merge branch 'main' into cli-upgrade-command

3b6acff

still annoyed

45a51cb

Merge branch 'cli-upgrade-command' of github.com:huggingface/huggingf…

d210829

…ace_hub into cli-upgrade-command

Merge branch 'main' into cli-upgrade-command

74016cf

hanouticelina approved these changes Apr 27, 2026

View reviewed changes

Wauplin merged commit 3017d4a into main Apr 27, 2026
10 of 20 checks passed

Wauplin deleted the cli-upgrade-command branch April 27, 2026 11:13

julien-c reviewed Apr 30, 2026

View reviewed changes

hanouticelina mentioned this pull request Apr 30, 2026

[CLI] migrate hf skills to bucket #4175

Merged

hanouticelina added a commit that referenced this pull request Apr 30, 2026

[CLI] Rename hf skills upgrade -> hf skills update

ff98607

Per Julien's feedback in #4131. No backward compat alias kept.

hanouticelina added a commit that referenced this pull request Apr 30, 2026

[CLI] Rename hf skills upgrade -> hf skills update

b2c1688

Per Julien's feedback in #4131. No backward compat alias kept.

hanouticelina added a commit that referenced this pull request Apr 30, 2026

[CLI] Rename hf skills upgrade -> hf skills update

1b02939

Per Julien's feedback in #4131. No backward compat alias kept.

hanouticelina mentioned this pull request Apr 30, 2026

[CLI] Rename hf skills upgrade -> hf skills update #4176

Merged

Wauplin pushed a commit that referenced this pull request May 4, 2026

[CLI] Rename hf skills upgrade -> hf skills update (#4176)

b3ba6b3

Per Julien's feedback in #4131. No backward-compat alias kept.

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

[CLI] Add `hf update` + drop interactive update prompt#4131

[CLI] Add `hf update` + drop interactive update prompt#4131
Wauplin merged 16 commits into
mainfrom
cli-upgrade-command

Wauplin commented Apr 22, 2026 •

edited by cursor Bot

Loading

Uh oh!

Uh oh!

Uh oh!

cursor Bot left a comment

Uh oh!

Uh oh!

Uh oh!

bot-ci-comment Bot commented Apr 22, 2026

Uh oh!

Wauplin left a comment

Uh oh!

julien-c commented Apr 22, 2026

Uh oh!

hanouticelina left a comment

Uh oh!

Uh oh!

huggingface-hub-bot Bot commented Apr 30, 2026

Uh oh!

julien-c Apr 30, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Conversation

Wauplin commented Apr 22, 2026 • edited by cursor Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Breaking change

Notes / decisions

Uh oh!

Uh oh!

Uh oh!

cursor Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

bot-ci-comment Bot commented Apr 22, 2026

Uh oh!

Wauplin left a comment

Choose a reason for hiding this comment

Uh oh!

julien-c commented Apr 22, 2026

Uh oh!

hanouticelina left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

huggingface-hub-bot Bot commented Apr 30, 2026

Uh oh!

julien-c Apr 30, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Wauplin commented Apr 22, 2026 •

edited by cursor Bot

Loading