hf-cli

Interface de ligne de commande Hugging Face Hub (`hf`) pour télécharger, charger et gérer des modèles, des ensembles de données, des espaces, des buckets, des dépôts, des articles, des emplois et bien plus encore sur Hugging Face Hub. À utiliser quand : gérer l'authentification ; gérer le cache local ; gérer Hugging Face Buckets ; exécuter ou planifier des emplois sur l'infrastructure Hugging Face ; gérer les dépôts Hugging Face ; discussions et demandes de fusion ; parcourir les modèles, ensembles de données et espaces ; lire, rechercher ou parcourir les articles académiques ; gérer les collections ; interroger les ensembles de données ; configurer les espaces ; configurer les webhooks ; ou déployer et gérer HF Inference Endpoints. Assurez-vous d'utiliser cette compétence chaque fois que l'utilisateur mentionne « hf », « huggingface », « Hugging Face », « huggingface-cli », ou « hugging face cli », ou souhaite faire quelque chose en lien avec l'écosystème Hugging Face et l'IA et le ML en général. À utiliser également pour les besoins de stockage cloud comme les points de contrôle d'entraînement, les pipelines de données ou les traces d'agent. À utiliser même si l'utilisateur ne demande pas explicitement une commande CLI. Remplace le deprecated `huggingface-cli`.

npx skills add https://github.com/huggingface/skills --skill hf-cli

Installation : curl -LsSf https://hf.co/cli/install.sh | bash -s.

L'outil CLI Hugging Face Hub hf est disponible. IMPORTANT : La commande hf remplace la commande dépréciée huggingface-cli.

Utilisez hf --help pour voir les fonctions disponibles. Notez que les commandes d'authentification sont maintenant toutes sous hf auth, par exemple hf auth whoami.

Généré avec huggingface_hub v1.12.2. Exécutez hf skills add --force pour régénérer.

Commandes

  • hf download REPO_ID — Télécharger des fichiers depuis le Hub. [--type CHOICE --revision TEXT --include TEXT --exclude TEXT --cache-dir TEXT --local-dir TEXT --force-download --dry-run --max-workers INTEGER --format CHOICE]
  • hf env — Afficher les informations sur l'environnement.
  • hf sync — Synchroniser les fichiers entre un répertoire local et un bucket. [--delete --ignore-times --ignore-sizes --plan TEXT --apply TEXT --dry-run --include TEXT --exclude TEXT --filter-from TEXT --existing --ignore-existing --verbose --quiet]
  • hf upload REPO_ID — Charger un fichier ou un dossier vers le Hub. Recommandé pour les chargements de simple commit. [--type CHOICE --revision TEXT --private --include TEXT --exclude TEXT --delete TEXT --commit-message TEXT --commit-description TEXT --create-pr --every FLOAT --format CHOICE]
  • hf upload-large-folder REPO_ID LOCAL_PATH — Charger un grand dossier vers le Hub. Recommandé pour les chargements reprennables. [--type CHOICE --revision TEXT --private --include TEXT --exclude TEXT --num-workers INTEGER --no-report --no-bars --format CHOICE]
  • hf version — Afficher les informations sur la version de hf.

hf auth — Gérer l'authentification (connexion, déconnexion, etc.).

  • hf auth list — Lister tous les jetons d'accès stockés.
  • hf auth login — Se connecter en utilisant un jeton depuis huggingface.co/settings/tokens. [--add-to-git-credential --force]
  • hf auth logout — Se déconnecter d'un jeton spécifique. [--token-name TEXT]
  • hf auth switch — Basculer entre les jetons d'accès. [--token-name TEXT --add-to-git-credential]
  • hf auth token — Afficher le jeton d'accès actuel vers stdout.
  • hf auth whoami — Découvrir le compte huggingface.co auquel vous êtes connecté. [--format CHOICE]

hf buckets — Commandes pour interagir avec les buckets.

  • hf buckets cp SRC — Copier des fichiers vers ou depuis les buckets. [--format CHOICE]
  • hf buckets create BUCKET_ID — Créer un nouveau bucket. [--private --exist-ok --format CHOICE]
  • hf buckets delete BUCKET_ID — Supprimer un bucket. [--yes --missing-ok --format CHOICE]
  • hf buckets info BUCKET_ID — Obtenir les informations sur un bucket. [--format CHOICE]
  • hf buckets list — Lister les buckets ou les fichiers dans un bucket. [--human-readable --tree --recursive --search TEXT --format CHOICE]
  • hf buckets move FROM_ID TO_ID — Déplacer (renommer) un bucket vers un nouveau nom ou espace de noms. [--format CHOICE]
  • hf buckets remove ARGUMENT — Supprimer les fichiers d'un bucket. [--recursive --yes --dry-run --include TEXT --exclude TEXT --format CHOICE]
  • hf buckets sync — Synchroniser les fichiers entre un répertoire local et un bucket. [--delete --ignore-times --ignore-sizes --plan TEXT --apply TEXT --dry-run --include TEXT --exclude TEXT --filter-from TEXT --existing --ignore-existing --verbose --quiet]

