hf models (ls, info, card) în Hugging Face Hub & Transformers

hf models ls [REPO_ID] [--search TEXT] [--author ORG] [--pipeline-tag TAG] [--sort CHEIE] [--limit N]
hf models info MODEL_ID [--expand PROPRIETĂȚI]
hf models card MODEL_ID [--metadata | --text]

Ce face hf models (ls, info, card)

hf models ls (alias list) fără argument listează modele de pe Hub (implicit cele în trend, 30 de rezultate). Filtrele acoperă căutarea în nume, autorul, tagurile, sarcina (--pipeline-tag), accesul controlat, aplicațiile care pot rula modelul (--apps, de exemplu llama.cpp sau vllm), numărul de parametri și furnizorii de inferență.

Cu un ID de model, aceeași comandă listează fișierele din repository, recursiv (-R), ca arbore (--tree) și cu dimensiuni ușor de citit (-h), opțional la o revizie anume.

hf models info afișează informațiile despre model; --expand cere doar anumite proprietăți (de exemplu downloads,likes,tags). hf models card afișează model card-ul complet, doar metadatele YAML (--metadata, utile ca JSON pentru scripturi) sau doar textul (--text).

Sintaxă și opțiuni

Opțiune / Parametru	Descriere
ls [REPO_ID]	Fără ID: listează modele. Cu ID: listează fișierele modelului.
--search TEXT	Căutare în nume.
--author TEXT	Autor sau organizație.
--filter TEXT	Filtru după tag (se poate repeta).
--pipeline-tag TEXT	Sarcina canonică, de exemplu summarization.
--gated / --no-gated	Doar modele cu acces controlat / doar fără.
--apps TEXT	Aplicațiile care pot rula modelul (de exemplu ollama, vllm, llama.cpp).
--num-parameters TEXT	Interval de parametri, de exemplu min:6B,max:128B.
--inference-provider [...]	Furnizori de inferență care servesc modelul (de exemplu fireworks-ai, groq, together).
--warm	Doar modele servite acum de cel puțin un furnizor de inferență.
--sort [created_at|downloads|last_modified|likes|trending_score]	Ordonarea rezultatelor.
--limit INTEGER	Numărul de rezultate. Implicit 30.
--expand TEXT	Proprietățile returnate, separate prin virgulă (ls și info).
-h / --tree / -R	Pentru listarea fișierelor: dimensiuni lizibile, arbore, recursiv.
--revision TEXT	Revizia (ls cu ID, info).
card --metadata	Doar metadatele YAML ale card-ului.
card --text	Doar textul card-ului, fără metadate.
--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: Cele mai descărcate 10 modele

hf models ls --sort downloads --limit 10

Exemplul 2: Modele între 6B și 128B parametri

hf models ls --num-parameters min:6B,max:128B --sort likes

Exemplul 3: Modele care rulează în llama.cpp

hf models ls --apps llama.cpp

Exemplul 4: Fișierele unui model, ca arbore

hf models ls meta-llama/Llama-3.2-1B-Instruct --tree -h

Exemplul 5: Doar câteva proprietăți

hf models info Qwen/Qwen3.5-9B --expand downloads,likes,tags

Exemplul 6: Metadatele card-ului ca JSON

hf models card google/gemma-4-31B-it --metadata --format json

Greșeli frecvente și bune practici

• Pui ID-ul modelului la ls și aștepți o listă de modele. Cu ID, comanda listează fișierele acelui repository.
• Folosești --expand și te miri că lipsesc câmpuri. Cu --expand se returnează doar proprietățile cerute (plus id).

Comenzi înrudite

• hf-datasets
• hf-spaces
• hf-download
• hf-collections