huggingface/huggingface_hub v1.12.0

[v1.12.0] Unified CLI output, bucket search, and more

on GitHub

🖥️ Unified output format for hf buckets commands

All hf buckets commands now use the unified --format [auto|human|agent|json|quiet] flag and the out singleton for consistent, scriptable output. The previous --quiet and --format table|json flags have been replaced by a single --format option that works across create, list, info, delete, rm, move, and cp. Success messages use out.result(), detail views use out.dict(), and listings use out.table() with proper empty-results handling — making the buckets CLI consistent with the rest of the hf command suite.

# Quiet mode: print only bucket IDs
hf buckets list --format quiet

# JSON output for scripting
hf buckets create my-bucket --format json

# Agent-friendly structured output
hf buckets info username/my-bucket --format agent

• [CLI] Migrate buckets commands to out singleton by @hanouticelina in #4111

📚 Documentation: Buckets guide · CLI guide

🪣 Search buckets by name

You can now filter buckets by name when listing them, both from the Python API and the CLI. Pass search="checkpoint" to list_buckets() or --search "checkpoint" to hf buckets list to find buckets matching a name pattern, without having to list and filter client-side.

# Filter buckets by name
hf buckets list --search "checkpoint"

# Filter buckets by name in Python
for bucket in list_buckets(search="checkpoint"):
    print(bucket.id)

• [Buckets] Add search param to list_buckets by @alexpouliquen in #4130

📚 Documentation: Buckets guide · CLI guide

🖥️ CLI

• [CLI] spaces hot-reload: misc improvements by @cbensimon in #4049
• [CLI] Detect pi agent by @hanouticelina in #4125

🐛 Bug and typo fixes

• Apply fsspec config in HfFileSystem metaclass by @joaquinhuigomez in #4062

🔧 Other QoL Improvements

• [Buckets] Skip local walk for download sync without delete by @abidlabs in #4123
• [HfApi] Add mainSize to ExpandDatasetProperty_T by @Wauplin in #4136

🏗️ Internal

• [Internal] Fix slack-message draft release permissions + update model by @hanouticelina in #4119
• Post-release: bump version to 1.12.0.dev0 by @huggingface-hub-bot[bot] in #4120
• [Internal] Make RELEASE_NOTES_MODEL configurable via repo variable by @Wauplin in #4126
• [Release] Add social media draft generation to release workflow by @Wauplin in #4132
• chore: bump doc-builder SHA for main doc build workflow by @rtrompier in #4137
• [Release] Make release-notes job fail loudly on bad model/empty output by @Wauplin in #4138