hf cache — Gérer le répertoire de cache local.

  • hf cache list — Lister les dépôts ou révisions en cache. [--cache-dir TEXT --revisions --filter TEXT --format CHOICE --sort CHOICE --limit INTEGER]
  • hf cache prune — Supprimer les révisions détachées du cache. [--cache-dir TEXT --yes --dry-run --format CHOICE]
  • hf cache rm TARGETS — Supprimer les dépôts ou révisions en cache. [--cache-dir TEXT --yes --dry-run --format CHOICE]
  • hf cache verify REPO_ID — Vérifier les sommes de contrôle pour une révision unique d'un dépôt à partir du cache ou d'un répertoire local. [--type CHOICE --revision TEXT --cache-dir TEXT --local-dir TEXT --fail-on-missing-files --fail-on-extra-files --format CHOICE]

hf collections — Interagir avec les collections sur le Hub.

  • hf collections add-item COLLECTION_SLUG ITEM_ID ITEM_TYPE — Ajouter un élément à une collection. [--note TEXT --exists-ok --format CHOICE]
  • hf collections create TITLE — Créer une nouvelle collection sur le Hub. [--namespace TEXT --description TEXT --private --exists-ok --format CHOICE]
  • hf collections delete COLLECTION_SLUG — Supprimer une collection du Hub. [--missing-ok --format CHOICE]
  • hf collections delete-item COLLECTION_SLUG ITEM_OBJECT_ID — Supprimer un élément d'une collection. [--missing-ok --format CHOICE]
  • hf collections info COLLECTION_SLUG — Obtenir les informations sur une collection du Hub. [--format CHOICE]
  • hf collections list — Lister les collections sur le Hub. [--owner TEXT --item TEXT --sort CHOICE --limit INTEGER --format CHOICE]
  • hf collections update COLLECTION_SLUG — Mettre à jour les métadonnées d'une collection sur le Hub. [--title TEXT --description TEXT --position INTEGER --private --theme TEXT --format CHOICE]
  • hf collections update-item COLLECTION_SLUG ITEM_OBJECT_ID — Mettre à jour un élément dans une collection. [--note TEXT --position INTEGER --format CHOICE]

hf datasets — Interagir avec les ensembles de données sur le Hub.

  • hf datasets info DATASET_ID — Obtenir les informations sur un ensemble de données du Hub. [--revision TEXT --expand TEXT --format CHOICE]
  • hf datasets list — Lister les ensembles de données sur le Hub. [--search TEXT --author TEXT --filter TEXT --sort CHOICE --limit INTEGER --expand TEXT --format CHOICE]
  • hf datasets parquet DATASET_ID — Lister les URL des fichiers parquet disponibles pour un ensemble de données. [--subset TEXT --split TEXT --format CHOICE]
  • hf datasets sql SQL — Exécuter une requête SQL brute avec DuckDB contre les URL parquet de l'ensemble de données. [--format CHOICE]

hf discussions — Gérer les discussions et les demandes de fusion sur le Hub.

  • hf discussions close REPO_ID NUM — Fermer une discussion ou une demande de fusion. [--comment TEXT --yes --type CHOICE --format CHOICE]
  • hf discussions comment REPO_ID NUM — Commenter une discussion ou une demande de fusion. [--body TEXT --body-file PATH --type CHOICE --format CHOICE]
  • hf discussions create REPO_ID --title TEXT — Créer une nouvelle discussion ou demande de fusion sur un dépôt. [--body TEXT --body-file PATH --pull-request --type CHOICE --format CHOICE]
  • hf discussions diff REPO_ID NUM — Afficher le diff d'une demande de fusion. [--type CHOICE --format CHOICE]
  • hf discussions info REPO_ID NUM — Obtenir les informations sur une discussion ou une demande de fusion. [--type CHOICE --format CHOICE]
  • hf discussions list REPO_ID — Lister les discussions et demandes de fusion sur un dépôt. [--status CHOICE --kind CHOICE --author TEXT --limit INTEGER --type CHOICE --format CHOICE]
  • hf discussions merge REPO_ID NUM — Fusionner une demande de fusion. [--comment TEXT --yes --type CHOICE --format CHOICE]
  • hf discussions rename REPO_ID NUM NEW_TITLE — Renommer une discussion ou une demande de fusion. [--type CHOICE --format CHOICE]
  • hf discussions reopen REPO_ID NUM — Rouvrir une discussion ou demande de fusion fermée. [--comment TEXT --yes --type CHOICE --format CHOICE]

