HF Toate componentele Hugging Face Hub & Transformers

`hf auth (login, logout, switch, list, token, whoami)` în Hugging Face Hub & Transformers

CLI hf: Cont, Fișiere și Cache huggingface_hub 2.3 / CLI hf (octombrie 2026)

Autentificarea la Hugging Face Hub din terminal: login prin browser sau cu token, schimbarea între tokenuri salvate, afișarea contului și a tokenului curent.

Sintaxă & invocare Python

hf auth login [--token TOKEN] [--add-to-git-credential] [--force]
hf auth logout [--token-name NUME]
hf auth switch [--token-name NUME]
hf auth list | token | whoami

Ce face `hf auth (login, logout, switch, list, token, whoami)`

hf auth login te conectează la contul Hugging Face. Implicit pornește autentificarea prin browser: afișează un URL și un cod scurt, tu deschizi URL-ul, introduci codul și aprobi cererea, apoi CLI-ul salvează un token de acces pe calculator. Tokenul expiră după un timp, dar se reîmprospătează automat cât timp îl folosești. Poți alege și varianta cu un User Access Token creat în huggingface.co/settings/tokens, interactiv sau cu --token.

Dacă ești deja autentificat, login sare peste întrebări; --force forțează o nouă autentificare. Comanda este interactivă, deci nu acceptă --format json sau --format quiet; în scripturi folosești --token. Când este rulată de un agent AI (sau cu --format agent), nu pune întrebări: afișează instrucțiuni pe care agentul le transmite utilizatorului și așteaptă aprobarea.

hf auth logout șterge toate tokenurile salvate, sau doar unul cu --token-name. Nu te deconectează dacă tokenul vine din variabila HF_TOKEN; pe aceasta trebuie să o ștergi din configurația mediului. hf auth list (alias ls) arată tokenurile salvate, switch schimbă tokenul activ, token afișează tokenul curent la ieșirea standard, iar whoami arată utilizatorul și organizațiile din care faci parte.

Sintaxă și opțiuni

Opțiune / Parametru	Descriere
`login --token TEXT`	Token creat în huggingface.co/settings/tokens. Documentația recomandă să-l dai din variabilă de mediu (`$HF_TOKEN`), nu scris în comandă.
`login --add-to-git-credential / --no-add-to-git-credential`	Salvează tokenul și în git credential helper. Util doar dacă rulezi comenzi git direct. Implicit dezactivat.
`login --force / --no-force`	Autentificare nouă chiar dacă ești deja conectat.
`logout --token-name TEXT`	Numele tokenului de șters. Fără el se șterg toate.
`switch --token-name TEXT`	Tokenul la care treci. Acceptă și `--add-to-git-credential`.
`list (ls)`	Listează tokenurile salvate.
`token`	Afișează tokenul activ la stdout.
`whoami`	Afișează contul conectat și organizațiile. Acceptă `--format json`.

Exemple practice

Exemplul 1: Autentificare prin browser

hf auth login

Exemplul 2: Autentificare cu token din variabilă de mediu

hf auth login --token $HF_TOKEN --add-to-git-credential

Exemplul 3: Verificarea contului

hf auth whoami

Rezultat

Wauplin
orgs:  huggingface,eu-test,OAuthTesters,hf-accelerate,HFSmolCluster

Exemplul 4: Tokenul curent într-un apel HTTP

hf auth token | xargs curl -H 'Authorization: Bearer {}'

Exemplul 5: Schimbarea tokenului activ

hf auth switch --token-name my-token

Greșeli frecvente și bune practici

Scrii tokenul direct în comandă. Ajunge în istoricul shell-ului; folosește login prin browser, $HF_TOKEN sau varianta interactivă.
Rulezi hf auth logout și te miri că ești încă autentificat. Dacă HF_TOKEN este setat, el are prioritate; șterge variabila.
Folosești --add-to-git-credential fără motiv. Este necesar doar pentru comenzi git rulate direct pe repository-uri Hugging Face.

Ce face hf auth (login, logout, switch, list, token, whoami)