Skip to content
Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
160 commits
Select commit Hold shift + click to select a range
5ec8e27
Post-release: bump version to 1.30.0.dev0 (#4763)
huggingface-hub-bot[bot] Aug 27, 2026
ae20a50
[CI] Enable enforcement in close-unscoped-community-prs workflow (#4766)
hanouticelina Aug 27, 2026
97655e8
Align `hf jobs scheduled ls` filtering with `hf jobs ls` (`--status`/…
moon-bot-app[bot] Aug 28, 2026
1de4817
[Download] Follow redirects between Hub hosts when resolving files (#…
hanouticelina Aug 28, 2026
4cc16bc
[Download] A `ResolvedRevision` only pins the repo it was resolved fo…
Wauplin Aug 28, 2026
94cb25d
[CI] Fix torch_1.11 case-arm label to match renamed matrix entry (#4776)
MohammedAlkindi Aug 31, 2026
6a2eb09
[Sandbox] Document experimental status (#4783)
Wauplin Sep 1, 2026
f0a5c6d
[Inference Providers] Do not require the conversational tag for chat-…
hanouticelina Sep 1, 2026
176d4f3
[CI] Disable auto close (#4800)
Wauplin Sep 2, 2026
b84090b
[Release] Consolidate the HF CLI skill sync into the release workflow…
hanouticelina Sep 3, 2026
c804cdd
Post-release: bump version to 1.31.0.dev0 (#4806)
huggingface-hub-bot[bot] Sep 3, 2026
15bb844
Bump the actions group across 1 directory with 5 updates (#4798)
dependabot[bot] Sep 4, 2026
deb9777
[Docs] Clarify Jobs argument forwarding and align examples (#4809)
davanstrien Sep 4, 2026
634ad9b
[httpx migration] Expose `httpx` as a `huggingface_hub` submodule (#4…
Wauplin Sep 7, 2026
f1bb85f
[hf_api] Make CommitInfo copy-able and pickle-able (#4822)
Wauplin Sep 7, 2026
21e687e
[Download] Prevent cached file copies during local-dir dry runs (#4817)
wakamex Sep 7, 2026
6c8c56b
Fix: keep single-quoted values verbatim in load_dotenv (#4827)
AnishPatel526 Sep 8, 2026
a9b9ac6
[CLI] Fix 'hf buckets rm --recursive' deleting lexical siblings of th…
Wauplin Sep 8, 2026
01fe4bc
[Sandbox] Support custom Job labels (#4824)
Wauplin Sep 8, 2026
204b717
[CLI] Don't let `hf update` self-upgrade a pip install on Windows (#4…
Wauplin Sep 8, 2026
aa3c2fd
[HfFileSystem] Reject unsafe paths before local downloads (#4828)
Wauplin Sep 8, 2026
9d7bbfe
[Download] Share retry handling for stream entry and body failures (#…
Wauplin Sep 8, 2026
8934ec0
[Download] Tolerate missing HEAD Content-Length (#4805)
Wauplin Sep 8, 2026
b9c14d9
[Download] Write cache ref file atomically in `snapshot_download` (#4…
Wauplin Sep 8, 2026
063b37b
[CLI] Raise explicit error for shell-script extensions on Windows (#4…
hanouticelina Sep 9, 2026
6cae778
[Jobs] Add network groups to hf jobs run (#4833)
co42 Sep 9, 2026
22fe960
Fix dotenv parser truncating unquoted values containing '#' (#4842)
BenYang12 Sep 9, 2026
c4f076c
(LFS)Fix SliceFileObj.__iter__ yielding only the first 4MB chunk (#4844)
BenYang12 Sep 9, 2026
f148666
[CLI] Fix truncated command descriptions in the CLI reference (#4849)
hanouticelina Sep 9, 2026
ff4292b
Post-release: bump version to 1.32.0.dev0 (#4856)
huggingface-hub-bot[bot] Sep 10, 2026
a2af2e0
docs(jobs): scope network groups to the namespace and resource group …
co42 Sep 10, 2026
0790f7b
[Community] Fix docstring for DiscussionComment.last_edited_by (#4864)
Saniyagupte Sep 10, 2026
bf85073
fix(sandbox): preserve terminal command results (#4851)
evalstate Sep 10, 2026
819cd77
[CLI] Read a UV script's `[tool.hf-jobs]` launch config (opus-generat…
Wauplin Sep 10, 2026
b853ec6
Add `--container-registry-{username,password}` (#4854)
alvarobartt Sep 10, 2026
e203a7f
fix(serialization): save_torch_state_dict cleanup regex silently matc…
g0rdonL Sep 10, 2026
3493edb
Bump the actions group with 4 updates (#4848)
dependabot[bot] Sep 10, 2026
4110cac
Key the doc build concurrency group on the pull request number (#4876)
albertvillanova Sep 11, 2026
edb2c83
[Buckets] Fix file metadata size on redirects (#4874)
davanstrien Sep 11, 2026
5694eda
[RepoCard] Fix AttributeError when model-index has source: null (#4870)
Saniyagupte Sep 11, 2026
b2678ec
[Spaces] Fix AttributeError in SpaceRuntime when hardware is null (#4…
Saniyagupte Sep 11, 2026
8a408cd
[CI] Make CI less flaky and stop 6h hung jobs (#4830)
Wauplin Sep 11, 2026
dd6919c
[Serialization] Harden torch checkpoint deserialization (#4877)
Wauplin Sep 11, 2026
9588035
feat(jobs): expose the network group on JobInfo (#4862)
co42 Sep 11, 2026
129bbb5
[Http] Fix race in get_session() creating multiple clients (#4868)
hanouticelina Sep 11, 2026
98e2db8
[CLI] Make --format human override agent auto-detection (#4878)
hanouticelina Sep 14, 2026
c5ff040
[Serialization] Sync `_get_dtype_size` with safetensors (#4902)
Wauplin Sep 14, 2026
f1e70a2
[Safetensors] Recognize proposed U3 metadata (#4898)
7dsolv Sep 14, 2026
fb21643
[Download] Fix silently disabled tree cache on long Windows paths (#4…
askalf Sep 14, 2026
490f06e
docs: make the sandbox security contract match the implementation (#4…
Wauplin Sep 14, 2026
1fb5b3b
feat(sandbox): use each pooled sandbox's own capability token (#4832)
Wauplin Sep 14, 2026
ef2662f
fix(sandbox): validate a pool host before sending it a credential (#4…
Wauplin Sep 14, 2026
40efc5e
fix(sandbox): bind the pool cache to the context that wrote it (#4838)
Wauplin Sep 14, 2026
0613ead
fix(sandbox): bound what a transfer or a command's output costs the c…
Wauplin Sep 14, 2026
c7e60d8
fix(sandbox): decide host teardown per host, and report it honestly (…
Wauplin Sep 14, 2026
ec61993
fix(sandbox): address background processes by their server-assigned i…
Wauplin Sep 14, 2026
0219ad5
[sandbox audit] Pin the sandbox server binary by digest and verify it…
Wauplin Sep 14, 2026
1173050
[sandbox audit] Keep secret values out of argv in the CLI and fix the…
Wauplin Sep 14, 2026
48cdc03
Fix doubled colon in snapshot download transfer bar description (#4890)
sandeepb2013 Sep 14, 2026
a3b62f6
[CLI] Add `hf --skills` as an alias for `hf skills preview` (#4906)
Wauplin Sep 14, 2026
bd9ece0
[CLI] Support file URIs in hf cache rm (#4847)
hanouticelina Sep 14, 2026
0a57df9
[Core] Restrict repo_id validation regex to ASCII word characters (#4…
bodapatisaikrishna Sep 15, 2026
af6b41e
[Core] Reject path traversal via embedded ".." segments in path_in_re…
bodapatisaikrishna Sep 15, 2026
2075fd6
[Cache] Support kernel repos in `hf cache` commands (#4905)
hanouticelina Sep 15, 2026
5a9cdda
[Core] Speed up package imports (#4914)
Wauplin Sep 15, 2026
6e3d21f
[Cache] Add cross-repo shared blob store (#4498)
hanouticelina Sep 17, 2026
f94ea55
[Buckets] Send mtime when copying files (#4920)
Wauplin Sep 17, 2026
d7b62c7
[CLI] Fix card data serialization (#4882)
davanstrien Sep 17, 2026
79dd41e
[Docs] Fix hf discussions info options that do not exist (#4886)
rishabhsai Sep 17, 2026
b064a14
[Download] Send X-HF-Download-Counter header on download calls (#4613)
Wauplin Sep 17, 2026
e9c55ce
Post-release: bump version to 1.33.0.dev0 (#4926)
huggingface-hub-bot[bot] Sep 17, 2026
618250b
[Download] Publish symlink support only after probing (#4923)
Wauplin Sep 17, 2026
77b6b2b
[Core] Skip invalid eval results entries instead of raising (#4924)
davanstrien Sep 17, 2026
34ae660
[Cache] Use posix paths for scan_cache_dir ref names (#4925)
gokay-ai Sep 18, 2026
0ba990a
[Download] Measure http_get progress from the initial file position (…
Wauplin Sep 18, 2026
cea607a
[Serialization] Fix device type when map_location is None (#4938)
Wauplin Sep 18, 2026
83ba61a
[CLI] Honor --format / --json / -q on jobs run commands (#4936)
Wauplin Sep 18, 2026
8c9546f
[Quality] Replace `re.match` with `re.fullmatch` / `re.search` and ba…
Wauplin Sep 18, 2026
22b5e87
[Docs] Sync provider task table with the PROVIDERS registry (#4930)
rishabhsai Sep 18, 2026
8efc0a9
[HfFileSystem] Make lpath optional in get_file (fsspec>=2026.9.0) (#4…
assafvayner Sep 21, 2026
4c80e7e
Fix `format_timesince` showing "60 seconds ago" / "60 minutes ago" / …
Sreekant13 Sep 21, 2026
55668e2
Fix Windows conftest erroring test subsets on lazy-loaded file_downlo…
dltsum Sep 21, 2026
7ce68b9
[Webhooks] Allow `bucket` as a watched item type (#4958)
davanstrien Sep 21, 2026
7025391
[MCP] Follow nextCursor when listing tools in MCPClient (#4960)
Kayvan-Zahiri Sep 22, 2026
80aef09
Align the `hf` package's python_requires with huggingface_hub (#4959)
sharziki Sep 22, 2026
94cf392
Remove dots from allowed characters in job labels. (#4962)
evalstate Sep 22, 2026
8d4fba6
[CLI] Honor `CLAUDE_CONFIG_DIR` in `hf skills add -g --claude` (#4957)
hanouticelina Sep 22, 2026
aa8742c
[CLI] Always install skills for Claude Code, deprecate --claude (#4967)
hanouticelina Sep 22, 2026
ce69fdb
[Buckets] Raise when a batch reports failed operations (#4954)
hanouticelina Sep 22, 2026
0f88f32
[Download] Extend tmp .incomplete path on Windows when too long (#4978)
Wauplin Sep 23, 2026
7532272
Fix HfFileSystem.get_file with a bare local filename (#4981)
davanstrien Sep 23, 2026
da5e244
Scope GITHUB_TOKEN permissions per job (#4982)
hf-security-analysis[bot] Sep 23, 2026
1e0c305
Send PrivateLink config under privateService in create_inference_endp…
co42 Sep 23, 2026
b904b94
Apply the repo_id length limit to the namespace as well (#4988)
anishmehta24 Sep 24, 2026
ac3ed2f
[Xet] Show Validating progress during shard finalization (#4478)
seanses Sep 24, 2026
fa26f34
[CI] Support major (pre-)releases in release workflow (#4991)
Wauplin Sep 24, 2026
c2e6e0a
Post-release: bump version to 1.34.0.dev0 (#4993)
huggingface-hub-bot[bot] Sep 24, 2026
9f51867
[Release] Prepare huggingface_hub 2.0 (#4994)
Wauplin Sep 24, 2026
89ae51f
unbump
Wauplin Sep 24, 2026
f5b624c
Post-release: bump version to 2.1.0.dev0 (#4999)
huggingface-hub-bot[bot] Sep 24, 2026
32456ab
[Buckets] Make include/exclude patterns case-sensitive on all platfor…
Wauplin Sep 25, 2026
c749dfa
Support secrets on Job-triggered webhooks (#5009)
moon-bot-app[bot] Sep 25, 2026
ee4f802
[HTTP] Fix repo_id in errors for query strings and download URLs (#5008)
Wauplin Sep 25, 2026
79874bc
[Buckets] Fix copy_files treating lexical siblings as an existing des…
AnishPatel526 Sep 25, 2026
ff0ccab
[CI] Bump doc-builder workflows pin to 63ec6f1 (#5010)
Wauplin Sep 25, 2026
34e8baa
[docs] xet caching and concurrency updates (#4883)
cbensimon Sep 25, 2026
62a1f2f
[HfFileSystem] Download Xet files with hf_xet in get_file (#4990)
hanouticelina Sep 25, 2026
e155ad3
[docs] Fix hf.cos typo in repository guide link (#5016)
pratikgx Sep 28, 2026
a076863
[datasets sql] Run the DuckDB CLI subprocess with UTF-8 encoding (#5020)
825pranav Sep 28, 2026
b15915b
[Auth] Store token names as UTF-8 instead of locale encoding (#5021)
Evolian-o Sep 28, 2026
41222c5
Fix scalar tags splitting into single-character list in card front ma…
zeenat28-ui Sep 28, 2026
14ee250
[CLI] Hint to use --global after local 'hf skills add/update' (#5024)
Wauplin Sep 28, 2026
f151320
[Sandbox] Require scoped credentials for pooled sandboxes (#4782)
Wauplin Sep 28, 2026
f64c26e
[Dataclasses] Accept bare typing.List/Dict/Set in @strict validation …
anishmehta24 Sep 29, 2026
7caeebb
Suggest `hf auth login` when `hf auth whoami` fails (#5033)
moon-bot-app[bot] Sep 29, 2026
5583746
[CLI] Align 'hf auth whoami' not-logged-in message with 'hf auth toke…
Wauplin Sep 29, 2026
862f23d
[Sandbox] Pin sbx-server 0.7.0 (protocol 3) (#5028)
Wauplin Sep 29, 2026
1b8b2fa
[CLI] Escape control characters in listings and table output (#5029)
Wauplin Sep 29, 2026
548f7e3
[Jobs] Allow rescheduling scheduled jobs (#5026)
Wauplin Sep 29, 2026
3fd18f2
[Jobs] Manage public and private exposed ports (#5027)
Wauplin Sep 29, 2026
231a2eb
[Jobs] Add rerun and retry attempts (#5025)
Wauplin Sep 29, 2026
d889712
[Tests] Reduce redundant Hub calls in repo settings and move tests (#…
Wauplin Sep 29, 2026
cc2f368
[Utils] Retry the first pagination page (#5035)
Wauplin Sep 29, 2026
1092497
[Spaces] Update docs for cpu-basic gating and dev mode disabling (#5037)
Wauplin Sep 29, 2026
013afa7
[CLI] Raise if a bare --secrets NAME is not set locally in hf jobs (#…
Wauplin Sep 30, 2026
83a714e
[CLI] Update hf upload help text after upload_large_folder removal (#…
davanstrien Sep 30, 2026
881a6c4
[Docs] Fix links in i18n issue template (#5051)
pratikgx Oct 1, 2026
60fdb08
[Docs] Fix duplicated words in docstring and comments (#5052)
Ad1th Oct 1, 2026
b5e3a12
[HfApi] Support resource_group_id in duplicate_repo (#5038)
Wauplin Oct 1, 2026
3bb08e2
[Endpoints] Migrate catalog to the new /api/v1 API (#4928)
Wauplin Oct 1, 2026
4c88ea6
[Repos] Warn when duplicated repo files are still being copied (#5041)
Wauplin Oct 1, 2026
604252e
[HfApi] Add visibility to create_bucket (#5053)
hanouticelina Oct 1, 2026
0b26b50
[Spaces] Add get_zero_gpu_quota and hf spaces zero-gpu-quota (#5040)
Wauplin Oct 1, 2026
ff61343
Post-release: bump version to 2.2.0.dev0 (#5054)
huggingface-hub-bot[bot] Oct 1, 2026
b3fa3a4
[CLI] Rename 'hf spaces zero-gpu-quota' to 'hf spaces zero-gpu quota'…
Wauplin Oct 1, 2026
7da19ff
[CI] Split tests into api / transfer / inference suites (#5042)
Wauplin Oct 1, 2026
7a54109
[Tests] Always clean up staging repos and buckets created by tests (#…
Wauplin Oct 1, 2026
1a76ad2
[CI] Reduce flaky tests: isolate jedi cache, sleep before read-after-…
Wauplin Oct 1, 2026
c31df86
[Bugfix] Fix wrong exception type and unbound variable guard (#5063)
vector15-05 Oct 2, 2026
37ce057
[CLI] Upload existing paths with glob characters as-is in hf upload (…
Ganesh2325 Oct 2, 2026
0ce4427
[Download] Warn when allow/ignore patterns match no files in snapshot…
Ad1th Oct 2, 2026
a625317
[Repocard] Respect configured endpoint when validating cards (#5069)
Wauplin Oct 2, 2026
d711944
[CLI] Read env/secrets files as UTF-8 and strip the BOM (#5066)
hanouticelina Oct 2, 2026
42f9085
[Setup] Install hf-xet on Windows ARM64 (#5074)
angt Oct 5, 2026
d699913
[Docs] Fix HTTP migration and async session references (#5079)
Yuilona Oct 5, 2026
bc9b691
Bump doc-builder workflow pin (#5087)
paulinebm Oct 5, 2026
3b05c63
[Jobs] Ignore 406 from metrics endpoint for finished jobs (#5091)
hanouticelina Oct 6, 2026
e817417
Bump doc-builder pin to 9fc8a41 in build_documentation.yaml (#5093)
paulinebm Oct 6, 2026
9071b17
[Jobs] Fix no-follow logs hanging while the job keeps printing (#5092)
hanouticelina Oct 6, 2026
68becf4
[CommitScheduler] Fix race that skips the first scheduled push (#5086)
hanouticelina Oct 6, 2026
ff4c989
[CLI] Print [] from hf jobs stats --json when no jobs are running (#5…
hanouticelina Oct 6, 2026
83ce8b0
[Download] Consider port when following /resolve redirects (#4942)
assafvayner Oct 6, 2026
a5277cf
[CLI] Snapshot by default in hf jobs stats, add -f/--follow (#5090)
hanouticelina Oct 6, 2026
14a48e7
[HfFileSystem] fix `ls()` on new empty bucket (#5097)
lhoestq Oct 7, 2026
38e0b3c
[HfFileSystem] Replace cached listings instead of appending to them (…
ChihebBENCHEIKH1 Oct 7, 2026
af74167
[Tests] Wait for bucket listings after writes (#5095)
hanouticelina Oct 7, 2026
cf992a9
[HfFileSystem] Make refresh=True clear cached not-found results (#5106)
hanouticelina Oct 7, 2026
bb3a875
[Docs] Fix from_pretrained integration example (#5105)
Ayushdevo Oct 7, 2026
8abbfe5
Fix race in `_get_version` that makes concurrent downloads skip hf_xe…
BramVanroy Oct 7, 2026
3cfa593
Guard upload_pr_documentation workflow to upstream repo only
g0rdonL Oct 8, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
[Release] Prepare huggingface_hub 2.0 (huggingface#4994)
* [hfh 2.x] Remove deprecated APIs (huggingface#4955)

* [hfh 2.x] Remove deprecated APIs

* [hfh 2.x] Keep deprecation helpers and legacy-argument shim

Restore `utils/_deprecation.py` (`_deprecate_arguments`, `_deprecate_method`,
`_deprecate_positional_args`) and its tests: they are unused now that the
deprecated APIs are gone, but we want them ready for the next deprecation cycle.
The `@pytest.mark.deprecated` harness (`expect_deprecation_marker` fixture) is
kept alongside them for the same reason.

Also restore `smoothly_deprecate_legacy_arguments` and its call in
`validate_hf_hub_args`, so `proxies`, `resume_download`, `force_filename` and
`local_dir_use_symlinks` keep being ignored with a warning instead of raising.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

* [Inference] Resolve endpoint token before creating clients

---------

Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>

* [hfh 2.x] Merge main into v2.0 dev branch (huggingface#4971)

* [HfFileSystem] Make lpath optional in get_file (fsspec>=2026.9.0) (huggingface#4951)

* [HfFileSystem] Make `lpath` optional in `get_file` (fsspec>=2026.9.0)

fsspec 2026.9.0 made `lpath` optional in `AbstractFileSystem.get_file`
(it can be omitted when `outfile` is provided). Our override kept it
required, which the latest `ty` flags as an invalid method override and
fails CI.

Make `lpath=None` in the signature and raise a clear ValueError if
neither `lpath` nor `outfile` is provided. No behavior change otherwise.

* fix get_file branching to match fsspec

---------

Co-authored-by: Celina Hanouti <hanouticelina@gmail.com>

* Fix `format_timesince` showing "60 seconds ago" / "60 minutes ago" / "24 hours ago" instead of rolling over (huggingface#4943)

* Roll `format_timesince` over to the next unit at the boundary

`format_timesince` showed "60 seconds ago", "60 minutes ago" and "24 hours ago"
at the exact unit boundaries instead of rolling over to the next unit, because
the per-unit max values were 60/60/24 rather than 59/59/23. Days (6 -> 1 week)
and months (11 -> 1 year) already rolled correctly; this brings seconds,
minutes and hours in line. Adds the boundary cases to the test.

* Update src/huggingface_hub/utils/_parsing.py

---------

Co-authored-by: célina <hanouticelina@gmail.com>

* Fix Windows conftest erroring test subsets on lazy-loaded file_download submodule (huggingface#4945)

* Fix Windows conftest failing on lazy-loaded `file_download` submodule

The `disable_symlinks_on_windows_ci` autouse fixture (active on Windows via
`DISABLE_SYMLINKS_IN_WINDOWS_TESTS=1` in pyproject.toml) accesses
`huggingface_hub.file_download` as a monkeypatch target. Since the package
loads submodules lazily, this attribute only exists if something else already
imported the submodule. Running a test subset that doesn't (e.g.
`pytest tests/test_utils_headers.py`) errors every test at setup with
`AttributeError: No huggingface_hub attribute file_download`.

Use the string-target form of `monkeypatch.setattr`, which imports the
submodule itself.

Co-Authored-By: Claude Code <noreply@anthropic.com>

* Update tests/conftest.py

---------

Co-authored-by: dltsum <dltsum@users.noreply.github.com>
Co-authored-by: Claude Code <noreply@anthropic.com>
Co-authored-by: célina <hanouticelina@gmail.com>

* [Webhooks] Allow `bucket` as a watched item type (huggingface#4958)

The Hub accepts buckets as watched items, but `hf webhooks create
--watch bucket:...` fails client-side because the CLI derives its valid
types from `WebhookWatchedItem.type`, which lacked "bucket".


Claude-Session: https://claude.ai/code/session_015YLK3QPDdiiZGuDxoFrEag

Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>

* [MCP] Follow nextCursor when listing tools in MCPClient (huggingface#4960)

* [MCP] Follow nextCursor when listing tools in MCPClient

add_mcp_server called list_tools() once, so tools past a server's first
tools/list page were never registered, and allowed_tools could filter
down to nothing. Page through with the cursor until nextCursor is empty.

* [MCP] Keep the first list_tools() call cursor-free and require mcp>=1.9.4

mcp 1.8.x's list_tools() takes no cursor at all, and before 1.9.4 the cursor
is sent outside params, so a paginating server returns page one forever.
Call list_tools() plainly first so non-paginated servers behave as before,
and raise the extra's floor to the first release that paginates correctly.

* Align the `hf` package's python_requires with huggingface_hub (huggingface#4959)

* [CLI] Align the `hf` package's python_requires with huggingface_hub

`huggingface_hub` moved to `python_requires=">=3.10.0"` in huggingface#4856, but
`utils/hf/setup.py` was left at `">=3.9.0"`. The `hf` package is only a console
script that imports `huggingface_hub` and pins `huggingface_hub=={version}`, so
the published metadata now contradicts itself: PyPI shows `hf` 1.32.0 as
`Requires-Python: >=3.9.0` while the `huggingface_hub==1.32.0` it depends on is
`>=3.10.0`.

On Python 3.9 that resolves two ways, both wrong:

    $ pip install hf
    Successfully installed hf-1.8.0 huggingface_hub-1.8.0   # silently 24 versions stale

    $ pip install hf==1.32.0
    ERROR: Could not find a version that satisfies the requirement
      huggingface_hub==1.32.0 (from hf)
    ERROR: No matching distribution found for huggingface_hub==1.32.0

The first is the damaging one: `uvx hf`, the usage the README documents, reports
version 1.8.0 on a 3.9 interpreter with no error and no warning, so a user can
be years out of date without any signal.

Set `python_requires` to match the root setup.py and add a test asserting the
two stay equal, since the root cause is that they are edited independently and
nothing tied them together.

Verification:
  $ python -m build --wheel   # in utils/hf
  Requires-Python: >=3.10.0
  Requires-Dist: huggingface_hub==1.33.0.dev0
Signed-off-by: Sharvil Saxena <sharvil.saxena@gmail.com>

* no need to add tests

* Update utils/hf/setup.py

---------

Signed-off-by: Sharvil Saxena <sharvil.saxena@gmail.com>
Co-authored-by: célina <hanouticelina@gmail.com>

* Remove dots from allowed characters in job labels. (huggingface#4962)

* [CLI] Honor `CLAUDE_CONFIG_DIR` in `hf skills add -g --claude` (huggingface#4957)

* [CLI] Honor CLAUDE_CONFIG_DIR in hf skills add -g --claude

* remove test

* [CLI] Always install skills for Claude Code, deprecate --claude (huggingface#4967)

* [CLI] Always install skills for Claude Code, deprecate --claude

* show --claude as deprecated in help instead of hiding it

* remove test

---------

Signed-off-by: Sharvil Saxena <sharvil.saxena@gmail.com>
Co-authored-by: Assaf Vayner <assaf@huggingface.co>
Co-authored-by: Celina Hanouti <hanouticelina@gmail.com>
Co-authored-by: Sreekant Baheti <60787859+Sreekant13@users.noreply.github.com>
Co-authored-by: DltsumCtnori <lllalllbpear@gmail.com>
Co-authored-by: dltsum <dltsum@users.noreply.github.com>
Co-authored-by: Claude Code <noreply@anthropic.com>
Co-authored-by: Daniel van Strien <davanstrien@users.noreply.github.com>
Co-authored-by: Kayvan Zahiri <123409429+Kayvan-Zahiri@users.noreply.github.com>
Co-authored-by: Sharvil Saxena <97365286+sharziki@users.noreply.github.com>
Co-authored-by: shaun smith <1936278+evalstate@users.noreply.github.com>

* [CLI] Remove deprecated --claude option in 2.x (huggingface#4970)

* [hfh 2.x] Merge main after PrivateLink update (huggingface#4985)

* [HfFileSystem] Make lpath optional in get_file (fsspec>=2026.9.0) (huggingface#4951)

* [HfFileSystem] Make `lpath` optional in `get_file` (fsspec>=2026.9.0)

fsspec 2026.9.0 made `lpath` optional in `AbstractFileSystem.get_file`
(it can be omitted when `outfile` is provided). Our override kept it
required, which the latest `ty` flags as an invalid method override and
fails CI.

Make `lpath=None` in the signature and raise a clear ValueError if
neither `lpath` nor `outfile` is provided. No behavior change otherwise.

* fix get_file branching to match fsspec

---------

Co-authored-by: Celina Hanouti <hanouticelina@gmail.com>

* Fix `format_timesince` showing "60 seconds ago" / "60 minutes ago" / "24 hours ago" instead of rolling over (huggingface#4943)

* Roll `format_timesince` over to the next unit at the boundary

`format_timesince` showed "60 seconds ago", "60 minutes ago" and "24 hours ago"
at the exact unit boundaries instead of rolling over to the next unit, because
the per-unit max values were 60/60/24 rather than 59/59/23. Days (6 -> 1 week)
and months (11 -> 1 year) already rolled correctly; this brings seconds,
minutes and hours in line. Adds the boundary cases to the test.

* Update src/huggingface_hub/utils/_parsing.py

---------

Co-authored-by: célina <hanouticelina@gmail.com>

* Fix Windows conftest erroring test subsets on lazy-loaded file_download submodule (huggingface#4945)

* Fix Windows conftest failing on lazy-loaded `file_download` submodule

The `disable_symlinks_on_windows_ci` autouse fixture (active on Windows via
`DISABLE_SYMLINKS_IN_WINDOWS_TESTS=1` in pyproject.toml) accesses
`huggingface_hub.file_download` as a monkeypatch target. Since the package
loads submodules lazily, this attribute only exists if something else already
imported the submodule. Running a test subset that doesn't (e.g.
`pytest tests/test_utils_headers.py`) errors every test at setup with
`AttributeError: No huggingface_hub attribute file_download`.

Use the string-target form of `monkeypatch.setattr`, which imports the
submodule itself.

Co-Authored-By: Claude Code <noreply@anthropic.com>

* Update tests/conftest.py

---------

Co-authored-by: dltsum <dltsum@users.noreply.github.com>
Co-authored-by: Claude Code <noreply@anthropic.com>
Co-authored-by: célina <hanouticelina@gmail.com>

* [Webhooks] Allow `bucket` as a watched item type (huggingface#4958)

The Hub accepts buckets as watched items, but `hf webhooks create
--watch bucket:...` fails client-side because the CLI derives its valid
types from `WebhookWatchedItem.type`, which lacked "bucket".


Claude-Session: https://claude.ai/code/session_015YLK3QPDdiiZGuDxoFrEag

Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>

* [MCP] Follow nextCursor when listing tools in MCPClient (huggingface#4960)

* [MCP] Follow nextCursor when listing tools in MCPClient

add_mcp_server called list_tools() once, so tools past a server's first
tools/list page were never registered, and allowed_tools could filter
down to nothing. Page through with the cursor until nextCursor is empty.

* [MCP] Keep the first list_tools() call cursor-free and require mcp>=1.9.4

mcp 1.8.x's list_tools() takes no cursor at all, and before 1.9.4 the cursor
is sent outside params, so a paginating server returns page one forever.
Call list_tools() plainly first so non-paginated servers behave as before,
and raise the extra's floor to the first release that paginates correctly.

* Align the `hf` package's python_requires with huggingface_hub (huggingface#4959)

* [CLI] Align the `hf` package's python_requires with huggingface_hub

`huggingface_hub` moved to `python_requires=">=3.10.0"` in huggingface#4856, but
`utils/hf/setup.py` was left at `">=3.9.0"`. The `hf` package is only a console
script that imports `huggingface_hub` and pins `huggingface_hub=={version}`, so
the published metadata now contradicts itself: PyPI shows `hf` 1.32.0 as
`Requires-Python: >=3.9.0` while the `huggingface_hub==1.32.0` it depends on is
`>=3.10.0`.

On Python 3.9 that resolves two ways, both wrong:

    $ pip install hf
    Successfully installed hf-1.8.0 huggingface_hub-1.8.0   # silently 24 versions stale

    $ pip install hf==1.32.0
    ERROR: Could not find a version that satisfies the requirement
      huggingface_hub==1.32.0 (from hf)
    ERROR: No matching distribution found for huggingface_hub==1.32.0

The first is the damaging one: `uvx hf`, the usage the README documents, reports
version 1.8.0 on a 3.9 interpreter with no error and no warning, so a user can
be years out of date without any signal.

Set `python_requires` to match the root setup.py and add a test asserting the
two stay equal, since the root cause is that they are edited independently and
nothing tied them together.

Verification:
  $ python -m build --wheel   # in utils/hf
  Requires-Python: >=3.10.0
  Requires-Dist: huggingface_hub==1.33.0.dev0
Signed-off-by: Sharvil Saxena <sharvil.saxena@gmail.com>

* no need to add tests

* Update utils/hf/setup.py

---------

Signed-off-by: Sharvil Saxena <sharvil.saxena@gmail.com>
Co-authored-by: célina <hanouticelina@gmail.com>

* Remove dots from allowed characters in job labels. (huggingface#4962)

* [CLI] Honor `CLAUDE_CONFIG_DIR` in `hf skills add -g --claude` (huggingface#4957)

* [CLI] Honor CLAUDE_CONFIG_DIR in hf skills add -g --claude

* remove test

* [CLI] Always install skills for Claude Code, deprecate --claude (huggingface#4967)

* [CLI] Always install skills for Claude Code, deprecate --claude

* show --claude as deprecated in help instead of hiding it

* remove test

* [Buckets] Raise when a batch reports failed operations (huggingface#4954)

* [Buckets] Raise when a batch reports failed operations

* fix pickling of BucketBatchError

* keep only the main test

* Update src/huggingface_hub/hf_api.py

Co-authored-by: Lucain <lucain@huggingface.co>

* fix missing parenthesis

* use a real test against staging

* keep sending chunks after a failure

* fold batch tests into one

---------

Co-authored-by: Lucain <lucain@huggingface.co>

* [Download] Extend tmp .incomplete path on Windows when too long (huggingface#4978)

Co-authored-by: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

* Fix HfFileSystem.get_file with a bare local filename (huggingface#4981)

`os.path.dirname("file.txt")` is "", and `os.makedirs("")` raises
FileNotFoundError. Fall back to the current directory, matching fsspec's
base `get_file` and gcsfs (fsspec/gcsfs#618).

Co-authored-by: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

* Scope GITHUB_TOKEN permissions per job (huggingface#4982)

A job with no `permissions:` block inherits whatever the repository
hands out. Each block added here grants what that job's own steps
need and nothing more.

Co-authored-by: hf-security-analysis[bot] <265538906+hf-security-analysis[bot]@users.noreply.github.com>

* Send PrivateLink config under privateService in create_inference_endpoint (huggingface#4966)

* Send PrivateLink config under privateService in create_inference_endpoint

* [Inference] Keep account_id compatible for endpoint creation

* [Inference] Remove account_id compatibility test

---------

Co-authored-by: Lucain Pouget <lucainp@gmail.com>

---------

Signed-off-by: Sharvil Saxena <sharvil.saxena@gmail.com>
Co-authored-by: Assaf Vayner <assaf@huggingface.co>
Co-authored-by: Celina Hanouti <hanouticelina@gmail.com>
Co-authored-by: Sreekant Baheti <60787859+Sreekant13@users.noreply.github.com>
Co-authored-by: DltsumCtnori <lllalllbpear@gmail.com>
Co-authored-by: dltsum <dltsum@users.noreply.github.com>
Co-authored-by: Claude Code <noreply@anthropic.com>
Co-authored-by: Daniel van Strien <davanstrien@users.noreply.github.com>
Co-authored-by: Kayvan Zahiri <123409429+Kayvan-Zahiri@users.noreply.github.com>
Co-authored-by: Sharvil Saxena <97365286+sharziki@users.noreply.github.com>
Co-authored-by: shaun smith <1936278+evalstate@users.noreply.github.com>
Co-authored-by: hf-security-analysis[bot] <265538906+hf-security-analysis[bot]@users.noreply.github.com>
Co-authored-by: Corentin REGAL <corentin@huggingface.co>

* [hfh 2.x] Migrate to httpx2 (huggingface#4921)

* [httpx migration] Migrate to httpx2

* [Docs] Add HTTPX2 migration resources

* [hfh 2.x] Fix HTTPX migration CI

* [CLI] Regenerate CLI reference for v2 branch

* [Core] Drop stale deprecated API exports

* [Docs] Install httpx2 for documentation builds

* Revert "[Docs] Install httpx2 for documentation builds"

This reverts commit 4293e28.

* fix(ci): harden workflow files flagged on huggingface#4994 (huggingface#4995)

Co-authored-by: hf-security-analysis[bot] <265538906+hf-security-analysis[bot]@users.noreply.github.com>

---------

Signed-off-by: Sharvil Saxena <sharvil.saxena@gmail.com>
Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
Co-authored-by: Assaf Vayner <assaf@huggingface.co>
Co-authored-by: Celina Hanouti <hanouticelina@gmail.com>
Co-authored-by: Sreekant Baheti <60787859+Sreekant13@users.noreply.github.com>
Co-authored-by: DltsumCtnori <lllalllbpear@gmail.com>
Co-authored-by: dltsum <dltsum@users.noreply.github.com>
Co-authored-by: Daniel van Strien <davanstrien@users.noreply.github.com>
Co-authored-by: Kayvan Zahiri <123409429+Kayvan-Zahiri@users.noreply.github.com>
Co-authored-by: Sharvil Saxena <97365286+sharziki@users.noreply.github.com>
Co-authored-by: shaun smith <1936278+evalstate@users.noreply.github.com>
Co-authored-by: hf-security-analysis[bot] <265538906+hf-security-analysis[bot]@users.noreply.github.com>
Co-authored-by: Corentin REGAL <corentin@huggingface.co>
  • Loading branch information
13 people authored Sep 24, 2026
commit 9f51867e20abd5daab5c0f8d433b64d24e6c1f2d
17 changes: 13 additions & 4 deletions .github/workflows/release.yml
Original file line number Diff line number Diff line change
Expand Up @@ -67,6 +67,7 @@ on:
- major-release



permissions: {}

jobs:
Expand Down Expand Up @@ -482,11 +483,15 @@ jobs:

- name: Install OpenCode
if: ${{ endsWith(inputs.release_type, '-prerelease') && steps.check_draft.outputs.skip != 'true' }}
run: curl -fsSL https://opencode.ai/install | bash -s -- --version ${{ vars.OPENCODE_VERSION }}
env:
OPENCODE_VERSION: ${{ vars.OPENCODE_VERSION }}
run: curl -fsSL https://opencode.ai/install | bash -s -- --version "$OPENCODE_VERSION"

- name: Verify OpenCode checksum
if: ${{ endsWith(inputs.release_type, '-prerelease') && steps.check_draft.outputs.skip != 'true' }}
run: echo "${{ vars.OPENCODE_SHA256 }} $(which opencode)" | sha256sum -c -
env:
OPENCODE_SHA256: ${{ vars.OPENCODE_SHA256 }}
run: echo "$OPENCODE_SHA256 $(which opencode)" | sha256sum -c -

- name: Generate release notes with OpenCode
if: ${{ endsWith(inputs.release_type, '-prerelease') && steps.check_draft.outputs.skip != 'true' }}
Expand Down Expand Up @@ -633,10 +638,14 @@ jobs:
run: pip install PyGithub

- name: Install OpenCode
run: curl -fsSL https://opencode.ai/install | bash -s -- --version ${{ vars.OPENCODE_VERSION }}
env:
OPENCODE_VERSION: ${{ vars.OPENCODE_VERSION }}
run: curl -fsSL https://opencode.ai/install | bash -s -- --version "$OPENCODE_VERSION"

- name: Verify OpenCode checksum
run: echo "${{ vars.OPENCODE_SHA256 }} $(which opencode)" | sha256sum -c -
env:
OPENCODE_SHA256: ${{ vars.OPENCODE_SHA256 }}
run: echo "$OPENCODE_SHA256 $(which opencode)" | sha256sum -c -

- name: Fetch release notes from GitHub
id: fetch
Expand Down
2 changes: 2 additions & 0 deletions docs/source/en/_toctree.yml
Original file line number Diff line number Diff line change
Expand Up @@ -54,6 +54,8 @@
title: Git vs HTTP paradigm
- local: concepts/sandbox
title: Sandboxes under the hood
- local: concepts/migration_v2
title: Migrating to huggingface_hub v2.0
- local: concepts/migration
title: Migrating to huggingface_hub v1.0
- title: 'Reference'
Expand Down
38 changes: 38 additions & 0 deletions docs/source/en/concepts/migration_v2.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@
# Migrating to huggingface_hub v2.0

`huggingface_hub` v2.0 replaces its HTTP dependency with [`httpx2`](https://httpx2.pydantic.dev/) and removes deprecated 1.x APIs. HTTP clients and exceptions now come from a separate package.

To support both `huggingface_hub` v1.x (starting with v1.30.0) and v2.x, import the HTTP module from `huggingface_hub.utils`:

```python
from huggingface_hub.utils import get_session, httpx

try:
response = get_session().get("https://huggingface.co/api/models/gpt2")
response.raise_for_status()
except httpx.HTTPError:
...
```

Use this same import when creating custom clients for [`set_client_factory`] or [`set_async_client_factory`]. Clients and exceptions from the old HTTP package are distinct from those in `httpx2` and cannot be used interchangeably.

`httpx2` uses the operating system's certificate trust store by default. Custom CA bundles configured with `SSL_CERT_FILE` or `SSL_CERT_DIR` are still supported. Logging configuration should target `httpx2` and `httpcore2` instead of the old logger names. See the [upstream migration guide](https://httpx2.pydantic.dev/migration/) for details.

The `oauth` extra now requires `authlib>=1.8.0` for `httpx2` support.

## Removed deprecated APIs

- Use `upload_folder` instead of `upload_large_folder` or `HfApi.upload_large_folder`.
- Use `duplicate_repo`, `set_space_volumes`, and `delete_space_volumes` instead of `duplicate_space`, `request_space_storage`, and `delete_space_storage`.
- Use `parse_hf_uri` instead of `repo_type_and_id_from_hf_id`, and `list_models(search=...)` instead of `model_name=...`.
- Use `space_volumes` instead of `space_storage` in `create_repo` and `duplicate_repo`.
- Use `InferenceEndpointType.AUTHENTICATED` or `type="authenticated"` instead of `PROTECTED` or `type="protected"`.
- Use `text_generation(stop=...)` instead of `stop_sequences=...`, and pass a token string or `None` to `InferenceClient` instead of a boolean.
- Use `hf` instead of `huggingface-cli`; `hf repo` and `hf repo-files delete` are replaced by `hf repos` and `hf repos delete-files`.
- Use `hf upload` instead of `hf upload-large-folder`; use `--volume` instead of `--storage` for repository creation and duplication, and `--status` or `--label` instead of `hf jobs ps --filter`.
- The deprecated `--claude` option on `hf skills add` and `hf skills update` is removed. Skills are installed for Claude Code automatically.

For more context, see the [`httpx2` project](https://github.com/pydantic/httpx2), the
[`httpx2` documentation](https://pydantic.dev/docs/httpx2/), the upstream
[transition guide from `httpx` to `httpx2`](https://httpx2.pydantic.dev/migration/), and the
[`huggingface_hub` transition plan](https://github.com/huggingface/huggingface_hub/issues/4802).
24 changes: 3 additions & 21 deletions docs/source/en/guides/cli.md
Original file line number Diff line number Diff line change
Expand Up @@ -72,12 +72,11 @@ Main commands:
jobs Run and manage Jobs on the Hub.
models Interact with models on the Hub.
papers Interact with papers on the Hub.
repo Manage repos on the Hub.
repos Manage repos on the Hub.
skills Manage skills for AI assistants.
spaces Interact with spaces on the Hub.
sync Sync files between local directory and a bucket.
upload Upload a file or a folder to the Hub.
upload-large-folder [Deprecated] Use 'hf upload' instead.

Help commands:
env Print information about the environment.
Expand Down Expand Up @@ -433,7 +432,7 @@ By default, the `hf download` command will be verbose. It will print details suc
On machines with slow connections, you might encounter timeout issues like this one:

```bash
`httpx.TimeoutException: (TimeoutException("HTTPSConnectionPool(host='cdn-lfs-us-1.huggingface.co', port=443): Read timed out. (read timeout=10)"), '(Request ID: a33d910c-84c6-4514-8362-c705e2039d38)')`
`httpx2.TimeoutException: (TimeoutException("HTTPSConnectionPool(host='cdn-lfs-us-1.huggingface.co', port=443): Read timed out. (read timeout=10)"), '(Request ID: a33d910c-84c6-4514-8362-c705e2039d38)')`
```

To mitigate this issue, you can set the `HF_HUB_DOWNLOAD_TIMEOUT` environment variable to a higher value (default is 10):
Expand Down Expand Up @@ -602,19 +601,6 @@ By default, the `hf upload` command will be verbose. It will print details such
https://huggingface.co/Wauplin/my-cool-model/tree/main
```

## hf upload-large-folder

> [!WARNING]
> `hf upload-large-folder` is deprecated and will be removed in a future release. Use [`hf upload`](#hf-upload) instead. It now handles very large folders out of the box and resumes automatically on re-run.

```bash
# Upload a large folder to a model repository
>>> hf upload Wauplin/my-cool-model ./large_model_dir

# Upload a dataset
>>> hf upload Wauplin/my-cool-dataset ./large_data_dir --repo-type dataset
```

## hf buckets

Use `hf buckets` to manage buckets on the Hugging Face Hub. 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. They are designed for use cases where you need simple, fast, mutable storage such as storing training checkpoints, logs, intermediate artifacts, or any large collection of files that doesn't need version control. In the examples below, we will walk through the most common use cases. For a complete guide, see the [Buckets guide](./buckets).
Expand Down Expand Up @@ -1792,7 +1778,7 @@ Copy-and-paste the text below in your GitHub issue.
- Configured git credential helpers: store
- Installation method: unknown
- Torch: N/A
- httpx: 0.28.1
- httpx2: 2.0.0
- hf_xet: 1.1.10
- gradio: 5.41.1
- tensorboard: N/A
Expand Down Expand Up @@ -2114,10 +2100,6 @@ By default `hf jobs ps` displays at most 100 Jobs to avoid bloating the terminal
>>> hf jobs ps -a --limit 0
```

> [!WARNING]
> `-f`/`--filter` is deprecated in favor of `--status` and `--label`. Matching is exact: glob patterns (`data-*`) and negation (`key!=value`) are not supported, and filtering by `id`, `image` or `command` is not available.


### SSH into a Job

Pass `--ssh` to `hf jobs run` (or `hf jobs uv run`) to make the Job's container reachable over SSH, then connect with `hf jobs ssh`:
Expand Down
2 changes: 1 addition & 1 deletion docs/source/en/guides/inference.md
Original file line number Diff line number Diff line change
Expand Up @@ -389,7 +389,7 @@ print(completion.choices[0].message)

## Async client

An async version of the client is also provided, based on `asyncio` and `httpx`. All async API endpoints are available via [`AsyncInferenceClient`]. Its initialization and APIs are strictly the same as the sync-only version.
An async version of the client is also provided, based on `asyncio` and `httpx2`. All async API endpoints are available via [`AsyncInferenceClient`]. Its initialization and APIs are strictly the same as the sync-only version.

```py
# Code must be run in an asyncio concurrent context.
Expand Down
4 changes: 2 additions & 2 deletions docs/source/en/guides/sandbox.md
Original file line number Diff line number Diff line change
Expand Up @@ -123,12 +123,12 @@ Other helpers: `stat`, `exists`, `mkdir`, `delete`.
Start a server in the sandbox (in the background), then reach it from the outside with [`Sandbox.proxy_url_for`] — the request is forwarded by the in-job sandbox server to your inner server, so there's no extra public port to expose. It works for plain HTTP, Server-Sent Events and WebSocket. Pair the URL with [`Sandbox.proxy_headers`] for auth (your WebSocket/HTTP client must send them):

```python
>>> import httpx
>>> import httpx2
>>> with Sandbox.create() as sbx:
... sbx.files.write("app.py", "...") # a server exposing e.g. /hello and /ws
... sbx.run("uvicorn app:app --host 127.0.0.1 --port 8000", background=True)
... # plain HTTP
... r = httpx.get(sbx.proxy_url_for(8000, "/hello"), headers=sbx.proxy_headers)
... r = httpx2.get(sbx.proxy_url_for(8000, "/hello"), headers=sbx.proxy_headers)
... # WebSocket: ask for a wss:// URL
... ws_url = sbx.proxy_url_for(8000, "/ws", scheme="wss://")
```
Expand Down
3 changes: 0 additions & 3 deletions docs/source/en/guides/upload.md
Original file line number Diff line number Diff line change
Expand Up @@ -146,9 +146,6 @@ or from the terminal:
hf upload HuggingFaceM4/Docmatix --repo-type=dataset /path/to/local/docmatix
```

> [!WARNING]
> The legacy [`upload_large_folder`] method and `hf upload-large-folder` command are **deprecated** and will be removed in a future release. Use [`upload_folder`] / `hf upload` instead.

### Tips and tricks for large uploads

There are some limitations to be aware of when dealing with a large amount of data in your repo. Given the time it takes to stream the data, getting an upload/push to fail at the end of the process or encountering a degraded experience, be it on hf.co or when working locally, can be very annoying.
Expand Down
52 changes: 4 additions & 48 deletions docs/source/en/package_reference/cli.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,14 +40,13 @@ $ hf [OPTIONS] [COMMAND] [ARGS]...
* `lfs-multipart-upload`: Internal git-lfs custom transfer agent for multipart uploads.
* `models`: Interact with models on the Hub.
* `papers`: Interact with papers on the Hub.
* `repos`: Manage repos on the Hub. [alias: repo]
* `repos`: Manage repos on the Hub.
* `sandbox`: Run and manage experimental sandboxes on Hugging Face Jobs.
* `skills`: Manage skills for AI assistants.
* `spaces`: Interact with spaces on the Hub.
* `sync`: Sync files between local directory and a bucket.
* `update`: Update the `hf` CLI to the latest version.
* `upload`: Upload a file or a folder to the Hub.
* `upload-large-folder`: [Deprecated] Upload a large folder to the Hub.
* `version`: Print information about the hf version.
* `webhooks`: Manage webhooks on the Hub.

Expand Down Expand Up @@ -1815,7 +1814,7 @@ $ hf endpoints deploy [OPTIONS] NAME
* `--env-file TEXT`: Read in a file of environment variables. Use `-` to read them from stdin.
* `-s, --secrets TEXT`: Set secret environment variables. Prefer `--secrets SECRET` to read the value from your environment (e.g. `--secrets HF_TOKEN` to pass your Hugging Face token); `--secrets SECRET=value` puts the value in your shell history.
* `--secrets-file TEXT`: Read in a file of secret environment variables. Use `-` to read them from stdin.
* `--type [public|protected|authenticated|private]`: Endpoint access type. Defaults to 'authenticated' (token-gated, publicly reachable).
* `--type [public|authenticated|private]`: Endpoint access type. Defaults to 'authenticated' (token-gated, publicly reachable).
* `--help`: Show this message and exit.

Examples
Expand Down Expand Up @@ -2424,7 +2423,6 @@ $ hf jobs list | ls | ps [OPTIONS]
* `--limit INTEGER`: Maximum number of Jobs to display. Set to 0 to show all (no limit). [default: 100]
* `--namespace TEXT`: The namespace where the job will be running. Defaults to the current user's namespace.
* `--token TEXT`: A User Access Token generated from https://huggingface.co/settings/tokens.
* `-f, --filter TEXT`: (Deprecated) Use `--status` and `--label` instead.
* `--help`: Show this message and exit.

Examples
Expand Down Expand Up @@ -2668,7 +2666,6 @@ $ hf jobs scheduled list | ls | ps [OPTIONS]
* `--name TEXT`: Only show scheduled Jobs with the given name (shortcut for `--label name=NAME`).
* `--namespace TEXT`: The namespace where the job will be running. Defaults to the current user's namespace.
* `--token TEXT`: A User Access Token generated from https://huggingface.co/settings/tokens.
* `-f, --filter TEXT`: (Deprecated) Use `--status` and `--label` instead.
* `--help`: Show this message and exit.

Examples
Expand Down Expand Up @@ -3374,12 +3371,12 @@ Learn more

## `hf repos`

Manage repos on the Hub. [alias: repo]
Manage repos on the Hub.

**Usage**:

```console
$ hf repos [OPTIONS] [COMMAND] [ARGS]...
$ hf repos [OPTIONS] COMMAND [ARGS]...
```

**Options**:
Expand Down Expand Up @@ -3548,7 +3545,6 @@ $ hf repos create [OPTIONS] REPO_ID
* `--resource-group-id TEXT`: Resource group in which to create the repo. Resource groups is only available for Enterprise Hub organizations.
* `--region [us|eu]`: Cloud region in which to create the repo. Can be one of 'us' or 'eu'. Requires Team plan or above.
* `--flavor [cpu-basic|cpu-upgrade|zero-a10g|t4-small|t4-medium|l4x1|l4x4|l40sx1|l40sx4|l40sx8|a10g-small|a10g-large|a10g-largex2|a10g-largex4|a100-large|a100x4|a100x8]`: Space hardware flavor (e.g. 'cpu-basic', 't4-medium', 'l4x4'). Only for Spaces.
* `--storage [small|medium|large]`: (Deprecated, use volumes instead) Space persistent storage tier ('small', 'medium', or 'large'). Only for Spaces.
* `--sleep-time INTEGER`: Seconds of inactivity before the Space is put to sleep. Use -1 to disable. Only for Spaces.
* `-s, --secrets TEXT`: Set secret environment variables. Prefer `--secrets SECRET` to read the value from your environment (e.g. `--secrets HF_TOKEN` to pass your Hugging Face token); `--secrets SECRET=value` puts the value in your shell history.
* `--secrets-file TEXT`: Read in a file of secret environment variables. Use `-` to read them from stdin.
Expand Down Expand Up @@ -3659,7 +3655,6 @@ $ hf repos duplicate [OPTIONS] FROM_ID [TO_ID]
* `--token TEXT`: A User Access Token generated from https://huggingface.co/settings/tokens.
* `--exist-ok / --no-exist-ok`: Do not raise an error if repo already exists. [default: no-exist-ok]
* `--flavor [cpu-basic|cpu-upgrade|zero-a10g|t4-small|t4-medium|l4x1|l4x4|l40sx1|l40sx4|l40sx8|a10g-small|a10g-large|a10g-largex2|a10g-largex4|a100-large|a100x4|a100x8]`: Space hardware flavor (e.g. 'cpu-basic', 't4-medium', 'l4x4'). Only for Spaces.
* `--storage [small|medium|large]`: (Deprecated, use volumes instead) Space persistent storage tier ('small', 'medium', or 'large'). Only for Spaces.
* `--sleep-time INTEGER`: Seconds of inactivity before the Space is put to sleep. Use -1 to disable. Only for Spaces.
* `-s, --secrets TEXT`: Set secret environment variables. Prefer `--secrets SECRET` to read the value from your environment (e.g. `--secrets HF_TOKEN` to pass your Hugging Face token); `--secrets SECRET=value` puts the value in your shell history.
* `--secrets-file TEXT`: Read in a file of secret environment variables. Use `-` to read them from stdin.
Expand Down Expand Up @@ -4313,7 +4308,6 @@ $ hf skills add [OPTIONS] [NAME]

**Options**:

* `--claude`: (Deprecated) No longer needed: skills are always installed for Claude Code too.
* `-g, --global`: Install globally (user-level) instead of in the current project directory.
* `--dest PATH`: Install into a custom destination (path to skills directory).
* `--force`: Overwrite existing skills in the destination.
Expand Down Expand Up @@ -4384,7 +4378,6 @@ $ hf skills update [OPTIONS] [NAME]

**Options**:

* `--claude`: (Deprecated) No longer needed: skills are always installed for Claude Code too.
* `-g, --global`: Use global skills directories instead of the current project.
* `--dest PATH`: Update skills in a custom skills directory.
* `--help`: Show this message and exit.
Expand Down Expand Up @@ -5307,43 +5300,6 @@ Learn more
Read the documentation at https://huggingface.co/docs/huggingface_hub/en/guides/cli


## `hf upload-large-folder`

[Deprecated] Upload a large folder to the Hub. Use `hf upload` instead.

**Usage**:

```console
$ hf upload-large-folder [OPTIONS] REPO_ID LOCAL_PATH
```

**Arguments**:

* `REPO_ID`: The ID of the repo (e.g. `username/repo-name` or `spaces/username/repo-name`). [required]
* `LOCAL_PATH`: Local path to the folder to upload. [required]

**Options**:

* `--type, --repo-type [model|dataset|space|kernel]`: The type of repository (model, dataset, space, or kernel). [default: model]
* `--revision TEXT`: Git revision id which can be a branch name, a tag, or a commit hash.
* `--private / --no-private`: Whether to create a private repo if repo doesn't exist on the Hub. Ignored if the repo already exists.
* `--include TEXT`: Glob patterns to match files to upload.
* `--exclude TEXT`: Glob patterns to exclude from files to upload.
* `--token TEXT`: A User Access Token generated from https://huggingface.co/settings/tokens.
* `--num-workers INTEGER`: Number of workers to use to hash, upload and commit files.
* `--no-report / --no-no-report`: Whether to disable regular status report. [default: no-no-report]
* `--no-bars / --no-no-bars`: Whether to disable progress bars. [default: no-no-bars]
* `--help`: Show this message and exit.

Examples
$ hf upload-large-folder Wauplin/my-cool-model ./large_model_dir
$ hf upload-large-folder Wauplin/my-cool-model ./large_model_dir --revision v1.0

Learn more
Use `hf <command> --help` for more information about a command.
Read the documentation at https://huggingface.co/docs/huggingface_hub/en/guides/cli


## `hf version`

Print information about the hf version.
Expand Down
2 changes: 1 addition & 1 deletion docs/source/en/package_reference/inference_client.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ for more information on how to use it.

## Async Inference Client

An async version of the client is also provided, based on `asyncio` and `httpx`.
An async version of the client is also provided, based on `asyncio` and `httpx2`.

[[autodoc]] AsyncInferenceClient

Expand Down
1 change: 0 additions & 1 deletion docs/source/en/package_reference/space_runtime.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,6 @@ rendered properly in your Markdown viewer.

Check the [`HfApi`] documentation page for the reference of methods to manage your Space on the Hub.

- Duplicate a Space: [`duplicate_space`]
- Fetch current runtime: [`get_space_runtime`]
- Fetch build or run logs: [`fetch_space_logs`]
- Manage secrets: [`add_space_secret`] and [`delete_space_secret`]
Expand Down
Loading