hf endpoints — Gérer les Hugging Face Inference Endpoints.

  • hf endpoints catalog deploy --repo TEXT — Déployer un Inference Endpoint à partir du Catalogue de modèles. [--name TEXT --accelerator TEXT --namespace TEXT --format CHOICE]
  • hf endpoints catalog list — Lister les modèles de Catalogue disponibles. [--format CHOICE]
  • hf endpoints delete NAME — Supprimer un Inference Endpoint de façon permanente. [--namespace TEXT --yes --format CHOICE]
  • hf endpoints deploy NAME --repo TEXT --framework TEXT --accelerator TEXT --instance-size TEXT --instance-type TEXT --region TEXT --vendor TEXT — Déployer un Inference Endpoint à partir d'un dépôt du Hub. [--namespace TEXT --task TEXT --format CHOICE --min-replica INTEGER --max-replica INTEGER --scale-to-zero-timeout INTEGER --scaling-metric CHOICE --scaling-threshold FLOAT]
  • hf endpoints describe NAME — Obtenir les informations sur un endpoint existant. [--namespace TEXT --format CHOICE]
  • hf endpoints list — Lister tous les Inference Endpoints pour l'espace de noms donné. [--namespace TEXT --format CHOICE]
  • hf endpoints pause NAME — Mettre en pause un Inference Endpoint. [--namespace TEXT --format CHOICE]
  • hf endpoints resume NAME — Reprendre un Inference Endpoint. [--namespace TEXT --fail-if-already-running --format CHOICE]
  • hf endpoints scale-to-zero NAME — Mettre à l'échelle un Inference Endpoint à zéro. [--namespace TEXT --format CHOICE]
  • hf endpoints update NAME — Mettre à jour un endpoint existant. [--namespace TEXT --repo TEXT --accelerator TEXT --instance-size TEXT --instance-type TEXT --framework TEXT --revision TEXT --task TEXT --min-replica INTEGER --max-replica INTEGER --scale-to-zero-timeout INTEGER --scaling-metric CHOICE --scaling-threshold FLOAT --format CHOICE]

hf extensions — Gérer les extensions de la CLI hf.

  • hf extensions exec NAME — Exécuter une extension installée.
  • hf extensions install REPO_ID — Installer une extension à partir d'un référentiel GitHub public. [--force]
  • hf extensions list — Lister les commandes d'extension installées. [--format CHOICE]
  • hf extensions remove NAME — Supprimer une extension installée.
  • hf extensions search — Rechercher les extensions disponibles sur GitHub (identifiées par le sujet 'hf-extension'). [--format CHOICE]

