releases.shpreview

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

v1.12.0

🖥️ 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

📚 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)

📚 Documentation: Buckets guide · CLI guide

🖥️ CLI

🐛 Bug and typo fixes

🔧 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

Fetched April 24, 2026

[v1.12.0] Unified CLI output, bucket search, and more… — releases.sh