hf spaces pause / restart / wait / logs / settings / dev-mode / ssh / hot-reload / zero-gpu în Hugging Face Hub & Transformers

hf spaces pause | restart | wait | logs | settings | dev-mode | ssh SPACE_ID [opțiuni]
hf spaces hot-reload SPACE_ID [FIȘIER] [-f FIȘIER_LOCAL]
hf spaces zero-gpu quota

Ce face hf spaces pause / restart / wait / logs / settings / dev-mode / ssh / hot-reload / zero-gpu

hf spaces pause oprește un Space (timpul în pauză nu se facturează), iar restart îl repornește; --factory-reboot îl reconstruiește de la zero, fără cache de build. Pauza și repornirea distrug containerul, deci ce este scris în sistemul de fișiere efemer se pierde; pentru date persistente montezi un volum sau un bucket. hf spaces wait blochează până când Space-ul ajunge într-o stare stabilă și iese cu cod 0 doar dacă starea este RUNNING.

logs afișează logurile de rulare (sau de build cu --build, util la BUILD_ERROR), opțional urmărite live (-f). settings schimbă timpul de adormire și hardware-ul. dev-mode pornește sau oprește Dev Mode (pornirea cere plan PRO sau Team & Enterprise), iar ssh deschide o sesiune SSH în containerul Dev Mode, cu cheia publică înregistrată în huggingface.co/settings/keys.

hot-reload (experimental, doar Gradio 6.1+) actualizează un fișier Python al Space-ului fără rebuild și repornire; fără -f deschide un editor interactiv. Comanda creează un commit în repository, deci dintr-o clonă locală rulezi apoi git pull --autostash. hf spaces zero-gpu quota arată cât din cota ZeroGPU (în secunde GPU) a rămas și când se resetează.

Sintaxă și opțiuni

Opțiune / Parametru	Descriere
restart --factory-reboot	Reconstruiește Space-ul fără cache de build.
wait --timeout TEXT	Timp maxim de așteptare (s implicit, sau m, h, d).
logs --build	Logurile de build în loc de cele de rulare.
logs -f, --follow	Urmărește logurile live.
logs -n, --tail INTEGER	Ultimele N linii.
settings --sleep-time INTEGER	Secunde de inactivitate până la adormire; -1 = niciodată. Doar pe hardware plătit.
settings --hardware [...]	Hardware-ul, de exemplu cpu-basic, t4-medium, l4x4.
dev-mode --stop	Oprește Dev Mode (permis mereu).
ssh -i, --identity-file PATH	Cheia SSH folosită (transmisă la ssh -i).
ssh --dry-run	Afișează comanda SSH fără să o ruleze.
ssh --auto	Pornește Dev Mode fără întrebare, dacă e oprit.
hot-reload [FILENAME]	Fișierul Python din Space.
hot-reload -f, --local-file PATH	Versiunea locală trimisă; fără ea se deschide editorul.
hot-reload --skip-checks / --skip-summary	Sare peste verificările de compatibilitate / rezumatul final.
zero-gpu quota	Cota ZeroGPU rămasă; cu --quiet doar secundele rămase.
--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: Repornire și așteptare

hf spaces restart username/my-space && hf spaces wait username/my-space

Exemplul 2: Logurile de build

hf spaces logs username/my-space --build

Exemplul 3: Hardware GPU

hf spaces settings username/my-space --hardware t4-medium

Exemplul 4: SSH cu pornirea automată a Dev Mode

hf spaces ssh username/my-space --auto

Exemplul 5: Patch din fișierul local app.py

hf spaces hot-reload username/repo-name -f app.py

Exemplul 6: Cota ZeroGPU

hf spaces zero-gpu quota --format json

Rezultat

{"remaining": 1810, "base": 2400, "resets_at": "2026-09-30T18:12:03+00:00", "overquota_used": 0}

Greșeli frecvente și bune practici

• Salvezi date în containerul Space-ului și apoi dai restart. Sistemul de fișiere este efemer; montează un volum cu hf spaces volumes set.
• Setezi --sleep-time pe hardware gratuit. Opțiunea este disponibilă doar pe hardware plătit.
• Folosești hot-reload pe un Space Docker. Funcția merge doar cu SDK-ul Gradio 6.1+.

Comenzi înrudite

• hf-spaces
• hf-spaces-secrets-variabile-volume
• huggingface-spaces
• gradio-interface