[v1.5.0]: Buckets API, Agent-first CLI, Spaces Hot-Reload and more
This release introduces major new features including Buckets (xet-based large scale object storage), CLI Extensions, Space Hot-Reload, and significant improvements for AI coding agents. The CLI has been completely overhauled with centralized error handling, better help output, and new commands for collections, papers, and more.
Buckets provide S3-like object storage on Hugging Face, powered by the Xet storage backend. Unlike repositories (which are git-based and track file history), buckets are remote object storage containers designed for large-scale files with content-addressable deduplication. Use them for training checkpoints, logs, intermediate artifacts, or any large collection of files that doesn't need version control.
# Create a bucket
hf buckets create my-bucket --private
# Upload a directory
hf buckets sync ./data hf://buckets/username/my-bucket
# Download from bucket
hf buckets sync hf://buckets/username/my-bucket ./data
# List files
hf buckets list username/my-bucket -R --treeThe Buckets API includes full CLI and Python support for creating, listing, moving, and deleting buckets; uploading, downloading, and syncing files; and managing bucket contents with include/exclude patterns.
hf install by @julien-c in #3846📚 Documentation: Buckets guide
This release includes several features designed to improve the experience for AI coding agents (Claude Code, OpenCode, Cursor, etc.):
HF_DEBUG=1 for full traces) by @hanouticelina in #3754hf skills add command now installs a compact skill (~1.2k tokens vs ~12k before) by @hanouticelina in #3802hf jobs logs: Prints available logs and exits by default; use -f to stream by @davanstrien in #3783# Install the hf-cli skill for Claude
hf skills add --claude
# Install for project-level
hf skills add --projecthf skills add CLI command by @julien-c in #3741hf skills add installs to central location with symlinks by @hanouticelina in #3755Hot-reload Python files in a Space without a full rebuild and restart. This is useful for rapid iteration on Gradio apps.
# Open an interactive editor to modify a remote file
hf spaces hot-reload username/repo-name app.py
# Take local version and patch remote
hf spaces hot-reload username/repo-name -f app.pyhf papers ls to list daily papers on the Hub by @julien-c in #3723hf collections commands (ls, info, create, update, delete, add-item, update-item, delete-item) by @Wauplin in #3767Introduce an extension mechanism to the hf CLI. Extensions are standalone executables hosted in GitHub repositories that users can install, run, and remove with simple commands. Inspired by gh extension.
# Install an extension (defaults to huggingface org)
hf extensions install hf-claude
# Install from any GitHub owner
hf extensions install hanouticelina/hf-claude
# Run an extension
hf claude
# List installed extensions
hf extensions listhf extension by @hanouticelina in #3805hf ext alias by @hanouticelina in #3836--format {table,json} and -q/--quiet to hf models ls, hf datasets ls, hf spaces ls, hf endpoints ls by @hanouticelina in #3735hf jobs ps output with standard CLI pattern by @davanstrien in #3799--expand field by @hanouticelina in #3760hf CLI help output with examples and documentation links by @hanouticelina in #3743-h as short alias for --help by @assafvayner in #3800--version flag by @Wauplin in #3784--type as alias for --repo-type by @Wauplin in #3835hf download repo_id subfolder/ now works as expected by @Wauplin in #3822List available hardware:
✗ hf jobs hardware
NAME PRETTY NAME CPU RAM ACCELERATOR COST/MIN COST/HOUR
--------------- ---------------------- -------- ------- ----------------- -------- ---------
cpu-basic CPU Basic 2 vCPU 16 GB N/A $0.0002 $0.01
cpu-upgrade CPU Upgrade 8 vCPU 32 GB N/A $0.0005 $0.03
cpu-performance CPU Performance 32 vCPU 256 GB N/A $0.3117 $18.70
cpu-xl CPU XL 16 vCPU 124 GB N/A $0.0167 $1.00
t4-small Nvidia T4 - small 4 vCPU 15 GB 1x T4 (16 GB) $0.0067 $0.40
t4-medium Nvidia T4 - medium 8 vCPU 30 GB 1x T4 (16 GB) $0.0100 $0.60
a10g-small Nvidia A10G - small 4 vCPU 15 GB 1x A10G (24 GB) $0.0167 $1.00
...Also added a ton of fixes and small QoL improvements.
torchrun, accelerate launch) by @lhoestq in #3674hf jobs hardware by @Wauplin in #3693!=) by @lhoestq in #3742hf jobs commands crashing without a TTY by @davanstrien in #3782dimensions & encoding_format parameter to InferenceClient for output embedding size by @mishig25 in #3671image-to-image compatibility with different model schemas by @hanouticelina in #3749EvalResultEntry, parse_eval_result_entries) by @hanouticelina in #3633EvalResultEntry by @hanouticelina in #3694num_papers field to Organization class by @cfahlgren1 in #3695benchmark=True → benchmark="official") by @Wauplin in #3734EvalResultEntry by @Wauplin in #3738task_id required in EvalResultEntry by @Wauplin in #3718upload_large_folder by @Wauplin in #3698plan string in org info by @Wauplin in #3753mode= parameter support by @Wauplin in #3785HfApi.snapshot_download for dry_run typing by @Wauplin in #3788__init__ by @zucchini-nlp in #3818dataclass.repr=True before wrapping by @zucchini-nlp in #3823hf jobs ps removes old Go-template --format '{{.id}}' syntax. Use -q for IDs or --format json | jq for custom extraction by @davanstrien in #3799hf repos instead of hf repo (old command still works but shows deprecation warning) by @Wauplin in #3848hf repo-files delete to hf repo delete-files (old command hidden from help, shows deprecation warning) by @Wauplin in #3821HfFileSystem.resolve_path() with special char @ by @lhoestq in #3704hf_transfer references in Korean and German translations by @davanstrien in #3804typer-slim to typer by @svlandeg in #3797shellingham from the required dependencies by @hanouticelina in #3798unused-ignore-comment warnings in ty for mypy compatibility by @hanouticelina in #3691unused-type-ignore-comment warning from ty by @hanouticelina in #3803file_download tests by @hanouticelina in #3815CollectionItem by @hanouticelina in #3831inference_provider instead of inference in tests by @hanouticelina in #3826Fetched April 7, 2026