●Change8

Migrating to HuggingFace Hub v1.18.0

Version v1.18.0 introduces 1 breaking change. This guide details how to update your code.

Released: 6/5/2026

1
Breaking Changes
1
Migration Steps
6
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

hf cphf repos cphf buckets cpparse_hf_urihf_hub_downloadhf repos ls

Breaking Changes

●Issue #1

Resuming a previously failed partial download is no longer possible due to a change ensuring concurrent download safety across various file systems (Lustre, GPFS, NFS) where file locking might fail silently. This change forces downloads to a fresh temporary file instead of resuming incomplete ones. This is only relevant if `hf_xet` was disabled.

Migration Steps

  1. 1
    If you relied on resuming partial downloads for files when `hf_xet` was disabled, be aware that this functionality is removed. Downloads will restart from scratch if interrupted.

Release Summary

This release introduces a unified `hf cp` command for all file operations and enhances URI parsing to accept web URLs. A critical fix was implemented to ensure concurrent download safety, which removes support for resuming partial downloads in specific file system scenarios.

Need More Details?

View the full release notes and all changes for HuggingFace Hub v1.18.0.

View Full Changelog