This release brings significant new CLI commands for managing Spaces, Datasets, Discussions, and Webhooks, along with HfFileSystem support for Buckets and a CLI extension system.
🚀 New CLI commands
We've added several new CLI command groups to make interacting with the Hub even easier from your terminal.
New hf spaces dev-mode command
You can now enable or disable dev mode on Spaces directly from the CLI. When enabling dev mode, the command waits for the Space to be ready and prints connection instructions (web VSCode, SSH, local VSCode/Cursor). This makes iterating on Spaces much faster by allowing you to restart your application without stopping the Space container.
# Enable dev mode
hf spaces dev-mode username/my-space
# Disable dev mode
hf spaces dev-mode username/my-space --stopNew hf discussions command group
You can now manage discussions and pull requests on the Hub directly from the CLI. This includes listing, viewing, creating, commenting on, closing, reopening, renaming, and merging discussions and PRs.
# List open discussions and PRs on a repo
hf discussions list username/my-model
# Create a new discussion
hf discussions create username/my-model --title "Feature request" --body "Description"
# Create a pull request
hf discussions create username/my-model --title "Fix bug" --pull-request
# Merge a pull request
hf discussions merge username/my-model 5 --yes- Add
hf discussionscommand group by @Wauplin in #3855 - Rename
hf discussions viewtohf discussions infoby @Wauplin in #3878
New hf webhooks command group
Full CLI support for managing Hub webhooks is now available. You can list, inspect, create, update, enable/disable, and delete webhooks directly from the terminal.
# List all webhooks
hf webhooks ls
# Create a webhook
hf webhooks create --url https://example.com/hook --watch model:bert-base-uncased
# Enable / disable a webhook
hf webhooks enable webhook_id
hf webhooks disable webhook_id
# Delete a webhook
hf webhooks delete webhook_id- Add
hf webhooksCLI commands by @omkar-334 in #3866
New hf datasets parquet and hf datasets sql commands
Two new commands make it easy to work with dataset parquet files. Use hf datasets parquet to discover parquet file URLs, then query them with hf datasets sql using DuckDB.
# List parquet URLs for a dataset
hf datasets parquet cfahlgren1/hub-stats
hf datasets parquet cfahlgren1/hub-stats --subset models --split train
# Run SQL queries on dataset parquet
hf datasets sql "SELECT COUNT(*) FROM read_parquet('https://huggingface.co/api/datasets/...')"- Add
hf datasets parquetandhf datasets sqlcommands by @cfahlgren1 in #3833
New hf repos duplicate command
You can now duplicate any repository (model, dataset, or Space) using a unified command. This replaces the previous duplicate_space method with a more general solution.
# Duplicate a Space
hf repos duplicate multimodalart/dreambooth-training --type space
# Duplicate a dataset
hf repos duplicate openai/gdpval --type dataset🪣 Bucket support in HfFileSystem
The HfFileSystem now supports buckets, providing S3-like object storage on Hugging Face. You can list, glob, download, stream, and upload files in buckets using the familiar fsspec interface.
from huggingface_hub import hffs
# List files in a bucket
hffs.ls("buckets/my-username/my-bucket/data")
# Read a remote file
with hffs.open("buckets/my-username/my-bucket/data/file.txt", "r") as f:
content = f.read()
# Read file content as string
hffs.read_text("buckets/my-username/my-bucket/data/file.txt")- Add bucket API support in HfFileSystem by @lhoestq in #3807
- Add docs on
hf://bucketsby @lhoestq in #3875 - Remove bucket warning in docs by @Wauplin in #3854
📦 Extensions now support pip install
The hf extensions system now supports installing extensions as Python packages in addition to standalone executables. This makes it easier to distribute and install CLI extensions.
# Install an extension
> hf extensions install hanouticelina/hf-claude
> hf extensions install alvarobartt/hf-mem
# List them
> hf extensions list
COMMAND SOURCE TYPE INSTALLED DESCRIPTION
--------- ----------------------- ------ ---------- -----------------------------------
hf claude hanouticelina/hf-claude binary 2026-03-06 Launch Claude Code with Hugging ...
hf mem alvarobartt/hf-mem python 2026-03-06 A CLI to estimate inference memo...
# Run extension
> hf claude --help
Usage: claude [options] [command] [prompt]
Claude Code - starts an interactive session by default, use -p/--print for non-interactive outputShow installed extensions in hf --help
The CLI now shows installed extensions under an "Extension commands" section in the help output.
- Show installed extensions in
hf --helpby @hanouticelina in #3884
Other QoL improvements
- Add NVIDIA provider support to InferenceClient by @manojkilaru97 in #3886
- Bump
hf_xetminimal package version to>=1.3.2for better throughput by @Wauplin in #3873 - Fix CLI errors formatting to include repo_id, repo_type, bucket_id by @Wauplin in #3889
📚 Documentation updates
- Fixed sub-headings for hf cache commands in the doc by @mostafatouny in #3877
🐛 Bug and typo fixes
- Fix: quote uv args in bash -c to prevent shell redirection by @XciD in #3857
- Fix typo in generated Skill by @hanouticelina in #3890
- Fix ty diagnostics in upload, filesystem, and repocard helpers by @hanouticelina in #3891
💔 Breaking changes
🏗️ Internal
- Release note skill attempt by @Wauplin in #3853
- Prepare for v1.6 by @Wauplin in #3860
- Skip git clone test by @Wauplin in #3881
- Add Sync
hfCLI Skill workflow by @hanouticelina in #3885 - [Release notes] doc diffs, better skill, concurrent fetching by @Wauplin in #3887
- Propagate filtered headers to xet by @bpronan in #3858