hf cp (și hf repos cp, hf buckets cp) în Hugging Face Hub & Transformers

hf cp SURSĂ [DESTINAȚIE] [--token TOKEN]

Ce face hf cp (și hf repos cp, hf buckets cp)

hf cp copiază un fișier: încărcare (local sau stdin către repository sau bucket), descărcare (repository sau bucket către local sau stdout) și copiere între două locații de pe Hub. Sursa și destinația pot fi o cale locală, un URI hf:// sau -. hf repos cp și hf buckets cp sunt exact aceeași comandă.

Când destinația se termină cu /, se păstrează numele fișierului local. Fără destinație, fișierul ajunge în directorul curent. La copierea unui director între două locații de pe Hub, / de la finalul sursei decide dacă directorul este copiat cu tot cu nume sau doar conținutul lui (ca la rsync).

Limite documentate: când este implicată o cale locală, hf cp copiază un singur fișier (pentru directoare folosești hf upload / hf download sau hf buckets sync); copierea din bucket în repository și copierea local-local nu sunt suportate; copierea între două locații de pe Hub merge doar în aceeași regiune de stocare.

Sintaxă și opțiuni

Opțiune / Parametru	Descriere
SRC	Sursa: fișier local, URI hf:// (repository sau bucket) sau - pentru stdin.
[DST]	Destinația: cale locală, URI hf:// sau - pentru stdout.
--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: Încărcare într-un model

hf cp ./model.safetensors hf://username/my-model/model.safetensors

Exemplul 2: Încărcare într-un bucket, cu numele local

hf cp ./data.csv hf://buckets/username/my-bucket/logs/

Exemplul 3: Descărcare dintr-un pull request al unui dataset

hf cp hf://datasets/username/my-dataset@refs/pr/1/data.csv ./data.csv

Exemplul 4: La stdout, direct în jq

hf cp hf://buckets/username/my-bucket/config.json - | jq .

Exemplul 5: Din stdin

echo "hello" | hf cp - hf://username/my-model/hello.txt

Exemplul 6: Din dataset în bucket

hf cp hf://datasets/username/my-dataset/data/train/ hf://buckets/username/my-bucket/datasets/train/

Greșeli frecvente și bune practici

• Încerci să copiezi un director local cu hf cp. Comanda lucrează cu un singur fișier local; pentru directoare folosește hf upload sau hf sync.
• Copiezi din bucket în repository. Această direcție nu este încă suportată.
• Uiți / de la finalul sursei și obții un director în plus la destinație (archive/logs/... în loc de archive/...).

Comenzi înrudite

• hf-upload
• hf-download
• hf-buckets
• hf-sync