Add new HF commands #3384

hanouticelina · 2025-09-23T16:30:00Z

Resolves #3382.

This PR extends the hf repo CLI with new subcommands for deleting/moving repos, managing branches and repo settings directly from the command line. These commands expose existing functionality from HfApi:

hf repo delete → wraps HfApi.delete_repo.
hf repo move -> wraps HfApi.move_repo.
hf repo settings -> wraps HfApi.update_repo_settings.
hf repo branch create -> wraps HfApi.create_branch.
hf repo branch delete -> wraps HfApi.delete_branch.
this will be extented

> 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 repo to another repo.
  settings  Update the settings of a repository.
  tag       Manage tags for a repo on the Hub.

* first httpx integration * more migration * some fixes * download workflow should work * Fix repocard and error utils tests * fix hf-file-system * gix http utils tests * more fixes * fix some inference tests * fix test_file_download tests * async inference client * async code should be good * Define RemoteEntryFileNotFound explicitly (+some fixes) * fix async code quality * torch ok * fix hf_file_system * fix errors tests * mock * fix test_cli mock * fix commit scheduler * add fileno test * no more requests anywhere * fix test_file_download * tmp requests * Update src/huggingface_hub/utils/_http.py Co-authored-by: célina <[email protected]> * Update src/huggingface_hub/utils/_http.py Co-authored-by: célina <[email protected]> * Update src/huggingface_hub/hf_file_system.py Co-authored-by: célina <[email protected]> * not async * fix tests --------- Co-authored-by: célina <[email protected]>

* Bump minimal version to Python3.9 * use built-in generics * code quality * new batch * yet another btach * fix dataclass_with_extra * fix * keep Type for strict dataclasses * fix test

* Remove HfFolder * Remove InferenceAPI * more recent gradio * bump pytest * fix python 3.9? * install gradio only on python 3.10+ * fix tests * fix tests * fix

* remove constants.-hf_cache_home * remove smoothly_deprecate_use_auth_token * remove get_token_permission * remove update_repo_visibility * remove is_write_action arg * remove write_permission arg from login methods * new parameter skip_if_logged_in in login methods * Remove resume_download / force_filename parameters * Remove deprecated local_dir_use_symlinks parameter * Remove deprecated language, library, task, tags from list_models * Return commit URL in upload_file/upload_folder (previously url to file/folder on the Hub) * fix upload_file/upload_folder tests * smoothly_deprecate_legacy_arguments everywhere * code quality * fix tests * fix xet tests

* Remove Repository class + adapt docs * remove fr git_vs_http

* Remove imports kept only for backward compatibility * fix tests

… into v1.0-release

* Remove keras2 utilities * remove keras from init

* Remove anything tensorflow-related + deps * init * fix tests * fix conflicts in tests

* HTTP configuration docs * http configuration docs * refactored git_vs_http * fix import * fix docs? * Update docs/source/en/package_reference/utilities.md Co-authored-by: célina <[email protected]> --------- Co-authored-by: célina <[email protected]>

* Refactor CLI implementation using Typer (#3365) * migrate CLI to typer * (#3364) disable rich in all cases * update tests * make typer-slim a required dep * use Annotated * fix linting issues * fix tests * refactoring * update docs * use built in types * fix mypy * call whoami directly * lint * Apply suggestions from code review Co-authored-by: Lucain <[email protected]> * import Annotated from typing * Use Enums * set verbosity globally * refactor scan cache and update version docstring * centralize where Typer is defined * no need for ... * rename enum * no need for extra param name * docstring * revert * centralize arguments and options definition * add library version when initializing HfApi * add auto-completion * sort commands alphabetically * suggestions * centralize jobs params and HfApi initialization * fix --------- Co-authored-by: Lucain <[email protected]> * update docs --------- Co-authored-by: Lucain <[email protected]>

HuggingFaceDocBuilderDev · 2025-09-23T16:34:48Z

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.

Wauplin

Did a first pass. Looks good to me :)

⚠️ This PR is WIP, the list of additional new commands might be extended.

I think it's fine to merge this PR "as-is" and start others PRs for other commands (to keep tiny PRs)

src/huggingface_hub/cli/repo.py

Wauplin · 2025-09-24T11:06:38Z

