Hugging Face's CLI just got a radical, Docker-inspired redesign

The huggingface-cli is dead. Long live hf. Hugging Face has completely overhauled its command-line tool, slashing verbosity and adopting a predictable grammar that feels instantly familiar if you’ve used Docker or GitHub’s CLI. This isn’t just a cosmetic rename; it’s a structural reorganization designed to tame the messy sprawl of commands that accumulated as the platform expanded from model hosting to a full-stack infrastructure provider.

The new pattern is simple: hf <resource> <action>. Instead of huggingface-cli whoami, you now run hf auth whoami. Authentication, cache management, and repo operations are all grouped under logical parent commands. The most-used actions, upload and download, remain at the root level for quick access. The legacy huggingface-cli still works but throws a deprecation warning, giving teams time to migrate their scripts and muscle memory.

The real news, however, is the debut of hf jobs. This command is a client for Hugging Face Jobs, a new pay-as-you-go compute service that lets you run any script or Docker image on-demand. The syntax borrows heavily from Docker: hf jobs run, hf jobs ps, hf jobs logs, and hf jobs cancel all behave exactly as you’d expect. You can fire off an nvidia-smi command on an A10G GPU with a single line and pay only for the seconds you use. It’s a clear signal that Hugging Face intends to compete not just for model hosting but for the ephemeral compute workloads that power fine-tuning and inference.