Hugging Face

Cache Commands

Manage the local Hugging Face cache. Scan for cached models, clean up unused files, and configure cache location for disk space optimization.

6 commands

Pro Tips

Run 'huggingface-cli scan-cache' regularly to identify large cached models.

Set HF_HOME environment variable to move cache to a larger disk.

Use '--delete-revisions' to remove specific versions while keeping latest.

Common Mistakes

Cache can grow to hundreds of GB - monitor disk usage regularly.

Deleting cache requires re-downloading if models are needed again.

Commands

Scan cache

$ huggingface-cli scan-cache

Show all cached models and their sizes.

Delete cache entries

$ huggingface-cli delete-cache

Interactively delete cached models.

Delete specific revisions

$ huggingface-cli delete-cache --delete-revisions abc123 def456

Remove specific cached revisions by hash.

Set cache directory

$ export HF_HOME=/path/to/cache

Configure custom cache location.

Disable cache

$ export HF_HUB_OFFLINE=1

Force offline mode using only cached files.

Show cache path

$ python -c "from huggingface_hub import HfFolder; print(HfFolder.cache_dir)"

Display the current cache directory path.

Hugging Face

Cache Commands

Manage the local Hugging Face cache. Scan for cached models, clean up unused files, and configure cache location for disk space optimization.

6 commands

Pro Tips

Run 'huggingface-cli scan-cache' regularly to identify large cached models.

Set HF_HOME environment variable to move cache to a larger disk.

Use '--delete-revisions' to remove specific versions while keeping latest.

Common Mistakes

Cache can grow to hundreds of GB - monitor disk usage regularly.

Deleting cache requires re-downloading if models are needed again.

Commands

Scan cache

$ huggingface-cli scan-cache

Show all cached models and their sizes.

Delete cache entries

$ huggingface-cli delete-cache

Interactively delete cached models.

Delete specific revisions

$ huggingface-cli delete-cache --delete-revisions abc123 def456

Remove specific cached revisions by hash.

Set cache directory

$ export HF_HOME=/path/to/cache

Configure custom cache location.

Disable cache

$ export HF_HUB_OFFLINE=1

Force offline mode using only cached files.

Show cache path

$ python -c "from huggingface_hub import HfFolder; print(HfFolder.cache_dir)"

Display the current cache directory path.