hf jobs — Exécuter et gérer les Jobs sur le Hub.

  • hf jobs cancel JOB_ID — Annuler un Job [--namespace TEXT]
  • hf jobs hardware — Lister les options matérielles disponibles pour les Jobs
  • hf jobs inspect JOB_IDS — Afficher des informations détaillées sur un ou plusieurs Jobs [--namespace TEXT]
  • hf jobs logs JOB_ID — Récupérer les journaux d'un Job. [--follow --tail INTEGER --namespace TEXT]
  • hf jobs ps — Lister les Jobs. [--all --namespace TEXT --filter TEXT --format TEXT --quiet]
  • hf jobs run IMAGE COMMAND — Exécuter un Job. [--env TEXT --secrets TEXT --label TEXT --volume TEXT --env-file TEXT --secrets-file TEXT --flavor CHOICE --timeout TEXT --detach --namespace TEXT]
  • hf jobs scheduled delete SCHEDULED_JOB_ID — Supprimer un Job planifié. [--namespace TEXT]
  • hf jobs scheduled inspect SCHEDULED_JOB_IDS — Afficher des informations détaillées sur un ou plusieurs Jobs planifiés [--namespace TEXT]
  • hf jobs scheduled ps — Lister les Jobs planifiés [--all --namespace TEXT --filter TEXT --format TEXT --quiet]
  • hf jobs scheduled resume SCHEDULED_JOB_ID — Reprendre (dépausifier) un Job planifié. [--namespace TEXT]
  • hf jobs scheduled run SCHEDULE IMAGE COMMAND — Planifier un Job. [--suspend --concurrency --env TEXT --secrets TEXT --label TEXT --volume TEXT --env-file TEXT --secrets-file TEXT --flavor CHOICE --timeout TEXT --namespace TEXT]
  • hf jobs scheduled suspend SCHEDULED_JOB_ID — Suspendre (pausifier) un Job planifié. [--namespace TEXT]
  • hf jobs scheduled uv run SCHEDULE SCRIPT — Exécuter un script UV (fichier local ou URL) sur l'infrastructure HF [--suspend --concurrency --image TEXT --flavor CHOICE --env TEXT --secrets TEXT --label TEXT --volume TEXT --env-file TEXT --secrets-file TEXT --timeout TEXT --namespace TEXT --with TEXT --python TEXT]
  • hf jobs stats — Récupérer les statistiques d'utilisation des ressources et les métriques des Jobs [--namespace TEXT]
  • hf jobs uv run SCRIPT — Exécuter un script UV (fichier local ou URL) sur l'infrastructure HF [--image TEXT --flavor CHOICE --env TEXT --secrets TEXT --label TEXT --volume TEXT --env-file TEXT --secrets-file TEXT --timeout TEXT --detach --namespace TEXT --with TEXT --python TEXT]

hf models — Interagir avec les modèles sur le Hub.

  • hf models info MODEL_ID — Obtenir les informations sur un modèle du Hub. [--revision TEXT --expand TEXT --format CHOICE]
  • hf models list — Lister les modèles sur le Hub. [--search TEXT --author TEXT --filter TEXT --num-parameters TEXT --sort CHOICE --limit INTEGER --expand TEXT --format CHOICE]

hf papers — Interagir avec les articles sur le Hub.

  • hf papers info PAPER_ID — Obtenir les informations sur un article du Hub. [--format CHOICE]
  • hf papers list — Lister les articles quotidiens sur le Hub. [--date TEXT --week TEXT --month TEXT --submitter TEXT --sort CHOICE --limit INTEGER --format CHOICE]
  • hf papers read PAPER_ID — Lire un article au format markdown.
  • hf papers search QUERY — Rechercher les articles sur le Hub. [--limit INTEGER --format CHOICE]

hf repos — Gérer les dépôts sur le Hub.

  • hf repos branch create REPO_ID BRANCH — Créer une nouvelle branche pour un dépôt sur le Hub. [--revision TEXT --type CHOICE --exist-ok --format CHOICE]
  • hf repos branch delete REPO_ID BRANCH — Supprimer une branche d'un dépôt sur le Hub. [--type CHOICE --format CHOICE]
  • hf repos create REPO_ID — Créer un nouveau dépôt sur le Hub. [--type CHOICE --space-sdk TEXT --private --public --protected --exist-ok --resource-group-id TEXT --flavor CHOICE --storage CHOICE --sleep-time INTEGER --secrets TEXT --secrets-file TEXT --env TEXT --env-file TEXT --volume TEXT --format CHOICE]
  • hf repos delete REPO_ID — Supprimer un dépôt du Hub. Cette opération est irréversible. [--type CHOICE --missing-ok --yes --format CHOICE]
  • hf repos delete-files REPO_ID PATTERNS — Supprimer les fichiers d'un dépôt sur le Hub. [--type CHOICE --revision TEXT --commit-message TEXT --commit-description TEXT --create-pr --format CHOICE]
  • hf repos duplicate FROM_ID — Dupliquer un dépôt sur le Hub (modèle, ensemble de données ou Space). [--type CHOICE --private --public --protected --exist-ok --flavor CHOICE --storage CHOICE --sleep-time INTEGER --secrets TEXT --secrets-file TEXT --env TEXT --env-file TEXT --volume TEXT --format CHOICE]
  • hf repos move FROM_ID TO_ID — Déplacer un dépôt d'un espace de noms à un autre. [--type CHOICE --format CHOICE]
  • hf repos settings REPO_ID — Mettre à jour les paramètres d'un dépôt. [--gated CHOICE --private --public --protected --type CHOICE --format CHOICE]
  • hf repos tag create REPO_ID TAG — Créer une balise pour un dépôt. [--message TEXT --revision TEXT --type CHOICE --format CHOICE]
  • hf repos tag delete REPO_ID TAG — Supprimer une balise d'un dépôt. [--yes --type CHOICE --format CHOICE]
  • hf repos tag list REPO_ID — Lister les balises d'un dépôt. [--type CHOICE --format CHOICE]

