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.13.0. 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 des informations sur l'environnement. [--format CHOICE]
• 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 --format CHOICE]
• hf update — Mettre à jour le CLI hf vers la dernière version. [--format CHOICE]
• hf upload REPO_ID — Charger un fichier ou un dossier vers le Hub. Recommandé pour les chargements à commit unique. [--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 gros 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 des informations sur la version hf. [--format CHOICE]

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

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

hf buckets — Commandes pour interagir avec les buckets.

• hf buckets cp SRC — Copier des fichiers vers ou depuis des 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 des 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 un nouvel espace de noms. [--format CHOICE]
• hf buckets remove ARGUMENT — Supprimer des 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 --format CHOICE]

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 --sort CHOICE --limit INTEGER --format CHOICE]
• 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 d'une révision de dépôt unique depuis le cache ou 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 du 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 des informations sur une collection du Hub. [--format CHOICE]
• hf collections list — Lister les collections du 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 du 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 datasets du Hub.

• hf datasets card DATASET_ID — Obtenir la fiche dataset (README) pour un dataset du Hub. [--metadata --text --format CHOICE]
• hf datasets info DATASET_ID — Obtenir des informations sur un dataset du Hub. [--revision TEXT --expand TEXT --format CHOICE]
• hf datasets leaderboard DATASET_ID — Lister les scores des modèles depuis un classement de dataset. Cette commande aide à trouver les meilleurs modèles pour une tâche ou à comparer les modèles par scores de benchmark. [--limit INTEGER --format CHOICE]
• hf datasets list — Lister les datasets du Hub, ou les fichiers dans un dépôt de dataset. [--search TEXT --author TEXT --filter TEXT --sort CHOICE --limit INTEGER --expand TEXT --human-readable --tree --recursive --revision TEXT --format CHOICE]
• hf datasets parquet DATASET_ID — Lister les URLs de fichiers parquet disponibles pour un dataset. [--subset TEXT --split TEXT --format CHOICE]
• hf datasets sql SQL — Exécuter une requête SQL brute avec DuckDB sur les URLs parquet du dataset. [--format CHOICE]

hf discussions — Gérer les discussions et les pull requests du Hub.

• hf discussions close REPO_ID NUM — Fermer une discussion ou une pull request. [--comment TEXT --yes --type CHOICE --format CHOICE]
• hf discussions comment REPO_ID NUM — Commenter une discussion ou une pull request. [--body TEXT --body-file PATH --type CHOICE --format CHOICE]
• hf discussions create REPO_ID --title TEXT — Créer une nouvelle discussion ou pull request 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 pull request. [--type CHOICE --format CHOICE]
• hf discussions info REPO_ID NUM — Obtenir des informations sur une discussion ou une pull request. [--type CHOICE --format CHOICE]
• hf discussions list REPO_ID — Lister les discussions et pull requests 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 pull request. [--comment TEXT --yes --type CHOICE --format CHOICE]
• hf discussions rename REPO_ID NUM NEW_TITLE — Renommer une discussion ou une pull request. [--type CHOICE --format CHOICE]
• hf discussions reopen REPO_ID NUM — Rouvrir une discussion ou une pull request fermée. [--comment TEXT --yes --type CHOICE --format CHOICE]

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

• hf endpoints catalog deploy --repo TEXT — Déployer un Inference Endpoint depuis le Model Catalog. [--name TEXT --accelerator TEXT --namespace TEXT --format CHOICE]
• hf endpoints catalog list — Lister les modèles du Catalog 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 depuis un dépôt Hub. [--namespace TEXT --task TEXT --min-replica INTEGER --max-replica INTEGER --scale-to-zero-timeout INTEGER --scaling-metric CHOICE --scaling-threshold FLOAT --format CHOICE]
• hf endpoints describe NAME — Obtenir des 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 du CLI hf.

• hf extensions exec NAME — Exécuter une extension installée.
• hf extensions install REPO_ID — Installer une extension depuis un dépôt GitHub public. [--force --format CHOICE]
• hf extensions list — Lister les commandes d'extension installées. [--format CHOICE]
• hf extensions remove NAME — Supprimer une extension installée. [--format CHOICE]
• hf extensions search — Rechercher les extensions disponibles sur GitHub (tagguées avec le sujet 'hf-extension'). [--format CHOICE]

hf jobs — Lancer et gérer les Jobs du Hub.

