[docs update] Update usage of `hf` cli for cache list and removal (#47830)
Signed-off-by: Aritra Roy Gosthipaty <aritra.born2fly@gmail.com>
Aritra Roy Gosthipaty committed
Jul 7, 2026 at 12:39 UTC
1e823dc01d5c3f396ce810afc2daa33c79d9a201
1 file changed
+7
-33
docs/models/supported_models.md
+7
-33
@@ -242,50 +242,24 @@ Use the Hugging Face CLI to [manage models](https://huggingface.co/docs/huggingf
242
243
```bash
244
# List cached models
245
-hf scan-cache
245
+hf cache list -q
246
247
# Show detailed (verbose) output
248
-hf scan-cache -v
248
+hf cache list
249
250
# Specify a custom cache directory
251
-hf scan-cache --dir ~/.cache/huggingface/hub
251
+hf cache list --dir ~/.cache/huggingface/hub
252
```
253
254
#### Delete a cached model
255
256
-Use the Hugging Face CLI to interactively [delete downloaded model](https://huggingface.co/docs/huggingface_hub/guides/manage-cache#clean-your-cache) from the cache:
256
+Use the Hugging Face CLI to [delete downloaded model](https://huggingface.co/docs/huggingface_hub/guides/manage-cache#clean-your-cache) from the cache:
257
258
-<details>
259
-<summary>Commands</summary>
260
-
261
-```console
262
-# The `delete-cache` command requires extra dependencies to work with the TUI.
263
-# Please run `pip install huggingface_hub[cli]` to install them.
264
-
265
-# Launch the interactive TUI to select models to delete
266
-$ hf delete-cache
267
-? Select revisions to delete: 1 revisions selected counting for 438.9M.
268
- ○ None of the following (if selected, nothing will be deleted).
269
-Model BAAI/bge-base-en-v1.5 (438.9M, used 1 week ago)
270
-❯ ◉ a5beb1e3: main # modified 1 week ago
271
-
272
-Model BAAI/bge-large-en-v1.5 (1.3G, used 1 week ago)
273
- ○ d4aa6901: main # modified 1 week ago
274
-
275
-Model BAAI/bge-reranker-base (1.1G, used 4 weeks ago)
276
- ○ 2cfc18c9: main # modified 4 weeks ago
277
-
278
-Press <space> to select, <enter> to validate and <ctrl+c> to quit without modification.
279
-
280
-# Need to confirm after selected
281
-? Select revisions to delete: 1 revision(s) selected.
282
-? 1 revisions selected counting for 438.9M. Confirm deletion ? Yes
283
-Start deletion.
284
-Done. Deleted 1 repo(s) and 0 revision(s) for a total of 438.9M.
258
+```bash
259
+# delete all the cached objects
260
+hf cache rm $(hf cache list -q)
261
```
262
287
-</details>
288
-
263
#### Using a proxy
264
265
Here are some tips for loading/downloading models from Hugging Face using a proxy: