hf collections în Hugging Face Hub & Transformers

hf collections ls | info | create | update | delete ...
hf collections add-item | update-item | delete-item COLLECTION_SLUG ...

Ce face hf collections

Colecțiile grupează elemente de pe Hub sub un titlu. hf collections ls (alias list) le listează, filtrate după proprietar sau după un element conținut. info afișează o colecție, inclusiv câmpul item_object_id al fiecărui element.

create creează o colecție (implicit în contul tău, sau în organizația dată cu --namespace), update schimbă titlul, descrierea, poziția, vizibilitatea sau culoarea temei, iar delete o șterge.

add-item adaugă un element după ID-ul lui și tip (model, dataset, space, paper, collection, bucket), cu o notă opțională. update-item și delete-item folosesc item_object_id din info, nu ID-ul repository-ului.

Sintaxă și opțiuni

Opțiune / Parametru	Descriere
ls --owner TEXT	Proprietarul (utilizator sau organizație).
ls --item TEXT	Colecțiile care conțin un element (de exemplu models/gpt2, papers/2311.12983).
ls --sort [lastModified|trending|upvotes]	Ordonarea.
ls --limit INTEGER	Implicit 10.
info COLLECTION_SLUG	Detaliile colecției (username/collection-slug).
create TITLE --namespace / --description / --private / --exists-ok	Colecție nouă; descrierea are maximum 150 de caractere.
update --title / --description / --position / --private / --theme	Modifică metadatele colecției.
delete [--missing-ok]	Șterge colecția.
add-item SLUG ITEM_ID ITEM_TYPE [--note TEXT] [--exists-ok]	Adaugă un element; nota are maximum 500 de caractere.
update-item SLUG ITEM_OBJECT_ID [--note] [--position]	Modifică nota sau poziția elementului.
delete-item SLUG ITEM_OBJECT_ID [--missing-ok]	Scoate elementul din colecție.
--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: Colecțiile unei organizații, doar ID-uri

hf collections ls --owner nvidia -q

Exemplul 2: Colecție privată nouă

hf collections create "My Models" --description "A collection of my favorite models" --private

Exemplul 3: Adăugarea unui dataset cu notă

hf collections add-item username/my-collection Qwen/DeepPlanning dataset --note "Useful dataset"

Exemplul 4: Mutarea unui element pe prima poziție

hf collections update-item username/my-collection ITEM_OBJECT_ID --position 0

Greșeli frecvente și bune practici

• Dai ID-ul repository-ului la update-item sau delete-item. Aceste comenzi cer item_object_id, pe care îl vezi cu hf collections info.
• Scrii o descriere lungă. Limita este de 150 de caractere pentru colecție și 500 pentru nota unui element.

Comenzi înrudite

• hf-models
• hf-datasets
• hf-papers