Say hello to `hf`: a faster, friendlier Hugging Face CLI ✨

We are glad to announce a long-awaited quality-of-life improvement: the Hugging Face CLI has been officially renamed from huggingface-cli to hf !

Typing huggingface-cli constantly gets old fast. More importantly, the CLI’s command structure became messy as new features were added over time (upload, download, cache management, repo management, etc.). Renaming the CLI is a chance to reorganize commands into a clearer, more consistent format.

We decided not to reinvent the wheel and instead follow a well-known CLI pattern: hf <resource> <action> . This predictable grammar makes the Hugging Face CLI more ergonomic and discoverable, while also setting the stage for upcoming features.

To start playing with the new CLI, you’ll need to install the latest huggingface_hub version:

and reload your terminal session. To test the install completed successfully, run hf version :

As we can see, commands are grouped by "resource" ( hf auth , hf cache , hf repo , etc.). We also surface hf upload and hf download at the root level since they’re expected to be the most-used commands.