hf repos branch / hf repos tag în Hugging Face Hub & Transformers

CLI hf: Repository-uri și Conținut Hub huggingface_hub 2.3 / CLI hf (octombrie 2026)

Creează și șterge ramuri și taguri în repository-urile de pe Hub, fără git local.

Sintaxă & invocare Python
hf repos branch create | delete REPO_ID RAMURĂ [--revision REV]
hf repos tag create REPO_ID TAG [-m MESAJ] [--revision REV]
hf repos tag list | delete REPO_ID [TAG]

Ce face hf repos branch / hf repos tag

hf repos branch create creează o ramură nouă, implicit din main sau din revizia dată cu --revision; --exist-ok evită eroarea dacă ramura există. hf repos branch delete o șterge.

hf repos tag create pune un tag pe main sau pe revizia dată, opțional cu o descriere (-m). tag list (alias ls) listează tagurile, iar tag delete șterge un tag după confirmare (-y o sare).

Toate subcomenzile acceptă --repo-type (implicit model) și --token.

Sintaxă și opțiuni

Opțiune / Parametru Descriere
branch create REPO_ID BRANCH Creează ramura.
branch create --revision TEXT Punctul de plecare (ramură, tag sau commit).
branch create --exist-ok Fără eroare dacă ramura există.
branch delete REPO_ID BRANCH Șterge ramura.
tag create REPO_ID TAG Creează tagul.
tag create -m, --message TEXT Descrierea tagului.
tag create --revision TEXT Revizia marcată. Implicit main.
tag list (ls) REPO_ID Listează tagurile.
tag delete REPO_ID TAG [-y] Șterge tagul; -y fără confirmare.
--type, --repo-type [model|dataset|space|kernel] Tipul repository-ului. Implicit model.
--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: Ramură nouă dintr-un pull request

hf repos branch create Wauplin/my-cool-model release-1 --revision refs/pr/104

Exemplul 2: Tag pe main

hf repos tag create Wauplin/my-cool-model v1.0

Rezultat

You are about to create tag v1.0 on model Wauplin/my-cool-model
Tag v1.0 created on Wauplin/my-cool-model

Exemplul 3: Tag pe un dataset

hf repos tag create bigcode/the-stack v1.0 --repo-type dataset

Exemplul 4: Tagurile unui Space

hf repos tag list Wauplin/gradio-space-ci --repo-type space

Rezultat

Tags for space Wauplin/gradio-space-ci:
0.2.2
0.2.1
0.2.0
0.1.2
0.0.2
0.0.1

Exemplul 5: Ștergerea unei ramuri

hf repos branch delete Wauplin/my-cool-model dev

Greșeli frecvente și bune practici

  • Uiți --repo-type pentru datasets și Spaces. Implicit comanda caută un model cu acel ID.
  • Pui tagul înainte să încarci versiunea finală. Fără --revision, tagul marchează starea curentă a lui main.

Comenzi înrudite