hf repos (create, list, duplicate, move, settings, delete, delete-files) în Hugging Face Hub & Transformers

hf repos create | list | duplicate | move | settings | delete | delete-files | branch | tag | cp ...

Ce face hf repos (create, list, duplicate, move, settings, delete, delete-files)

hf repos create creează un repository; pentru un Space trebuie dat SDK-ul cu --sdk, iar opțional hardware-ul, secretele, variabilele, volumele sau un șablon oficial (--template). hf repos list (alias ls) arată repository-urile tale (inclusiv buckets) ordonate după spațiul ocupat; implicit primele 30, toate cu --limit 0.

duplicate copiază pe server un model, dataset sau Space în contul tău sau al unei organizații, cu tot istoricul git; fișierele LFS/Xet se pot copia în fundal și după ce comanda se termină. move mută un repository în alt namespace. settings schimbă accesul controlat (--gated) și vizibilitatea.

delete șterge ireversibil un repository. delete-files șterge fișiere după modele glob într-un commit (opțional ca pull request). Potrivirea folosește fnmatch, unde * trece și peste /: data/*.json prinde și data/subdir/file.json.

Sintaxă și opțiuni

Opțiune / Parametru	Descriere
--type, --repo-type [model|dataset|space|kernel]	Tipul repository-ului. Implicit model.
create --sdk, --space-sdk TEXT	SDK-ul Space-ului. Obligatoriu când tipul este space.
create --template TEXT	Creează un Space dintr-un șablon oficial (vezi hf spaces templates).
--private / --no-private, --public, --protected	Vizibilitatea la creare sau duplicare (--protected doar pentru Spaces).
--exist-ok	Fără eroare dacă repository-ul există.
--resource-group-id TEXT	Grupul de resurse (organizații Enterprise).
create --region [us|eu]	Regiunea de stocare. Necesită planul Team sau superior.
--flavor [...]	Hardware-ul Space-ului (de exemplu cpu-basic, t4-medium, l4x4).
--sleep-time INTEGER	Secunde de inactivitate până la adormirea Space-ului; -1 dezactivează.
-s, --secrets / --secrets-file	Secrete pentru Space. --secrets NUME citește valoarea din mediul tău.
-e, --env / --env-file	Variabile de mediu pentru Space.
-v, --volume TEXT	Volume montate: hf://[TIP/]SURSĂ:/CALE[:ro].
list --namespace / --type / --search / --limit	Filtre; --type acceptă și bucket. Implicit 30 de rezultate.
list --explore	Explorează repository-urile ca un oraș 3D interactiv.
duplicate FROM_ID [TO_ID]	Destinația implicită: namespace-ul tău, același nume.
move FROM_ID TO_ID	Mută repository-ul.
settings --gated [auto|manual|false]	Accesul controlat la repository.
delete --missing-ok, -y	Fără eroare dacă lipsește / fără confirmare.
delete-files PATTERNS...	Modele glob ale fișierelor de șters.
delete-files --revision / --commit-message / --commit-description / --create-pr	Ramura, mesajul commit-ului și deschiderea unui PR.
--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: Model nou

hf repos create Wauplin/my-cool-model

Rezultat

Successfully created Wauplin/my-cool-model on the Hub.
Your repo is now available at https://huggingface.co/Wauplin/my-cool-model

Exemplul 2: Space Gradio cu hardware și secret

hf repos create my-space --type space --sdk gradio --flavor t4-medium --secrets HF_TOKEN -e THEME=dark --protected

Exemplul 3: Duplicarea unui dataset într-o organizație

hf repos duplicate openai/gdpval myorg/my-gdpval --type dataset --private

Exemplul 4: Repository-urile unei organizații, ca JSON

hf repos ls --namespace my-org --limit 0 --format json

Exemplul 5: Acces controlat automat

hf repos settings Wauplin/my-cool-model --gated auto

Exemplul 6: Ștergerea unor fișiere după model

hf repos delete-files Wauplin/my-cool-model "*.txt" "folder/*.bin"

Greșeli frecvente și bune practici

• Creezi un Space fără --sdk. Pentru tipul space opțiunea este obligatorie.
• Folosești data/*.json crezând că prinde doar primul nivel. fnmatch trece peste directoare; listează fișierele explicit dacă vrei doar primul nivel.
• Cauți hf repo sau hf repo-files delete. Au fost înlocuite de hf repos și hf repos delete-files în huggingface_hub 2.0.

Comenzi înrudite

• hf-repos-branch-tag
• hf-upload
• hf-spaces
• hf-cp