hf spaces secrets / variables / volumes în Hugging Face Hub & Transformers

hf spaces secrets add SPACE_ID -s CHEIE[=VAL] | ls SPACE_ID | delete SPACE_ID CHEIE
hf spaces variables add SPACE_ID -e CHEIE=VAL | ls SPACE_ID | delete SPACE_ID CHEIE
hf spaces volumes set SPACE_ID -v hf://...:/CALE | ls SPACE_ID | delete SPACE_ID

Ce face hf spaces secrets / variables / volumes

hf spaces secrets gestionează valori sensibile (chei API, tokenuri). add adaugă sau actualizează unul sau mai multe secrete, din -s sau dintr-un fișier de tip .env (--secrets-file); cheile existente sunt suprascrise. Valorile secretelor se pot doar scrie: ls arată cheile, descrierile și data actualizării, nu și valorile.

hf spaces variables gestionează variabile de mediu nesensibile. Spre deosebire de secrete, ele pot fi citite, deci ls arată și valorile. add acceptă -e sau --env-file.

hf spaces volumes set înlocuiește volumele montate în Space (modele, dataset-uri, Spaces sau buckets, prin URI-uri hf://); ls le listează, iar delete le scoate pe toate. Modelele, dataset-urile și Spaces se montează doar pentru citire; bucket-urile sunt implicit citire și scriere.

Sintaxă și opțiuni

Opțiune / Parametru	Descriere
secrets add -s, --secrets TEXT	-s NUME citește valoarea din mediul tău; -s NUME=valoare o lasă în istoricul shell-ului.
secrets add --secrets-file TEXT	Fișier cu secrete; - citește din stdin.
secrets ls / delete SPACE_ID KEY [-y]	Listare (fără valori) / ștergere.
variables add -e, --env TEXT	Variabilă CHEIE=valoare; se poate repeta.
variables add --env-file TEXT	Fișier .env; - pentru stdin.
variables ls / delete SPACE_ID KEY [-y]	Listare (cu valori) / ștergere.
volumes set -v, --volume TEXT	Format hf://[TIP/]SURSĂ:/CALE[:ro]; TIP este models, datasets, spaces sau buckets.
volumes ls / delete [-y]	Listare / eliminarea tuturor volumelor.
--token TEXT	Token de acces (User Access Token) creat în huggingface.co/settings/tokens. Implicit se folosește tokenul salvat de hf auth login.

Exemple practice

Exemplul 1: Secret citit din mediul local

hf spaces secrets add username/my-space -s HF_TOKEN

Exemplul 2: Secrete dintr-un fișier

hf spaces secrets add username/my-space --secrets-file .env.secrets

Exemplul 3: Două variabile de mediu

hf spaces variables add username/my-space -e MODEL_ID=gpt2 -e MAX_TOKENS=512

Exemplul 4: Ștergerea unei variabile fără confirmare

hf spaces variables delete username/my-space MAX_TOKENS --yes

Exemplul 5: Bucket (citire-scriere) și dataset (doar citire)

hf spaces volumes set username/my-space -v hf://buckets/username/my-bucket:/data -v hf://datasets/username/my-dataset:/datasets:ro

Greșeli frecvente și bune practici

• Pui chei API ca variabile. Variabilele se pot citi; pentru valori sensibile folosește secrets.
• Scrii -s CHEIE=valoare pentru secrete reale. Valoarea ajunge în istoricul shell-ului; folosește -s CHEIE cu valoarea în mediu sau --secrets-file.
• Rulezi volumes set cu un singur volum crezând că se adaugă. Comanda înlocuiește toată lista de volume.

Comenzi înrudite

• hf-spaces-gestionare
• hf-spaces
• hf-buckets
• huggingface-spaces