src/huggingface_hub/cli/repo.py

+    xet_enabled: Annotated[
+        Optional[bool],
+        typer.Option(
+            help=" Whether the repository should be enabled for Xet Storage.",
+        ),
+    ] = None,


Unrelated to this PR but thinking we should remove this parameter in v1.0. Feels almost outdated now that almost all repos are xet-enabled

Co-authored-by: Lucain <[email protected]>

… into new-hf-commands

…hub into new-hf-commands

Wauplin

Perfect!

* [1.0] Httpx migration (#3328) * first httpx integration * more migration * some fixes * download workflow should work * Fix repocard and error utils tests * fix hf-file-system * gix http utils tests * more fixes * fix some inference tests * fix test_file_download tests * async inference client * async code should be good * Define RemoteEntryFileNotFound explicitly (+some fixes) * fix async code quality * torch ok * fix hf_file_system * fix errors tests * mock * fix test_cli mock * fix commit scheduler * add fileno test * no more requests anywhere * fix test_file_download * tmp requests * Update src/huggingface_hub/utils/_http.py Co-authored-by: célina <[email protected]> * Update src/huggingface_hub/utils/_http.py Co-authored-by: célina <[email protected]> * Update src/huggingface_hub/hf_file_system.py Co-authored-by: célina <[email protected]> * not async * fix tests --------- Co-authored-by: célina <[email protected]> * Bump minimal version to Python3.9 (#3343) * Bump minimal version to Python3.9 * use built-in generics * code quality * new batch * yet another btach * fix dataclass_with_extra * fix * keep Type for strict dataclasses * fix test * Remove `HfFolder` and `InferenceAPI` classes (#3344) * Remove HfFolder * Remove InferenceAPI * more recent gradio * bump pytest * fix python 3.9? * install gradio only on python 3.10+ * fix tests * fix tests * fix * [v1.0] Remove more deprecated stuff (#3345) * remove constants.-hf_cache_home * remove smoothly_deprecate_use_auth_token * remove get_token_permission * remove update_repo_visibility * remove is_write_action arg * remove write_permission arg from login methods * new parameter skip_if_logged_in in login methods * Remove resume_download / force_filename parameters * Remove deprecated local_dir_use_symlinks parameter * Remove deprecated language, library, task, tags from list_models * Return commit URL in upload_file/upload_folder (previously url to file/folder on the Hub) * fix upload_file/upload_folder tests * smoothly_deprecate_legacy_arguments everywhere * code quality * fix tests * fix xet tests * [v1.0] Remove `Repository` class (#3346) * Remove Repository class + adapt docs * remove fr git_vs_http * bump to 1.0.0.dev0 * Remove _deprecate_positional_args on login methods (#3349) * [v1.0] Remove imports kept only for backward compatibility (#3350) * Remove imports kept only for backward compatibility * fix tests * [v1.0] Remove keras2 utilities (#3352) * Remove keras2 utilities * remove keras from init * [v1.0] Remove anything tensorflow-related + deps (#3354) * Remove anything tensorflow-related + deps * init * fix tests * fix conflicts in tests * Release: v1.0.0.rc0 * [v1.0] Update "HTTP backend" docs + `git_vs_http` guide (#3357) * HTTP configuration docs * http configuration docs * refactored git_vs_http * fix import * fix docs? * Update docs/source/en/package_reference/utilities.md Co-authored-by: célina <[email protected]> --------- Co-authored-by: célina <[email protected]> * Refactor CLI implementation using Typer (#3372) * Refactor CLI implementation using Typer (#3365) * migrate CLI to typer * (#3364) disable rich in all cases * update tests * make typer-slim a required dep * use Annotated * fix linting issues * fix tests * refactoring * update docs * use built in types * fix mypy * call whoami directly * lint * Apply suggestions from code review Co-authored-by: Lucain <[email protected]> * import Annotated from typing * Use Enums * set verbosity globally * refactor scan cache and update version docstring * centralize where Typer is defined * no need for ... * rename enum * no need for extra param name * docstring * revert * centralize arguments and options definition * add library version when initializing HfApi * add auto-completion * sort commands alphabetically * suggestions * centralize jobs params and HfApi initialization * fix --------- Co-authored-by: Lucain <[email protected]> * update docs --------- Co-authored-by: Lucain <[email protected]> * add hf repo delete command * add repo settings, repo move, repo branch commands * fix test * Apply suggestions from code review Co-authored-by: Lucain <[email protected]> --------- Co-authored-by: Lucain <[email protected]> Co-authored-by: Lucain Pouget <[email protected]>

Wauplin and others added 18 commits September 10, 2025 15:29

Bump minimal version to Python3.9 (#3343)

63278df

* Bump minimal version to Python3.9 * use built-in generics * code quality * new batch * yet another btach * fix dataclass_with_extra * fix * keep Type for strict dataclasses * fix test

Remove HfFolder and InferenceAPI classes (#3344)

7213f97

* Remove HfFolder * Remove InferenceAPI * more recent gradio * bump pytest * fix python 3.9? * install gradio only on python 3.10+ * fix tests * fix tests * fix

[v1.0] Remove Repository class (#3346)

72c53f4

* Remove Repository class + adapt docs * remove fr git_vs_http

bump to 1.0.0.dev0

e56ba6e

Remove _deprecate_positional_args on login methods (#3349)

ccca22e

Merge branch 'main' into v1.0-release

98aa8ba

[v1.0] Remove imports kept only for backward compatibility (#3350)

b679858

* Remove imports kept only for backward compatibility * fix tests

Merge branch 'v1.0-release' of github.com:huggingface/huggingface_hub…

aef9df2

… into v1.0-release

[v1.0] Remove keras2 utilities (#3352)

877955d

* Remove keras2 utilities * remove keras from init

[v1.0] Remove anything tensorflow-related + deps (#3354)

9cb1955

* Remove anything tensorflow-related + deps * init * fix tests * fix conflicts in tests

Merge branch 'main' into v1.0-release

84de3c5

Release: v1.0.0.rc0

3b562ca

add hf repo delete command

6d5e24a

add repo settings, repo move, repo branch commands

0b90a3f

fix test

ebdf121

Wauplin reviewed Sep 24, 2025

View reviewed changes

hanouticelina force-pushed the v1.0-release branch from 54a7a9c to c727e9e Compare September 24, 2025 13:21

hanouticelina and others added 3 commits September 24, 2025 16:06

Apply suggestions from code review

2cbafbb

Co-authored-by: Lucain <[email protected]>

Merge branch 'v1.0-release' of github.com:huggingface/huggingface_hub…

a716d47

… into new-hf-commands

Merge branch 'new-hf-commands' of github.com:huggingface/huggingface_…

34e23af

…hub into new-hf-commands

hanouticelina marked this pull request as ready for review September 24, 2025 14:13

hanouticelina requested a review from Wauplin September 25, 2025 08:49

Wauplin approved these changes Sep 25, 2025

View reviewed changes

hanouticelina merged commit cbe0846 into v1.0-release Sep 25, 2025
19 checks passed

hanouticelina deleted the new-hf-commands branch September 25, 2025 12:05

This was referenced Sep 25, 2025

Document new HF commands #3393

Merged

[RFC] [1.0] 🚀 huggingface_hub 1.0 release checklist #3340

Open

This was referenced Oct 1, 2025

[CLI] Support branch management (create, list, delete) #1655

Closed

CLI option to manage model and dataset visibility #851

Closed

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Add new HF commands #3384

Add new HF commands #3384

Uh oh!

hanouticelina commented Sep 23, 2025 •

edited

Loading

Uh oh!

HuggingFaceDocBuilderDev commented Sep 23, 2025

Uh oh!

Wauplin left a comment

Uh oh!

Uh oh!

Uh oh!

Wauplin Sep 24, 2025

Uh oh!

Wauplin left a comment

Uh oh!

Uh oh!

Uh oh!

Add new HF commands #3384

Add new HF commands #3384

Uh oh!

Conversation

hanouticelina commented Sep 23, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

HuggingFaceDocBuilderDev commented Sep 23, 2025

Uh oh!

Wauplin left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Wauplin Sep 24, 2025

Choose a reason for hiding this comment

Uh oh!

Wauplin left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

hanouticelina commented Sep 23, 2025 •

edited

Loading