v1.6.0

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 --stop

• Add hf spaces dev-mode command by @lhoestq in #3824

New 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 discussions command group by @Wauplin in #3855
• Rename hf discussions view to hf discussions info by @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 webhooks CLI 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 parquet and hf datasets sql commands 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

• Add duplicate_repo method and hf repos duplicate command by @Wauplin in #3880

🪣 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://buckets by @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 output

• Add pip installable repos support to hf extensions by @Wauplin in #3892

Show 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 --help by @hanouticelina in #3884

Other QoL improvements

• Add NVIDIA provider support to InferenceClient by @manojkilaru97 in #3886
• Bump hf_xet minimal package version to >=1.3.2 for 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

• Remove deprecated direction argument in list_models/datasets/spaces by @Wauplin in #3882

🏗️ 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 hf CLI 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