Implement new hf
CLI to replace huggingface-cli
with modern syntax
#3225
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
This PR implements a new
hf
CLI tool to replace the existinghuggingface-cli
with a more modern and consistent syntax, similar to the GitHub CLI. The new CLI maintains 100% backward compatibility while providing a cleaner interface.New CLI Structure
The new
hf
CLI organizes commands into logical groups:Implementation Details
src/huggingface_hub/cli/
with modular command structurehf=huggingface_hub.cli.hf_cli:main
tosetup.py
huggingface-cli
commands continue to work unchangedlfs-enable-largefiles
andupload-large-folder
Examples
Before (old CLI)
huggingface-cli login --token=hf_*** huggingface-cli download gpt2 config.json huggingface-cli scan-cache huggingface-cli tag create my-model v1.0
After (new CLI)
hf auth login --token=hf_*** hf files download gpt2 config.json hf cache scan hf repo tag create my-model v1.0
Testing
Migration Path
Users can gradually migrate to the new CLI at their own pace:
Fixes #3224.
💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.