hf download în Hugging Face Hub & Transformers

hf download REPO_ID [FIȘIERE]... [--repo-type TIP] [--revision REV] [--include MODEL] [--exclude MODEL] [--local-dir DIR] [--cache-dir DIR] [--dry-run]

Ce face hf download

hf download descarcă fișiere de pe Hub folosind aceleași funcții ca biblioteca (hf_hub_download și snapshot_download). Cu un singur nume de fișier descarcă doar acel fișier; fără nume descarcă tot repository-ul; cu mai multe nume sau cu --include / --exclude descarcă un subset. Pe ultimul rând afișează mereu calea locală.

Implicit fișierele ajung în cache-ul Hugging Face (HF_HOME, de obicei ~/.cache/huggingface/hub). Cu --local-dir sunt puse într-un director ales de tine; acolo se creează un folder .cache/huggingface/ cu metadate, ca la rularea următoare să fie descărcate doar fișierele schimbate. --dry-run arată ce fișiere ar fi descărcate și cât ocupă, fără să descarce.

În locul argumentelor separate poți da un URI hf://[TIP/]ID[@REVIZIE][/CALE]. În acest caz nu mai poți folosi --repo-type și --revision. Un / la finalul căii înseamnă un subdirector. Pentru conexiuni lente, documentația recomandă mărirea HF_HUB_DOWNLOAD_TIMEOUT (implicit 10 secunde).

Sintaxă și opțiuni

Opțiune / Parametru	Descriere
REPO_ID	ID-ul repository-ului (de exemplu username/repo-name) sau un URI hf://.
[FIȘIERE]...	Fișierele de descărcat, cu calea din repository (de exemplu data/metadata.jsonl).
--type, --repo-type [model|dataset|space|kernel]	Tipul repository-ului. Implicit model.
--revision TEXT	Ramură, tag sau hash de commit.
--include TEXT	Modele glob de inclus (de exemplu *.json).
--exclude TEXT	Modele glob de exclus.
--cache-dir TEXT	Alt director de cache.
--local-dir TEXT	Pune fișierele în acest director, nu în cache.
--force-download / --no-force-download	Descarcă din nou chiar dacă fișierele sunt deja în cache.
--dry-run / --no-dry-run	Listează fișierele care ar fi descărcate, fără descărcare.
--max-workers INTEGER	Numărul maxim de descărcări paralele. Implicit 8.
--token TEXT	Token de acces (User Access Token) creat în huggingface.co/settings/tokens. Implicit se folosește tokenul salvat de hf auth login.
--quiet	Afișează doar ultima linie (calea), util în scripturi.

Exemple practice

Exemplul 1: Un singur fișier

hf download gpt2 config.json

Exemplul 2: Tot repository-ul unui model

hf download HuggingFaceH4/zephyr-7b-beta

Exemplul 3: Doar fișierele safetensors, fără variantele fp16

hf download stabilityai/stable-diffusion-xl-base-1.0 --include "*.safetensors" --exclude "*.fp16.*"

Exemplul 4: Un dataset, la o anumită revizie

hf download bigcode/the-stack --repo-type dataset --revision v1.1

Exemplul 5: Același lucru cu un URI hf://

hf download hf://datasets/bigcode/the-stack@v1.1

Exemplul 6: Într-un director local

hf download adept/fuyu-8b model-00001-of-00002.safetensors --local-dir fuyu

Exemplul 7: Mod silențios, pentru scripturi

hf download gpt2 --quiet

Rezultat

/home/wauplin/.cache/huggingface/hub/models--gpt2/snapshots/11c5a3d5811f50298f278a704980280950aedb10

Greșeli frecvente și bune practici

• Cauți opțiunea --local-dir-use-symlinks. Nu mai există; --local-dir copiază fișierele direct în director.
• Setezi HF_HUB_ENABLE_HF_TRANSFER=1 pentru viteză. Variabila este ignorată; pentru performanță maximă există HF_XET_HIGH_PERFORMANCE=1.
• Combini un URI hf:// cu --repo-type sau --revision. CLI-ul dă eroare, pentru că URI-ul le conține deja.

Comenzi înrudite

• hf-upload
• hf-cache
• hf-cp
• hf-auth
• huggingface-hf-transfer