Apps

Hugging Face Xet Cache

Hugging Face Xet stores transfer cache data under ~/.cache/huggingface/xet to speed repeated downloads and uploads through its chunk-based content store. That cache typically contains deduplicated chunk data, local transfer staging files, and metadata used to resume or avoid re-fetching objects from the Hub. Kudu removes only the Xet transfer cache, including older cached chunks and temporary transfer state, while leaving downloaded models, datasets, repositories, account credentials, and user settings untouched.

Why it matters

Why clean Hugging Face Xet Cache?

  • Corrupted cached chunks can cause repeated checksum mismatches or failed fetches, which you would see as downloads that restart, stall, or abort during huggingface-cli or library pulls
  • Old transfer staging files accumulate after interrupted uploads or downloads, wasting gigabytes of disk space and showing up as a large ~/.cache/huggingface/xet folder even after the job is gone
  • Cache entries created for older transfer sessions can confuse resume logic, leading to fetches that appear stuck verifying or rechecking data instead of progressing normally
  • When the local Xet cache grows without cleanup, deduplicated chunk storage can crowd out free space and cause new model or dataset transfers to fail with no-space-left errors
  • Stale local metadata may keep the client reusing bad transfer state, which shows up as the same file failing at the same point until the cache is reset
  • Shared machines and CI runners often keep Xet cache data from previous jobs, causing unexpectedly large workspaces and slower cleanup between runs
  • Resetting transfer caches older than seven days removes obsolete chunk and temp data while preserving Hub models, datasets, and credentials, though the next transfer may be slower because the cache has to warm again
What gets cleaned

Cache paths Kudu targets

Windows

~/.cache/huggingface/xet

macOS

~/.cache/huggingface/xet

Linux

~/.cache/huggingface/xet
Frequently asked

Common questions about Hugging Face Xet Cache

Free & open source

Download Kudu and reclaim your disk space.

Available on Windows, macOS, and Linux. No account required, no feature gates, no telemetry without consent. All cleaning targets are open source and community-auditable.