hf buckets (create, list, info, settings, move, remove, delete) în Hugging Face Hub & Transformers

hf buckets create | list | info | settings | move | remove | delete | cp | sync ...

Ce face hf buckets (create, list, info, settings, move, remove, delete)

Bucket-urile sunt containere de stocare de obiecte pe Hugging Face, construite pe backend-ul Xet. Spre deosebire de repository-uri (bazate pe git, cu istoric), ele sunt stocare modificabilă, cu deduplicare după conținut, gândită pentru checkpoint-uri de antrenare, loguri, artefacte intermediare sau colecții mari de fișiere care nu au nevoie de versiuni.

hf buckets create creează un bucket în spațiul tău de nume (sau în al unei organizații). list (alias ls) listează bucket-urile, iar cu un ID de bucket listează fișierele din el, cu -R, -h și --tree. info afișează detaliile ca JSON, settings schimbă vizibilitatea, move redenumește sau mută bucket-ul.

remove (alias rm) șterge fișiere: unul singur, sau cu --recursive tot ce este sub un prefix, opțional filtrat cu --include / --exclude. delete șterge bucket-ul întreg cu tot conținutul. Copierea și sincronizarea au pagini separate (hf cp, hf sync).

Sintaxă și opțiuni

Opțiune / Parametru	Descriere
create BUCKET_ID	Creează bucket-ul (nume, namespace/nume sau hf://buckets/namespace/nume).
create --private	Bucket privat.
create --region [us|eu]	Regiunea de stocare. Necesită planul Team sau superior.
create --exist-ok	Fără eroare dacă bucket-ul există deja.
list [ARGUMENT]	Fără argument sau cu un namespace: listează bucket-uri. Cu un ID de bucket (opțional cu prefix): listează fișiere.
list -h, --human-readable	Dimensiuni ușor de citit.
list --tree / -R, --recursive	Afișare arborescentă / recursivă (doar pentru fișiere).
list --search TEXT	Filtrează după nume.
info BUCKET_ID	Detalii despre bucket, ca JSON.
settings --private / --public	Schimbă vizibilitatea.
move FROM_ID TO_ID	Redenumește sau mută bucket-ul în alt namespace.
remove ARGUMENT	Calea fișierului de șters. Cu --recursive acceptă și bucket-ul întreg.
remove -R, --recursive	Șterge recursiv sub prefixul dat.
remove --include / --exclude TEXT	Filtre pe fișiere; cer --recursive.
remove --dry-run	Arată ce ar fi șters, fără ștergere.
delete BUCKET_ID	Șterge bucket-ul și tot conținutul.
delete --missing-ok	Fără eroare dacă bucket-ul nu există.
-y, --yes	Sare peste confirmare (remove, delete).
--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: Bucket privat nou

hf buckets create my-bucket --private

Exemplul 2: Lista bucket-urilor, cu dimensiuni ușor de citit

hf buckets list -h

Rezultat

ID                   PRIVATE     SIZE TOTAL_FILES CREATED_AT
-------------------- ------- -------- ----------- ----------
username/my-bucket               32 B           5 2026-02-16
username/checkpoints         117.6 MB         700 2026-02-13
username/logs                321.8 MB        2000 2026-02-13

Exemplul 3: Fișierele dintr-un bucket, ca arbore

hf buckets list username/my-bucket --tree -h -R

Exemplul 4: Previzualizarea unei ștergeri recursive

hf buckets rm username/my-bucket/checkpoints/ --recursive --dry-run

Exemplul 5: Bucket făcut public

hf buckets settings username/my-bucket --public

Exemplul 6: Ștergerea bucket-ului, fără confirmare

hf buckets delete username/my-bucket --yes

Greșeli frecvente și bune practici

• Confunzi hf buckets rm (șterge fișiere) cu hf buckets delete (șterge tot bucket-ul).
• Folosești --include la rm fără --recursive. Filtrele cer modul recursiv.
• Pui în bucket date care au nevoie de istoric. Bucket-urile nu păstrează versiuni; pentru asta folosești un repository.

Comenzi înrudite

• hf-sync
• hf-cp
• hf-repos
• hf-jobs-run