huggingface-cli (eliminat) în Hugging Face Hub & Transformers

huggingface-cli ...   (eliminat)
hf auth login | hf download | hf upload | hf cache ls

Ce face huggingface-cli (eliminat)

huggingface-cli a fost utilitarul de terminal al pachetului huggingface_hub. Începând cu v0.34 a apărut hf, un CLI organizat pe resurse și acțiuni (hf auth login, hf repos create, hf cache ls). Ghidul de migrare la v1.0 descrie huggingface-cli ca depreciat și eliminat, iar ghidul pentru v2.0 cere explicit folosirea lui hf în locul lui.

Instrucțiunile vechi cu huggingface-cli login, download, upload, scan-cache sau delete-cache trebuie traduse în comenzile hf din tabelul de mai jos. Odată cu migrarea au dispărut și accelerarea hf_transfer (variabila HF_HUB_ENABLE_HF_TRANSFER este ignorată) și opțiunea --local-dir-use-symlinks.

Tokenul salvat la autentificare este tot în ~/.cache/huggingface/token (sau în HF_TOKEN_PATH), iar HF_TOKEN are prioritate față de el.

Sintaxă și opțiuni

Opțiune / Parametru	Descriere
huggingface-cli login / logout / whoami	hf auth login, hf auth logout, hf auth whoami; în plus hf auth list, switch, token.
huggingface-cli download	hf download.
huggingface-cli upload	hf upload (împarte singur directoarele mari în commit-uri).
huggingface-cli repo-files ... delete	hf repos delete-files.
huggingface-cli scan-cache	hf cache ls.
huggingface-cli delete-cache	hf cache rm și hf cache prune.
huggingface-cli tag	hf repos tag create / list / delete.
huggingface-cli env	hf env.
HF_HUB_ENABLE_HF_TRANSFER=1	Ignorată. Pentru transferuri rapide: HF_XET_HIGH_PERFORMANCE=1.

Exemple practice

Exemplul 1: Autentificare (în loc de huggingface-cli login)

hf auth login

Exemplul 2: Un singur fișier GGUF dintr-un repository

hf download bartowski/Llama-3.2-3B-Instruct-GGUF Llama-3.2-3B-Instruct-Q4_K_M.gguf --local-dir .

Exemplul 3: Încărcarea unui director (în loc de huggingface-cli upload)

hf upload user/modelul-meu ./folder_local .

Exemplul 4: Cât ocupă cache-ul (în loc de scan-cache)

hf cache ls

Exemplul 5: Curățarea reviziilor nefolosite (în loc de delete-cache)

hf cache prune

Greșeli frecvente și bune practici

• Copiezi comenzi huggingface-cli din tutoriale sau README-uri vechi. Traduce-le în hf; în huggingface_hub 2.x vechiul utilitar nu mai există.
• Activezi hf_transfer pentru viteză. Suportul a fost scos; descărcările trec prin hf_xet, iar modul rapid se activează cu HF_XET_HIGH_PERFORMANCE=1.
• Cauți meniul interactiv al lui delete-cache. A fost înlocuit de hf cache rm (cu --dry-run pentru previzualizare) și hf cache prune.

Comenzi înrudite

• hf-cli
• hf-auth
• hf-download
• hf-upload
• hf-cache