hf skills — Gérer les compétences pour les assistants IA.

  • hf skills add — Télécharger une compétence Hugging Face et l'installer pour un assistant IA. [--claude --global --dest PATH --force]
  • hf skills preview — Afficher le SKILL.md hf-cli généré vers stdout.
  • hf skills upgrade — Mettre à jour les compétences du marché Hugging Face installées. [--claude --global --dest PATH]

hf spaces — Interagir avec les spaces sur le Hub.

  • hf spaces dev-mode SPACE_ID — Activer ou désactiver le mode développement sur un Space. [--stop]
  • hf spaces hot-reload SPACE_ID — Rechargement à chaud de n'importe quel fichier Python d'un Space sans reconstruction complète + redémarrage. [--local-file PATH --skip-checks --skip-summary]
  • hf spaces info SPACE_ID — Obtenir les informations sur un space du Hub. [--revision TEXT --expand TEXT --format CHOICE]
  • hf spaces list — Lister les spaces sur le Hub. [--search TEXT --author TEXT --filter TEXT --sort CHOICE --limit INTEGER --expand TEXT --format CHOICE]
  • hf spaces logs SPACE_ID — Récupérer les journaux d'exécution ou de construction d'un Space. [--build --follow --tail INTEGER]
  • hf spaces search QUERY — Rechercher les spaces sur le Hub en utilisant la recherche sémantique. [--filter TEXT --sdk TEXT --include-non-running --description --limit INTEGER --format CHOICE]
  • hf spaces volumes delete SPACE_ID — Supprimer tous les volumes d'un Space. [--yes --format CHOICE]
  • hf spaces volumes list SPACE_ID — Lister les volumes montés dans un Space. [--format CHOICE]
  • hf spaces volumes set SPACE_ID — Définir (remplacer) les volumes d'un Space. [--volume TEXT --format CHOICE]

hf webhooks — Gérer les webhooks sur le Hub.

  • hf webhooks create --watch TEXT — Créer un nouveau webhook. [--url TEXT --job-id TEXT --domain CHOICE --secret TEXT --format CHOICE]
  • hf webhooks delete WEBHOOK_ID — Supprimer un webhook de façon permanente. [--yes --format CHOICE]
  • hf webhooks disable WEBHOOK_ID — Désactiver un webhook actif. [--format CHOICE]
  • hf webhooks enable WEBHOOK_ID — Activer un webhook désactivé. [--format CHOICE]
  • hf webhooks info WEBHOOK_ID — Afficher les détails complets d'un webhook unique. [--format CHOICE]
  • hf webhooks list — Lister tous les webhooks de l'utilisateur actuel. [--format CHOICE]
  • hf webhooks update WEBHOOK_ID — Mettre à jour un webhook existant. Seules les options fournies sont modifiées. [--url TEXT --watch TEXT --domain CHOICE --secret TEXT --format CHOICE]

Options communes

  • --format — Format de sortie : --format json (ou --json) ou --format table (par défaut).
  • -q / --quiet — Sortie minimale.
  • --revision — Identifiant de révision Git qui peut être un nom de branche, une balise ou un hash de commit.
  • --token — Utiliser un jeton d'accès utilisateur. Préférez définir la variable d'environnement HF_TOKEN au lieu de passer --token.
  • --type — Le type de dépôt (modèle, ensemble de données ou space).

Montage des dépôts comme systèmes de fichiers locaux

Pour monter les dépôts du Hub ou les buckets en tant que systèmes de fichiers locaux — sans téléchargement, sans copie, sans attente — utilisez hf-mount. Les fichiers sont récupérés à la demande. GitHub : https://github.com/huggingface/hf-mount

Installation : curl -fsSL https://raw.githubusercontent.com/huggingface/hf-mount/main/install.sh | sh

Quelques exemples de commandes :

  • hf-mount start repo openai-community/gpt2 /tmp/gpt2 — monter un dépôt (lecture seule)
  • hf-mount start --hf-token $HF_TOKEN bucket myuser/my-bucket /tmp/data — monter un bucket (lecture-écriture)
  • hf-mount status / hf-mount stop /tmp/data — lister ou démonter

Conseils

  • Utilisez hf <command> --help pour les options complètes, les descriptions, l'utilisation et les exemples concrets
  • Authentifiez-vous avec la variable d'environnement HF_TOKEN (recommandé) ou avec --token