hf buckets list filters by name
Introduced 2026-04-24 · score 0.97
HOW TO USE IT
When maintaining or debugging a workflow that stores checkpoints in buckets, pass `--search "checkpoint"` to `hf buckets list` to filter bucket names. The search string is optional; the CLI docs describe it as a search query.
hf buckets list --search "checkpoint"from huggingface_hub import list_buckets
for bucket in list_buckets(search="checkpoint"):
print(bucket.id)WHY THIS HELPS
Find buckets by name while maintaining or debugging a repository workflow that stores checkpoints in buckets.
BEFORE THIS CHANGE
List the buckets and filter them client-side.
REQUIREMENTS AND LIMITATIONS
- Version: v1.12.0
- --search TEXT: CLI search query for bucket listing.
- search: Optional string to filter bucket names in `list_buckets()`.
- Prerequisite: Python usage requires importing `list_buckets` from `huggingface_hub`.
- Search matches a name pattern.
FIRST-PARTY EVIDENCE
- https://github.com/huggingface/huggingface_hub/releases/tag/v1.12.0
- https://huggingface.co/docs/huggingface_hub/v1.20.1/en/package_reference/cli
- https://huggingface.co/docs/huggingface_hub/package_reference/hf_api
Check the installed version and the source before using it. Entry JSON