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.
To dive deeper into any command group, simply append --help :
If you are used to huggingface-cli , most commands will look familiar. The biggest change affects authentication:
All auth commands have been grouped together with the existing hf auth switch (to switch between different local profiles) and hf auth list (to list local profiles).
The legacy huggingface-cli remains active and fully-functional. We’re keeping it around to ease the transition. If you use any command from the legacy CLI, you’ll see a warning that points you to the new CLI equivalent:
We couldn’t resist shipping our first dedicated command: hf jobs .
Hugging Face Jobs is a new service that lets you run any script or Docker image on Hugging Face Infrastructure using the hardware flavor of your choice. Billing is "pay-as-you-go", meaning you pay only for the seconds you use. Here’s how to launch your first command:
Hugging Face Jobs are available only to Pro users and Team or Enterprise organizations . Upgrade your plan to get started!