Below is a cheat sheet for hugging face CLI commands.
| Command | Description | Example |
|---|---|---|
huggingface-cli login |
Log in to Hugging Face account | huggingface-cli login |
huggingface-cli whoami |
Check logged in account | huggingface-cli whoami |
huggingface-cli logout |
Log out of Hugging Face account | huggingface-cli logout |
huggingface-cli download |
Download files from Hub | huggingface-cli download gpt2 config.json |
huggingface-cli download |
Download an entire repository | huggingface-cli download username/repo_name |
huggingface-cli download |
Download multiple files | huggingface-cli download gpt2 config.json model.bin |
huggingface-cli download |
Download a dataset or a Space | huggingface-cli download datasets/squad |
huggingface-cli download |
Download a specific revision | huggingface-cli download username/repo_name@main |
huggingface-cli download |
Download to a local folder | huggingface-cli download gpt2 --local-dir ./my_model |
huggingface-cli download |
Specify cache directory | huggingface-cli download gpt2 --cache-dir /path/to/cache |
huggingface-cli download |
Specify a token | huggingface-cli download gpt2 --token hf_... |
huggingface-cli download |
Quiet mode | huggingface-cli download gpt2 --quiet |
huggingface-cli download |
Download timeout | huggingface-cli download gpt2 --timeout 30 |
huggingface-cli upload |
Upload an entire folder | huggingface-cli upload my-cool-model . . |
huggingface-cli upload |
Upload a single file | huggingface-cli upload my-cool-model ./config.json . |
huggingface-cli upload |
Upload multiple files | huggingface-cli upload my-cool-model ./config.json ./model.bin . |
huggingface-cli upload |
Upload to a dataset or Space | huggingface-cli upload datasets/my-dataset ./data . |
huggingface-cli upload |
Upload to an organization | huggingface-cli upload myorg/my-model ./model . |
huggingface-cli upload |
Upload to a specific revision | huggingface-cli upload my-model@v2 ./model . |
huggingface-cli upload |
Upload and create a PR | huggingface-cli upload my-model ./model . --create-pr |
huggingface-cli upload |
Upload at regular intervals | huggingface-cli upload my-model ./model . --interval 60 |
huggingface-cli upload |
Specify a commit message | huggingface-cli upload my-model ./model . -m "Update model" |
huggingface-cli upload |
Specify a token | huggingface-cli upload my-model ./model . --token hf_... |
huggingface-cli upload |
Quiet mode | huggingface-cli upload my-model ./model . --quiet |
huggingface-cli repo-files |
Delete files | huggingface-cli repo-files username/repo_name delete file.txt |
huggingface-cli repo-files |
Specify a token | huggingface-cli repo-files username/repo_name delete file.txt --token hf_... |
huggingface-cli scan-cache |
Scan local cache | huggingface-cli scan-cache |
huggingface-cli delete-cache |
Delete items from local cache | huggingface-cli delete-cache |
huggingface-cli tag |
Tag a model | huggingface-cli tag username/model_name v1.0 |
huggingface-cli tag |
Tag a model at a specific revision | huggingface-cli tag username/model_name v1.0 --revision main |
huggingface-cli tag |
Tag a dataset or a Space | huggingface-cli tag datasets/my-dataset v1.0 |
huggingface-cli tag |
List tags | huggingface-cli tag username/model_name --list |
huggingface-cli tag |
Delete a tag | huggingface-cli tag username/model_name v1.0 --delete |
huggingface-cli env |
Print environment information | huggingface-cli env |
Provide Feedback For This Article
We take your feedback seriously and use it to improve our content. Thank you for helping us serve you better!
😊 Thanks for your time, your feedback has been registered!
Comments & Discussion
Facing issues? Have questions? Post them here! We're happy to help!