Hugging Face

Upload Commands

Upload models, datasets, and files to Hugging Face Hub. Create repositories, manage versions with commits, and share work with the community.

6 commands

Pro Tips

Use '--commit-message' to document what changed for better version history.

Add '--private' flag when creating repos that shouldn't be publicly visible.

Use '.gitattributes' to configure Git LFS tracking for large files automatically.

Common Mistakes

Large files use Git LFS - ensure your plan supports the storage requirements.

Public uploads are immediately visible - double-check for sensitive data.

Commands

Upload folder

$ huggingface-cli upload my-org/my-model ./model-files

Upload a local folder to a Hub repository.

Upload single file

$ huggingface-cli upload my-org/my-model ./model.safetensors

Upload a single file to a repository.

Upload with commit message

$ huggingface-cli upload my-org/my-model ./checkpoint --commit-message "Add v2 checkpoint"

Upload with a descriptive commit message.

Upload dataset

$ huggingface-cli upload my-org/my-dataset ./data --repo-type dataset

Upload files to a dataset repository.

Create private repo

$ huggingface-cli upload my-org/my-model ./files --private --create-pr

Upload to a new private repository via PR.

Upload to subdirectory

$ huggingface-cli upload my-org/my-model ./ckpt --path-in-repo checkpoints/v1

Upload files to a specific path in the repo.