• hf jobs cancel JOB_ID — Annuler un Job [--namespace TEXT --format CHOICE]
• hf jobs hardware — Lister les options matérielles disponibles pour les Jobs [--format CHOICE]
• hf jobs inspect JOB_IDS — Afficher des informations détaillées sur un ou plusieurs Jobs [--namespace TEXT --format CHOICE]
• hf jobs logs JOB_ID — Récupérer les logs d'un Job. [--follow --tail INTEGER --namespace TEXT --format CHOICE]
• hf jobs ps — Lister les Jobs. [--all --namespace TEXT --filter TEXT --format TEXT --quiet]
• hf jobs run IMAGE COMMAND — Lancer 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 --format CHOICE]
• hf jobs scheduled inspect SCHEDULED_JOB_IDS — Afficher des informations détaillées sur un ou plusieurs Jobs planifiés [--namespace TEXT --format CHOICE]
• 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 --format CHOICE]
• 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 --format CHOICE]
• hf jobs scheduled uv run SCHEDULE SCRIPT — Lancer 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 --format CHOICE]
• hf jobs uv run SCRIPT — Lancer 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 du Hub.

• hf models card MODEL_ID — Obtenir la fiche modèle (README) pour un modèle du Hub. [--metadata --text --format CHOICE]
• hf models info MODEL_ID — Obtenir des informations sur un modèle du Hub. [--revision TEXT --expand TEXT --format CHOICE]
• hf models list — Lister les modèles du Hub, ou les fichiers dans un dépôt de modèle. [--search TEXT --author TEXT --filter TEXT --num-parameters TEXT --sort CHOICE --limit INTEGER --expand TEXT --human-readable --tree --recursive --revision TEXT --format CHOICE]

hf papers — Interagir avec les articles du Hub.

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

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

• hf repos branch create REPO_ID BRANCH — Créer une nouvelle branche pour un dépôt du Hub. [--revision TEXT --type CHOICE --exist-ok --format CHOICE]
• hf repos branch delete REPO_ID BRANCH — Supprimer une branche d'un dépôt du Hub. [--type CHOICE --format CHOICE]
• hf repos create REPO_ID — Créer un nouveau dépôt du 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 des fichiers d'un dépôt du 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 du Hub (modèle, dataset 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 skills pour les assistants IA.

• hf skills add — Télécharger un skill Hugging Face et l'installer pour un assistant IA. [--claude --global --dest PATH --force --format CHOICE]
• hf skills preview — Afficher le SKILL.md hf-cli généré sur stdout. [--format CHOICE]
• hf skills upgrade — Mettre à jour les skills Hugging Face du marketplace installés. [--claude --global --dest PATH --format CHOICE]

hf spaces — Interagir avec les spaces du Hub.

• hf spaces card SPACE_ID — Obtenir la fiche Space (README) pour un Space du Hub. [--metadata --text --format CHOICE]
• hf spaces dev-mode SPACE_ID — Activer ou désactiver le mode dev sur un Space. [--stop --format CHOICE]
• hf spaces hardware — Lister les options matérielles disponibles pour les Spaces. [--format CHOICE]
• hf spaces hot-reload SPACE_ID — Hot-reload n'importe quel fichier Python d'un Space sans reconstruction complète + redémarrage. [--local-file PATH --skip-checks --skip-summary --format CHOICE]
• hf spaces info SPACE_ID — Obtenir des informations sur un space du Hub. [--revision TEXT --expand TEXT --format CHOICE]
• hf spaces list — Lister les spaces du Hub, ou les fichiers dans un dépôt de space. [--search TEXT --author TEXT --filter TEXT --sort CHOICE --limit INTEGER --expand TEXT --human-readable --tree --recursive --revision TEXT --format CHOICE]
• hf spaces logs SPACE_ID — Récupérer les logs d'exécution ou de construction d'un Space. [--build --follow --tail INTEGER --format CHOICE]
• hf spaces pause SPACE_ID — Mettre en pause un Space. [--format CHOICE]
• hf spaces restart SPACE_ID — Redémarrer un Space. [--factory-reboot --format CHOICE]
• hf spaces search QUERY — Rechercher les spaces du Hub avec la recherche sémantique. [--filter TEXT --sdk TEXT --include-non-running --description --limit INTEGER --format CHOICE]
• hf spaces settings SPACE_ID — Mettre à jour les paramètres d'un Space. [--sleep-time INTEGER --hardware CHOICE --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 du 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 — Afficher uniquement les IDs (un par ligne).
• --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 plutôt que de passer --token.
• --type — Le type de dépôt (modèle, dataset ou space).

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

Pour monter les dépôts Hub ou buckets comme 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
• Mettez à jour le CLI avec hf update (utilise la commande correcte pour la méthode d'installation détectée)