Hub Python Library documentation
hf
hf
CLI du Hugging Face Hub
Utilisation :
$ hf [OPTIONS] [COMMAND] [ARGS]...Options :
--skills: Affiche le fichierhf-cliSKILL.md sur la sortie standard (alias dehf skills preview).--install-completion: Installe la complétion pour le shell actuel.--show-completion: Affiche la complétion pour le shell actuel, afin de la copier ou de personnaliser l’installation.--help: Affiche ce message et quitte.
Commandes :
auth: Gérer l’authentification (connexion, déconnexion, etc.).buckets: commandes pour interagir avec les buckets.cache: Gérer le répertoire de cache local.collections: Interagir avec les collections sur le Hub.cp: Copie des fichiers entre des chemins locaux, des dépôts et des buckets.datasets: Interagir avec les jeux de données sur le Hub.discussions: Gérer les discussions et les pull requests sur le Hub.download: Télécharge des fichiers depuis le Hub.endpoints: Gérer les Hugging Face Inference Endpoints.env: Affiche des informations sur l'environnement.extensions: Gérer les extensions de la CLI hf. [alias : ext]jobs: Exécuter et gérer des Jobs sur le Hub.lfs-enable-largefiles: Configurez votre dépôt pour autoriser le téléversement de fichiers de plus de 5 Go.lfs-multipart-upload: agent de transfert personnalisé git-lfs interne pour les téléversements multipart.models: Interagir avec les modèles sur le Hub.papers: Interagir avec les papiers sur le Hub.repos: Gérer les dépôts sur le Hub.sandbox: Exécutez et gérez des environnements de test expérimentaux sur Hugging Face Jobs.skills: Gérer les compétences des assistants IA.spaces: Interagir avec les espaces sur le Hub.sync: Synchronise les fichiers entre un répertoire local et un bucket.update: Mettre à jour le CLIhfvers la dernière version.upload: téléverse un fichier ou un dossier sur le Hub.version: Affiche des informations sur la version de hf.webhooks: Gérer les webhooks sur le Hub.
hf auth
Gérer l’authentification (connexion, déconnexion, etc.).
Utilisation :
$ hf auth [OPTIONS] COMMAND [ARGS]...Options :
--help: Affiche ce message et quitte.
Commandes :
list: Liste tous les jetons d'accès stockés. [alias : ls]login: Connectez-vous depuis votre navigateur, ou à l'aide d'un jeton issu de huggingface.co/settings/tokens.logout: Se déconnecter d'un jeton spécifique.switch: Permet de basculer entre les jetons d'accès.token: Affiche le jeton d'accès actuel sur la sortie standard.whoami: Permet de savoir sur quel compte huggingface.co vous êtes connecté.
hf auth list
Liste tous les jetons d'accès stockés. [alias: ls]
Utilisation :
$ hf auth list [OPTIONS]Options :
--help: Affiche ce message et quitte.
Exemples $c hf auth list$
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf auth login
Connectez-vous depuis votre navigateur, ou à l'aide d'un jeton depuis huggingface.co/settings/tokens.
Utilisation :
$ hf auth login [OPTIONS]Options :
--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--add-to-git-credential / --no-add-to-git-credential: Enregistrer dans l’assistant de credentials git. Utile uniquement si vous prévoyez d’exécuter des commandes git directement. [défaut : no-add-to-git-credential]--force / --no-force: Force la réauthentification même si vous êtes déjà connecté. [défaut : no-force]--help: Affiche ce message et quitte.
Exemples $ hf auth login $ hf auth login —token $HF_TOKEN $ hf auth login —token $HF_TOKEN —add-to-git-credential $ hf auth login —force
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf auth logout
Se déconnecter d'un jeton spécifique.
Utilisation :
$ hf auth logout [OPTIONS]Options :
--token-name TEXT: Nom du jeton pour lequel se déconnecter--help: Affiche ce message et quitte.
Exemples $ hf auth logout $ hf auth logout —token-name my-token
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf auth switch
Basculer entre les jetons d'accès.
Utilisation :
$ hf auth switch [OPTIONS]Options :
--token-name TEXT: Nom du jeton à activer--add-to-git-credential / --no-add-to-git-credential: Enregistrer dans l’assistant de credentials git. Utile uniquement si vous prévoyez d’exécuter des commandes git directement. [défaut : no-add-to-git-credential]--help: Affiche ce message et quitte.
Exemples $ hf auth switch $ hf auth switch —token-name my-token
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf auth token
Afficher le jeton d'accès actuel sur la sortie standard.
Utilisation :
$ hf auth token [OPTIONS]Options :
--help: Affiche ce message et quitte.
Exemples $ hf auth token $ hf auth token | xargs curl -H ‘Authorization: Bearer {}’
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf auth whoami
Découvrez le compte huggingface.co en tant auquel vous êtes connecté.
Utilisation :
$ hf auth whoami [OPTIONS]Options :
--help: Affiche ce message et quitte.
Exemples $ hf auth whoami $ hf auth whoami —format json
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf buckets
Commandes pour interagir avec les buckets.
Utilisation :
$ hf buckets [OPTIONS] COMMAND [ARGS]...Options :
--help: Affiche ce message et quitte.
Commandes :
cp: Copie des fichiers entre des chemins locaux, des dépôts et des buckets.create: Créer un nouveau bucket.delete: Supprimer un bucket.info: Récupère des informations sur un bucket.list: Liste les buckets ou les fichiers d'un bucket. [alias : ls]move: Déplacer (renommer) un bucket vers un nouveau nom ou un nouvel espace de noms.remove: Supprime des fichiers d’un bucket. [alias : rm]settings: Mettre à jour les paramètres du bucket (visibilité).sync: Synchronise les fichiers entre un répertoire local et un bucket.
hf buckets cp
Copier des fichiers entre des chemins locaux, des dépôts et des buckets.
Gère les téléversements (local/stdin -> dépôt/bac), les téléchargements (dépôt/bac -> local/stdout) et les copies distantes (dépôt/bac -> dépôt/bac). Les copies bac-vers-dépôt et local-vers-local ne sont pas prises en charge. Pour les répertoires, utilisez hf upload/hf download (dépôts) ou hf buckets sync (bacs). Les copies distantes ne fonctionnent que dans la même région de stockage (https://huggingface.co/docs/hub/storage-regions).
Utilisation :
$ hf buckets cp [OPTIONS] SRC [DST]Arguments :
SRC: Source : fichier local, URI hf:// (dépôt ou bucket) ou - pour l'entrée standard. [obligatoire][DST]: Destination : chemin local, URI hf:// (dépôt ou bucket) ou - pour la sortie standard.
Options :
--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf buckets cp hf://buckets/username/my-bucket/config.json config.json $ hf buckets cp hf://buckets/username/my-bucket/data.csv data/ $ hf buckets cp hf://buckets/username/my-bucket/config.json - $ hf buckets cp model.safetensors hf://buckets/username/my-bucket/model.safetensors $ hf buckets cp config.json hf://buckets/username/my-bucket/logs/ $ hf buckets cp - hf://buckets/username/my-bucket/config.json $ hf buckets cp hf://buckets/username/my-bucket/data.csv hf://buckets/username/dest-bucket/ $ hf buckets cp hf://buckets/username/source-bucket/logs/ hf://buckets/username/dest-bucket/logs/
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf buckets create
Créer un nouveau bucket.
Utilisation :
$ hf buckets create [OPTIONS] BUCKET_IDArguments :
BUCKET_ID: ID du bucket : bucket_name, namespace/bucket_name ou hf://buckets/namespace/bucket_name [obligatoire]
Options :
--private: crée un bucket privé.--region [us|eu]: Région cloud dans laquelle créer le bucket. Peut être ‘us’ ou ‘eu’. Nécessite un abonnement Team ou supérieur.--exist-ok: Ne pas lever d'erreur si le bucket existe déjà.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf buckets create my-bucket $ hf buckets create user/my-bucket $ hf buckets create hf://buckets/user/my-bucket $ hf buckets create user/my-bucket —private $ hf buckets create user/my-bucket —exist-ok $ hf buckets create user/my-bucket —region us
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf buckets delete
Supprimer un bucket.
Cette commande supprime l'intégralité du bucket ainsi que tout son contenu. Utilisez hf buckets rm pour supprimer des fichiers individuels.
Utilisation :
$ hf buckets delete [OPTIONS] BUCKET_IDArguments :
BUCKET_ID: ID du bucket : namespace/bucket_name ou hf://buckets/namespace/bucket_name [obligatoire]
Options :
-y, --yes: Ignore la demande de confirmation.--missing-ok: Ne pas lever d'erreur si le bucket n'existe pas.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf buckets delete user/my-bucket $ hf buckets delete hf://buckets/user/my-bucket $ hf buckets delete user/my-bucket —yes $ hf buckets delete user/my-bucket —missing-ok
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf buckets info
Obtenir des informations sur un bucket.
Utilisation :
$ hf buckets info [OPTIONS] BUCKET_IDArguments :
BUCKET_ID: ID du bucket : namespace/bucket_name ou hf://buckets/namespace/bucket_name [obligatoire]
Options :
--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf buckets info user/my-bucket $ hf buckets info hf://buckets/user/my-bucket
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf buckets list
Liste les buckets ou les fichiers d'un bucket. [alias: ls]
Lorsqu'elle est appelée sans argument ou avec un espace de noms, elle liste les buckets. Lorsqu'elle est appelée avec un identifiant de bucket (namespace/bucket_name), elle liste les fichiers du bucket.
Utilisation :
$ hf buckets list [OPTIONS] [ARGUMENT]Arguments :
[ARGUMENT]: espace de noms (utilisateur ou organisation) pour lister les buckets, ou identifiant de bucket (namespace/bucket_name(/prefix) ou hf://buckets/…) pour lister les fichiers.
Options :
-h, --human-readable: Affiche les tailles dans un format lisible par l'homme.--tree: Liste les fichiers au format arborescence (uniquement pour la liste des fichiers).-R, --recursive: Liste les fichiers de manière récursive (uniquement pour la liste des fichiers).--search TEXT: Requête de recherche.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf buckets list $ hf buckets list huggingface $ hf buckets list —search “my-prefix” $ hf buckets list user/my-bucket $ hf buckets list user/my-bucket -R $ hf buckets list user/my-bucket -h $ hf buckets list user/my-bucket —tree $ hf buckets list user/my-bucket —tree -h $ hf buckets list hf://buckets/user/my-bucket $ hf buckets list user/my-bucket/sub -R
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf buckets move
Déplacer (renommer) un bucket vers un nouveau nom ou un nouvel espace de noms.
Utilisation :
$ hf buckets move [OPTIONS] FROM_ID TO_IDArguments :
FROM_ID: ID du bucket source : namespace/bucket_name ou hf://buckets/namespace/bucket_name [obligatoire]TO_ID: ID du bucket de destination : namespace/bucket_name ou hf://buckets/namespace/bucket_name [obligatoire]
Options :
--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf buckets move user/old-bucket user/new-bucket $ hf buckets move user/my-bucket my-org/my-bucket $ hf buckets move hf://buckets/user/old-bucket hf://buckets/user/new-bucket
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf buckets remove
Supprimer des fichiers d’un bucket. [alias: rm]
Pour supprimer un bucket entier, utilisez hf buckets delete à la place.
Utilisation :
$ hf buckets remove [OPTIONS] ARGUMENTArguments :
ARGUMENT: Chemin du bucket : namespace/bucket_name/chemin ou hf://buckets/namespace/bucket_name/chemin. Avec —recursive, namespace/bucket_name est également accepté pour cibler tous les fichiers. [obligatoire]
Options :
-R, --recursive: Supprime récursivement les fichiers sous le préfixe donné.-y, --yes: Ignore la demande de confirmation.--dry-run: Aperçu de ce qui serait supprimé, sans effectuer la suppression.--include TEXT: Inclure uniquement les fichiers correspondant au motif (plusieurs motifs peuvent être spécifiés). Nécessite —recursive.--exclude TEXT: Exclure les fichiers correspondant au motif (peut être spécifié plusieurs fois). Nécessite —recursive.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf buckets remove user/my-bucket/file.txt $ hf buckets rm hf://buckets/user/my-bucket/file.txt $ hf buckets rm user/my-bucket/logs/ —recursive $ hf buckets rm user/my-bucket —recursive —include “*.tmp” $ hf buckets rm user/my-bucket/data/ —recursive —dry-run
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf buckets settings
Mettre à jour les paramètres du bucket (visibilité).
Utilisation :
$ hf buckets settings [OPTIONS] BUCKET_IDArguments :
BUCKET_ID: ID du bucket : namespace/bucket_name ou hf://buckets/namespace/bucket_name [obligatoire]
Options :
--private: Rendre le bucket privé.--public: Rendre le bucket public.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf buckets settings user/my-bucket —private $ hf buckets settings user/my-bucket —public $ hf buckets settings hf://buckets/user/my-bucket —private
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf buckets sync
Synchroniser les fichiers entre un répertoire local et un bucket.
Utilisation :
$ hf buckets sync [OPTIONS] [SOURCE] [DEST]Arguments :
[SOURCE]: Chemin source : répertoire local ou hf://buckets/namespace/bucket_name(/prefix)[DEST]: Chemin de destination : répertoire local ou hf://buckets/namespace/bucket_name(/prefix)
Options :
--delete / --no-delete: Supprime les fichiers de destination qui ne sont pas présents dans la source. [valeur par défaut : no-delete]--ignore-times: Ignorer les fichiers uniquement en fonction de leur taille, en ignorant les dates de modification.--ignore-sizes: Ignorer les fichiers uniquement sur la base des horodatages de modification, en ignorant les tailles.--plan TEXT: Enregistre le plan de synchronisation dans un fichier JSONL pour examen au lieu de l'exécuter.--apply TEXT: Applique un fichier de plan enregistré précédemment.--dry-run: Affiche le plan de synchronisation sur la sortie standard au format JSONL sans l'exécuter.--include TEXT: Inclure les fichiers correspondant au motif (plusieurs motifs peuvent être spécifiés).--exclude TEXT: Exclure les fichiers correspondant au motif (peut être spécifié plusieurs fois).--filter-from TEXT: Lit les motifs d'inclusion/exclusion depuis un fichier.--existing: Ignorer la création de nouveaux fichiers sur le récepteur (ne mettre à jour que les fichiers existants).--ignore-existing: Ignore la mise à jour des fichiers existants sur le récepteur (crée uniquement de nouveaux fichiers).-v, --verbose: Affiche un journal détaillé avec le raisonnement.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf buckets sync ./data hf://buckets/user/my-bucket $ hf buckets sync hf://buckets/user/my-bucket ./data $ hf buckets sync ./data hf://buckets/user/my-bucket —delete $ hf buckets sync hf://buckets/user/my-bucket ./data —include ”.safetensors” —exclude ”.tmp” $ hf buckets sync ./data hf://buckets/user/my-bucket —plan sync-plan.jsonl $ hf buckets sync —apply sync-plan.jsonl $ hf buckets sync ./data hf://buckets/user/my-bucket —dry-run $ hf buckets sync ./data hf://buckets/user/my-bucket —dry-run | jq .
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf cache
Gérer le répertoire de cache local.
Utilisation :
$ hf cache [OPTIONS] COMMAND [ARGS]...Options :
--help: Affiche ce message et quitte.
Commandes :
list: Liste les dépôts ou révisions mis en cache. [alias : ls]prune: Supprime les révisions détachées et les téléchargements incomplets du cache.rm: Supprime des dépôts, des révisions ou des fichiers en cache.verify: Vérifie les sommes de contrôle d'une seule révision de dépôt depuis le cache ou un répertoire local.
hf cache list
Liste les dépôts ou révisions en cache. [alias: ls]
Utilisation :
$ hf cache list [OPTIONS]Options :
--cache-dir TEXT: répertoire de cache à analyser (par défaut, le cache Hugging Face).--revisions / --no-revisions: Inclure les révisions dans la sortie au lieu des dépôts agrégés. [défaut : no-revisions]-f, --filter TEXT: Filtre les entrées (par ex. ‘size>1GB’, ‘type=model’, ‘accessed>7d’). Peut être utilisé plusieurs fois.--sort [accessed|accessed:asc|accessed:desc|modified|modified:asc|modified:desc|name|name:asc|name:desc|size|size:asc|size:desc]: Trie les entrées par clé. Clés prises en charge : ‘accessed’, ‘modified’, ‘name’, ‘size’. Ajoutez ‘:asc’ ou ‘:desc’ pour définir explicitement l’ordre (par ex. ‘modified:asc’). Valeurs par défaut : ‘accessed’, ‘modified’ et ‘size’ sont triés par défaut en ‘desc’ (du plus récent/plus grand au plus ancien/petit) ; ‘name’ est trié par défaut en ‘asc’ (ordre alphabétique).--limit INTEGER: Limite le nombre de résultats renvoyés. N'affiche que les N premières entrées après tri.--show-warnings / --no-show-warnings: Affiche les avertissements concernant les incohérences du cache. [défaut : no-show-warnings]--help: Affiche ce message et quitte.
Exemples $ hf cache ls $ hf cache ls —revisions $ hf cache ls —filter “size>1GB” —limit 20 $ hf cache ls —format json
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf cache prune
Supprimez les révisions détachées et les téléchargements incomplets du cache.
Utilisation :
$ hf cache prune [OPTIONS]Options :
--cache-dir TEXT: répertoire de cache à analyser (par défaut, le cache Hugging Face).-y, --yes: Ignore la demande de confirmation.--dry-run / --no-dry-run: Prévisualiser les suppressions sans rien supprimer. [par défaut : no-dry-run]--help: Affiche ce message et quitte.
Exemples $ hf cache prune $ hf cache prune —dry-run
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf cache rm
Supprimez les dépôts, révisions ou fichiers en cache.
Utilisation :
$ hf cache rm [OPTIONS] TARGETS...Arguments :
TARGETS...: Un ou plusieurs identifiants de dépôt (par exemple model/bert-base-uncased), des URI hf:// (dépôt ou fichier) ou des hachages de révision à supprimer. [obligatoire]
Options :
--cache-dir TEXT: répertoire de cache à analyser (par défaut, le cache Hugging Face).-y, --yes: Ignore la demande de confirmation.--dry-run / --no-dry-run: Prévisualiser les suppressions sans rien supprimer. [par défaut : no-dry-run]--help: Affiche ce message et quitte.
Exemples $ hf cache rm model/gpt2 $ hf cache rm hf://models/openai-community/gpt2 $ hf cache rm hf://models/openai-community/gpt2/model.safetensors $ hf cache rm <revision_hash> $ hf cache rm model/gpt2 —dry-run $ hf cache rm model/gpt2 —yes
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf cache verify
Vérifier les sommes de contrôle pour une seule révision de dépôt depuis le cache ou un répertoire local.
Exemples :
- Vérifier la révision principale dans le cache :
hf cache verify gpt2 - Vérifier une révision spécifique :
hf cache verify gpt2 --revision refs/pr/1 - Vérifier le jeu de données :
hf cache verify karpathy/fineweb-edu-100b-shuffle --repo-type dataset - Vérifier le répertoire local :
hf cache verify deepseek-ai/DeepSeek-OCR --local-dir /path/to/repo
Utilisation :
$ hf cache verify [OPTIONS] REPO_IDArguments :
REPO_ID: l'identifiant du dépôt (par exempleusername/repo-nameouspaces/username/repo-name). [obligatoire]
Options :
--type, --repo-type [model|dataset|space|kernel]: le type de dépôt (model, dataset, space ou kernel). [défaut : model]--revision TEXT: identifiant de révision Git, qui peut être un nom de branche, un tag ou un hachage de commit.--cache-dir TEXT: répertoire de cache à utiliser lors de la vérification des fichiers depuis le cache (par défaut, le cache Hugging Face).--local-dir TEXT: Si défini, vérifie les fichiers sous ce répertoire au lieu du cache.--fail-on-missing-files: Échoue si certains fichiers existent à distance mais sont absents localement.--fail-on-extra-files: Échoue si certains fichiers existent localement mais ne sont pas présents sur la révision distante.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf cache verify gpt2 $ hf cache verify gpt2 —revision refs/pr/1 $ hf cache verify my-dataset —repo-type dataset
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf collections
Interagissez avec les collections sur le Hub.
Utilisation :
$ hf collections [OPTIONS] COMMAND [ARGS]...Options :
--help: Affiche ce message et quitte.
Commandes :
add-item: Ajoute un élément à une collection.create: crée une nouvelle collection sur le Hub.delete: Supprime une collection du Hub.delete-item: Supprimer un élément d'une collection.info: Récupère des informations sur une collection du Hub.list: Affiche les collections sur le Hub. [alias : ls]update: Met à jour les métadonnées d’une collection sur le Hub.update-item: Met à jour un élément dans une collection.
hf collections add-item
Ajouter un élément à une collection.
Utilisation :
$ hf collections add-item [OPTIONS] COLLECTION_SLUG ITEM_ID ITEM_TYPE:{model|dataset|space|paper|collection|bucket}Arguments :
COLLECTION_SLUG: le slug de la collection (par exemple, ‘username/collection-slug’). [obligatoire]ITEM_ID: l'identifiant de l'élément à ajouter (repo_id pour les dépôts, identifiant de l'article pour les papiers). [obligatoire]ITEM_TYPE:{model|dataset|space|paper|collection|bucket}: Le type d'élément (model, dataset, space, paper, collection ou bucket). [obligatoire]
Options :
--note TEXT: Une note à joindre à l'élément (500 caractères maximum).--exists-ok / --no-exists-ok: Ne pas lever d'erreur si l'élément est déjà présent dans la collection. [valeur par défaut : no-exists-ok]--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf collections add-item username/my-collection moonshotai/kimi-k2 model $ hf collections add-item username/my-collection Qwen/DeepPlanning dataset —note “Useful dataset” $ hf collections add-item username/my-collection Tongyi-MAI/Z-Image space
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf collections create
Créer une nouvelle collection sur le Hub.
Utilisation :
$ hf collections create [OPTIONS] TITLEArguments :
TITLE: Le titre de la collection. [obligatoire]
Options :
--namespace TEXT: l'espace de noms (nom d'utilisateur ou organisation). Par défaut, l'utilisateur authentifié.--description TEXT: Une description pour la collection (150 caractères maximum).--private / --no-private: Créer une collection privée. [par défaut : no-private]--exists-ok / --no-exists-ok: Ne pas lever d'erreur si la collection existe déjà. [défaut : no-exists-ok]--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf collections create “My Models” $ hf collections create “My Models” —description “A collection of my favorite models” —private $ hf collections create “Org Collection” —namespace my-org
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf collections delete
Supprimer une collection du Hub.
Utilisation :
$ hf collections delete [OPTIONS] COLLECTION_SLUGArguments :
COLLECTION_SLUG: le slug de la collection (par exemple, ‘username/collection-slug’). [obligatoire]
Options :
--missing-ok / --no-missing-ok: Ne pas lever d'erreur si la collection n'existe pas. [défaut : no-missing-ok]--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf collections delete username/my-collection $ hf collections delete username/my-collection —missing-ok
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf collections delete-item
Supprimer un élément d'une collection.
Utilisation :
$ hf collections delete-item [OPTIONS] COLLECTION_SLUG ITEM_OBJECT_IDArguments :
COLLECTION_SLUG: le slug de la collection (par exemple, ‘username/collection-slug’). [obligatoire]ITEM_OBJECT_ID: l’identifiant de l’élément dans la collection (récupéré depuis le champitem_object_idrenvoyé par ‘hf collections info’. [obligatoire]
Options :
--missing-ok / --no-missing-ok: Ne pas lever d'erreur si l'élément n'existe pas. [défaut : no-missing-ok]--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
hf collections info
Obtenir des informations sur une collection sur le Hub.
Utilisation :
$ hf collections info [OPTIONS] COLLECTION_SLUGArguments :
COLLECTION_SLUG: le slug de la collection (par exemple, ‘username/collection-slug’). [obligatoire]
Options :
--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf collections info username/my-collection-slug
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf collections list
Lister les collections sur le Hub. [alias: ls]
Utilisation :
$ hf collections list [OPTIONS]Options :
--owner TEXT: Filtre par nom d'utilisateur ou organisation du propriétaire.--item TEXT: Filtre les collections contenant un élément spécifique (par exemple, “models/gpt2”, “datasets/squad”, “papers/2311.12983”).--sort [lastModified|trending|upvotes]: Trie les résultats par date de dernière modification, tendance ou nombre de votes positifs.--limit INTEGER: Limite le nombre de résultats. [défaut : 10]--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf collections ls $ hf collections ls —owner nvidia $ hf collections ls —item models/teknium/OpenHermes-2.5-Mistral-7B —limit 10
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf collections update
Mettre à jour les métadonnées d’une collection sur le Hub.
Utilisation :
$ hf collections update [OPTIONS] COLLECTION_SLUGArguments :
COLLECTION_SLUG: le slug de la collection (par exemple, ‘username/collection-slug’). [obligatoire]
Options :
--title TEXT: Le nouveau titre de la collection.--description TEXT: La nouvelle description de la collection (150 caractères maximum).--position INTEGER: La nouvelle position de la collection dans la liste du propriétaire.--private / --no-private: Indique si la collection doit être privée.--theme TEXT: la couleur du thème de la collection (par exemple, ‘green’, ‘blue’).--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf collections update username/my-collection —title “New Title” $ hf collections update username/my-collection —description “Updated description” $ hf collections update username/my-collection —private —theme green
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf collections update-item
Mettre à jour un élément dans une collection.
Utilisation :
$ hf collections update-item [OPTIONS] COLLECTION_SLUG ITEM_OBJECT_IDArguments :
COLLECTION_SLUG: le slug de la collection (par exemple, ‘username/collection-slug’). [obligatoire]ITEM_OBJECT_ID: l'identifiant de l'élément dans la collection (issu du champ 'item_object_id', et non du repo_id). [obligatoire]
Options :
--note TEXT: Une nouvelle note pour l'élément (500 caractères maximum).--position INTEGER: La nouvelle position de l'élément dans la collection.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf collections update-item username/my-collection ITEM_OBJECT_ID —note “Updated note” $ hf collections update-item username/my-collection ITEM_OBJECT_ID —position 0
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf cp
Copier des fichiers entre des chemins locaux, des dépôts et des buckets.
Gère les téléversements (local/stdin -> dépôt/bac), les téléchargements (dépôt/bac -> local/stdout) et les copies distantes (dépôt/bac -> dépôt/bac). Les copies bac-vers-dépôt et local-vers-local ne sont pas prises en charge. Pour les répertoires, utilisez hf upload/hf download (dépôts) ou hf buckets sync (bacs). Les copies distantes ne fonctionnent que dans la même région de stockage (https://huggingface.co/docs/hub/storage-regions).
Utilisation :
$ hf cp [OPTIONS] SRC [DST]Arguments :
SRC: Source : fichier local, URI hf:// (dépôt ou bucket) ou - pour l'entrée standard. [obligatoire][DST]: Destination : chemin local, URI hf:// (dépôt ou bucket) ou - pour la sortie standard.
Options :
--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf cp hf://username/my-model/config.json $ hf cp hf://username/my-model/config.json ./config.json $ hf cp hf://datasets/username/my-dataset/data.csv ./data/ $ hf cp hf://buckets/username/my-bucket/config.json - $ hf cp ./model.safetensors hf://username/my-model/model.safetensors $ hf cp ./config.json hf://buckets/username/my-bucket/logs/ $ hf cp - hf://buckets/username/my-bucket/config.json $ hf cp hf://username/source-model/ hf://username/dest-model/ $ hf cp hf://datasets/username/my-dataset/processed/ hf://buckets/username/my-bucket/processed/ $ hf cp hf://buckets/username/my-bucket/logs/ hf://buckets/username/archive-bucket/ # copies contents only
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf datasets
Interagissez avec les jeux de données sur le Hub.
Utilisation :
$ hf datasets [OPTIONS] COMMAND [ARGS]...Options :
--help: Affiche ce message et quitte.
Commandes :
card: Récupérer la carte du jeu de données (README) pour un jeu de données sur le Hub.info: Récupérer des informations sur un jeu de données sur le Hub.leaderboard: Liste les scores des modèles d'un tableau de classement de jeu de données.list: Liste les jeux de données sur le Hub, ou les fichiers d’un dépôt de jeu de données. [alias : ls]parquet: liste les URL des fichiers parquet disponibles pour un jeu de données.sql: Exécute une requête SQL brute avec DuckDB sur les URL parquet du jeu de données.
hf carte de jeu de données
Obtenir la carte du jeu de données (README) pour un jeu de données sur le Hub.
Utilisation :
$ hf datasets card [OPTIONS] DATASET_IDArguments :
DATASET_ID: l'identifiant du jeu de données (par exempleusername/repo-name). [obligatoire]
Options :
--metadata: Affiche uniquement les métadonnées de la carte.--text: Affiche uniquement le corps du texte (sans métadonnées).--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf datasets card HuggingFaceFW/fineweb $ hf datasets card HuggingFaceFW/fineweb —metadata $ hf datasets card HuggingFaceFW/fineweb —metadata —format json $ hf datasets card HuggingFaceFW/fineweb —text
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf datasets info
Obtenir des informations sur un jeu de données sur le Hub.
Utilisation :
$ hf datasets info [OPTIONS] DATASET_IDArguments :
DATASET_ID: l'identifiant du jeu de données (par exempleusername/repo-name). [obligatoire]
Options :
--revision TEXT: identifiant de révision Git, qui peut être un nom de branche, un tag ou un hachage de commit.--expand TEXT: Propriétés à retourner, séparées par des virgules. Lorsqu’il est utilisé, seules les propriétés listées (et id) sont retournées. Exemple : ‘—expand=downloads,likes,tags’. Valides : author, cardData, citation, createdAt, description, disabled, downloads, downloadsAllTime, gated, lastModified, likes, mainSize, paperswithcode_id, private, resourceGroup, sha, siblings, tags, trendingScore, usedStorage.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf datasets info HuggingFaceFW/fineweb $ hf datasets info my-dataset —expand downloads,likes,tags
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf datasets leaderboard
Affiche les scores des modèles d’un tableau de classement de jeu de données. Cette commande aide à trouver les meilleurs modèles pour une tâche ou à comparer des modèles selon leurs scores de référence. Utilisez hf datasets ls —filter benchmark:official pour lister les tableaux de classement disponibles.
Utilisation :
$ hf datasets leaderboard [OPTIONS] DATASET_IDArguments :
DATASET_ID: l'identifiant du jeu de données de référence (par exempleSWE-bench/SWE-bench_Verified). [obligatoire]
Options :
--limit INTEGER: Limite le nombre de résultats. [défaut : 20]--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf datasets leaderboard SWE-bench/SWE-bench_Verified $ hf datasets leaderboard SWE-bench/SWE-bench_Verified —limit 5 —format json $ hf datasets ls —filter benchmark:official # list available leaderboards
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf datasets list
Liste les jeux de données sur le Hub, ou les fichiers d’un dépôt de jeu de données. [alias: ls]
Lorsqu'il est appelé sans argument, il liste les jeux de données sur le Hub. Lorsqu'il est appelé avec un identifiant de jeu de données, il liste les fichiers du dépôt de ce jeu de données.
Utilisation :
$ hf datasets list [OPTIONS] [REPO_ID]Arguments :
[REPO_ID]: ID du jeu de données (par exempleusername/repo-name) à partir duquel lister les fichiers. S'il est omis, liste les jeux de données.
Options :
--search TEXT: Requête de recherche.--author TEXT: Filtrer par auteur ou organisation.--filter TEXT: Filtre par balises (par ex. ‘text-classification’). Peut être utilisé plusieurs fois.--sort [created_at|downloads|last_modified|likes|trending_score]: Trier les résultats.--limit INTEGER: Limite le nombre de résultats. [défaut : 30]--expand TEXT: Propriétés à retourner, séparées par des virgules. Lorsqu’il est utilisé, seules les propriétés listées (et id) sont retournées. Exemple : ‘—expand=downloads,likes,tags’. Valides : author, cardData, citation, createdAt, description, disabled, downloads, downloadsAllTime, gated, lastModified, likes, mainSize, paperswithcode_id, private, resourceGroup, sha, siblings, tags, trendingScore, usedStorage.-h, --human-readable: Affiche les tailles dans un format lisible (uniquement pour la liste des fichiers).--tree: Liste les fichiers au format arborescence (uniquement pour la liste des fichiers).-R, --recursive: Liste les fichiers de manière récursive (uniquement pour la liste des fichiers).--revision TEXT: identifiant de révision Git, qui peut être un nom de branche, un tag ou un hachage de commit.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf datasets ls $ hf datasets ls —sort downloads —limit 10 $ hf datasets ls —search “code” $ hf datasets ls —filter benchmark:official $ hf datasets ls HuggingFaceFW/fineweb $ hf datasets ls HuggingFaceFW/fineweb -R $ hf datasets ls HuggingFaceFW/fineweb —tree -h
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf datasets parquet
Liste les URL des fichiers parquet disponibles pour un jeu de données.
Utilisation :
$ hf datasets parquet [OPTIONS] DATASET_IDArguments :
DATASET_ID: l'identifiant du jeu de données (par exempleusername/repo-name). [obligatoire]
Options :
--subset TEXT: Filtre les entrées parquet par sous-ensemble/configuration.--split TEXT: Filtre les entrées parquet par split.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf datasets parquet cfahlgren1/hub-stats $ hf datasets parquet cfahlgren1/hub-stats —subset models $ hf datasets parquet cfahlgren1/hub-stats —split train $ hf datasets parquet cfahlgren1/hub-stats —format json
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf datasets sql
Exécuter une requête SQL brute avec DuckDB sur les URL de fichiers parquet du jeu de données.
Utilisation :
$ hf datasets sql [OPTIONS] SQLArguments :
SQL: Requête SQL brute à exécuter. [obligatoire]
Options :
--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf datasets sql “SELECT COUNT() AS rows FROM read_parquet(’https://huggingface.co/api/datasets/cfahlgren1/hub-stats/parquet/models/train/0.parquet’)” $ hf datasets sql “SELECT FROM read_parquet(’https://huggingface.co/api/datasets/cfahlgren1/hub-stats/parquet/models/train/0.parquet’) LIMIT 5” —format json
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf discussions
Gérer les discussions et les pull requests sur le Hub.
Utilisation :
$ hf discussions [OPTIONS] COMMAND [ARGS]...Options :
--help: Affiche ce message et quitte.
Commandes :
close: Ferme une discussion ou une pull request.comment: Commenter une discussion ou une pull request.create: Créer une nouvelle discussion ou une nouvelle pull request sur un dépôt.diff: Affiche le diff d’une pull request.edit: Modifier un commentaire existant sur une discussion ou une pull request.info: Récupère des informations sur une discussion ou une pull request.list: Liste les discussions et les pull requests d'un dépôt. [alias : ls]merge: fusionner une pull request.rename: Renommer une discussion ou une pull request.reopen: Rouvrir une discussion ou une pull request fermée.
hf discussions close
Fermer une discussion ou une pull request.
Utilisation :
$ hf discussions close [OPTIONS] REPO_ID NUMArguments :
REPO_ID: l'identifiant du dépôt (par exempleusername/repo-nameouspaces/username/repo-name). [obligatoire]NUM: numéro de la discussion ou de la pull request. [obligatoire]
Options :
--comment TEXT: un commentaire facultatif à publier lors de la fermeture.-y, --yes: Ignore la demande de confirmation.--type, --repo-type [model|dataset|space|kernel]: le type de dépôt (model, dataset, space ou kernel). [défaut : model]--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf discussions close username/my-model 5 $ hf discussions close username/my-model 5 —comment “Closing as resolved.”
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
commentaire de discussion hf
Commenter une discussion ou une pull request.
Utilisation :
$ hf discussions comment [OPTIONS] REPO_ID NUMArguments :
REPO_ID: l'identifiant du dépôt (par exempleusername/repo-nameouspaces/username/repo-name). [obligatoire]NUM: numéro de la discussion ou de la pull request. [obligatoire]
Options :
--body TEXT: le texte du commentaire (prend en charge le Markdown).--body-file PATH: Lit le commentaire depuis un fichier. Utilisez ’-’ pour l’entrée standard.--attach TEXT: Attacher un fichier image, vidéo ou audio, au format ‘FILE’ ou ‘FILE#texte alternatif’. Une référence ‘’ dans le corps du message est remplacée par le fichier téléversé, les autres fichiers sont ajoutés. Peut être utilisé plusieurs fois.
--type, --repo-type [model|dataset|space|kernel]: le type de dépôt (model, dataset, space ou kernel). [défaut : model]--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf discussions comment username/my-model 5 —body “Thanks for reporting!” $ hf discussions comment username/my-model 5 —body “LGTM!” $ hf discussions comment username/my-model 5 —body “Here is a demo:” —attach demo.mp4
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf discussions create
Créer une nouvelle discussion ou une demande de tirage (pull request) sur un dépôt.
Utilisation :
$ hf discussions create [OPTIONS] REPO_IDArguments :
REPO_ID: l'identifiant du dépôt (par exempleusername/repo-nameouspaces/username/repo-name). [obligatoire]
Options :
--title TEXT: Le titre de la discussion ou de la pull request. [obligatoire]--body TEXT: La description (prend en charge le Markdown).--body-file PATH: Lit la description depuis un fichier. Utilisez ’-’ pour l’entrée standard.--pull-request, --pr: Créer une pull request au lieu d'une discussion.--attach TEXT: Attacher un fichier image, vidéo ou audio, au format ‘FILE’ ou ‘FILE#texte alternatif’. Une référence ‘--type, --repo-type [model|dataset|space|kernel]: le type de dépôt (model, dataset, space ou kernel). [défaut : model]--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf discussions create username/my-model —title “Bug report” $ hf discussions create username/my-model —title “Feature request” —body “Please add X” $ hf discussions create username/my-model —title “Fix typo” —pull-request $ hf discussions create username/my-dataset —type dataset —title “Data quality issue” $ hf discussions create username/my-model —title “Fix rendering” —pr —attach “./before.png#Before the fix” —attach ./after.png
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf discussions diff
Afficher la diff d'une pull request.
Utilisation :
$ hf discussions diff [OPTIONS] REPO_ID NUMArguments :
REPO_ID: l'identifiant du dépôt (par exempleusername/repo-nameouspaces/username/repo-name). [obligatoire]NUM: numéro de la discussion ou de la pull request. [obligatoire]
Options :
--type, --repo-type [model|dataset|space|kernel]: le type de dépôt (model, dataset, space ou kernel). [défaut : model]--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $c hf discussions diff username/my-model 5$
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf discussions edit
Modifier un commentaire existant sur une discussion ou une pull request.
Utilisation :
$ hf discussions edit [OPTIONS] REPO_ID NUM COMMENT_IDArguments :
REPO_ID: l'identifiant du dépôt (par exempleusername/repo-nameouspaces/username/repo-name). [obligatoire]NUM: numéro de la discussion ou de la pull request. [obligatoire]COMMENT_ID: l’identifiant du commentaire à modifier (voir ‘hf discussions info … —format json’). [obligatoire]
Options :
--body TEXT: le texte du nouveau commentaire (prend en charge le Markdown).--body-file PATH: Lit le nouveau commentaire depuis un fichier. Utilisez ’-’ pour l’entrée standard.--attach TEXT: Attacher un fichier image, vidéo ou audio, au format ‘FILE’ ou ‘FILE#texte alternatif’. Une référence ‘--type, --repo-type [model|dataset|space|kernel]: le type de dépôt (model, dataset, space ou kernel). [défaut : model]--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples
$ hf discussions edit username/my-model 5 abc123 —body “Updated comment.”
$ hf discussions edit username/my-model 5 abc123 —body-file fixed.md
$ hf discussions edit username/my-model 5 abc123 —body “Fixed: 
” —attach ./after.png
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf discussions info
Obtenir des informations sur une discussion ou une pull request.
Utilisation :
$ hf discussions info [OPTIONS] REPO_ID NUMArguments :
REPO_ID: l'identifiant du dépôt (par exempleusername/repo-nameouspaces/username/repo-name). [obligatoire]NUM: numéro de la discussion ou de la pull request. [obligatoire]
Options :
--type, --repo-type [model|dataset|space|kernel]: le type de dépôt (model, dataset, space ou kernel). [défaut : model]--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf discussions info username/my-model 5 $ hf discussions info username/my-model 5 —format json
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf discussions list
Liste les discussions et les pull requests d'un dépôt. [alias: ls]
Utilisation :
$ hf discussions list [OPTIONS] REPO_IDArguments :
REPO_ID: l'identifiant du dépôt (par exempleusername/repo-nameouspaces/username/repo-name). [obligatoire]
Options :
-s, --status [open|closed|merged|draft|all]: Filtre par statut (open, closed, merged, draft, all). [défaut : open]-k, --kind [all|discussion|pull_request]: Filtre par type (discussion, pull_request, all). [défaut : all]--author TEXT: Filtrer par auteur ou organisation.--limit INTEGER: Limite le nombre de résultats. [défaut : 30]--type, --repo-type [model|dataset|space|kernel]: le type de dépôt (model, dataset, space ou kernel). [défaut : model]--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf discussions list username/my-model $ hf discussions list username/my-model —kind pull_request —status merged $ hf discussions list username/my-dataset —type dataset —status closed $ hf discussions list username/my-model —author alice —format json
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf discussions fusion
Fusionner une pull request.
Utilisation :
$ hf discussions merge [OPTIONS] REPO_ID NUMArguments :
REPO_ID: l'identifiant du dépôt (par exempleusername/repo-nameouspaces/username/repo-name). [obligatoire]NUM: numéro de la discussion ou de la pull request. [obligatoire]
Options :
--comment TEXT: un commentaire facultatif à publier lors de la fusion.-y, --yes: Ignore la demande de confirmation.--type, --repo-type [model|dataset|space|kernel]: le type de dépôt (model, dataset, space ou kernel). [défaut : model]--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf discussions merge username/my-model 5 $ hf discussions merge username/my-model 5 —comment “Merging, thanks!”
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf discussions rename
Renommer une discussion ou une pull request.
Utilisation :
$ hf discussions rename [OPTIONS] REPO_ID NUM NEW_TITLEArguments :
REPO_ID: l'identifiant du dépôt (par exempleusername/repo-nameouspaces/username/repo-name). [obligatoire]NUM: numéro de la discussion ou de la pull request. [obligatoire]NEW_TITLE: Le nouveau titre. [obligatoire]
Options :
--type, --repo-type [model|dataset|space|kernel]: le type de dépôt (model, dataset, space ou kernel). [défaut : model]--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf discussions rename username/my-model 5 “Updated title”
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf discussions réouverture
Rouvrir une discussion ou une pull request fermée.
Utilisation :
$ hf discussions reopen [OPTIONS] REPO_ID NUMArguments :
REPO_ID: l'identifiant du dépôt (par exempleusername/repo-nameouspaces/username/repo-name). [obligatoire]NUM: numéro de la discussion ou de la pull request. [obligatoire]
Options :
--comment TEXT: un commentaire facultatif à publier lors de la réouverture.-y, --yes: Ignore la demande de confirmation.--type, --repo-type [model|dataset|space|kernel]: le type de dépôt (model, dataset, space ou kernel). [défaut : model]--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf discussions reopen username/my-model 5 $ hf discussions reopen username/my-model 5 —comment “Rouvert pour enquête complémentaire.”
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf download
Télécharger des fichiers depuis le Hub.
Utilisation :
$ hf download [OPTIONS] REPO_ID [FILENAMES]...Arguments :
REPO_ID: l'identifiant du dépôt (par exempleusername/repo-nameouspaces/username/repo-name). [obligatoire][FILENAMES]...: Fichiers à télécharger (par ex.config.json,data/metadata.jsonl).
Options :
--type, --repo-type [model|dataset|space|kernel]: le type de dépôt (model, dataset, space ou kernel). [défaut : (model)]--revision TEXT: identifiant de révision Git, qui peut être un nom de branche, un tag ou un hachage de commit.--include TEXT: motifs glob à inclure parmi les fichiers à télécharger. Ex. : *.json--exclude TEXT: motifs glob à exclure des fichiers à télécharger.--cache-dir TEXT: répertoire où enregistrer les fichiers.--local-dir TEXT: Si défini, le fichier téléchargé sera placé sous ce répertoire. Consultez https://huggingface.co/docs/huggingface_hub/guides/download#download-files-to-a-local-folder pour plus de détails.--force-download / --no-force-download: si True, les fichiers seront téléchargés même s'ils sont déjà en cache. [valeur par défaut : no-force-download]--dry-run / --no-dry-run: Si True, effectue une simulation sans réellement télécharger le fichier. [défaut : no-dry-run]--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--max-workers INTEGER: Nombre maximal de workers à utiliser pour le téléchargement des fichiers. La valeur par défaut est 8. [default: 8]--help: Affiche ce message et quitte.
Exemples $ hf download meta-llama/Llama-3.2-1B-Instruct $ hf download meta-llama/Llama-3.2-1B-Instruct config.json tokenizer.json $ hf download meta-llama/Llama-3.2-1B-Instruct —include ”.safetensors” —exclude ”.bin” $ hf download meta-llama/Llama-3.2-1B-Instruct —local-dir ./models/llama $ hf download HuggingFaceM4/FineVision art/ —repo-type dataset $ hf download hf://datasets/HuggingFaceH4/ultrachat_200k
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf endpoints
Gérer les Hugging Face Inference Endpoints.
Utilisation :
$ hf endpoints [OPTIONS] COMMAND [ARGS]...Options :
--help: Affiche ce message et quitte.
Commandes :
catalog: Interagir avec le catalogue des Inference Endpoints.delete: Supprimer définitivement un Inference Endpoint.deploy: Déployer un point d'inférence à partir d'un dépôt du Hub.describe: Récupérer des informations sur un point de terminaison existant.hardware: Liste le matériel disponible pour déployer un Inference Endpoint.list: Liste tous les Inference Endpoints de l’espace de noms donné. [alias : ls]list-catalog: Liste les modèles disponibles dans le Model Catalog.pause: Pause an Inference Endpoint.resume: Reprendre un point de terminaison d’inférence.scale-to-zero: Mettre un point de terminaison d’inférence à l’échelle zéro.update: Mettre à jour un point de terminaison existant.
catalogue des endpoints hf
Interagissez avec le catalogue des Inference Endpoints.
Utilisation :
$ hf endpoints catalog [OPTIONS] COMMAND [ARGS]...Options :
--help: Affiche ce message et quitte.
Commandes :
deploy: Déployer un point de terminaison d'inférence à partir du catalogue de modèles.list: Liste les modèles disponibles dans le catalogue de modèles. [alias : ls]
hf endpoints catalog deploy
Déployer un point de terminaison d'inférence à partir du catalogue de modèles.
Les modèles du catalogue sont déployés via une recette : une combinaison de matériel et de moteur testée pour eux.
Passez —repo pour déployer la recette par défaut d’un modèle, éventuellement restreinte avec —accelerator et
—gguf-file, ou passez —recipe pour déployer une recette exacte listée par hf endpoints catalog ls.
Utilisation :
$ hf endpoints catalog deploy [OPTIONS]Options :
--repo TEXT: Le nom du dépôt de modèle associé à l'Inference Endpoint (par exemple, ‘openai/gpt-oss-120b’). Déploie sa recette par défaut. Mutuellement exclusif avec —recipe.--recipe TEXT: l’identifiant de la recette du catalogue à déployer, tel que listé par ‘hf endpoints catalog ls’. Mutuellement exclusif avec —repo.--name TEXT: Nom du point de terminaison.--accelerator [cpu|gpu|neuron]: l'accélérateur matériel à utiliser pour l'inférence. Uniquement avec —repo.--gguf-file TEXT: le fichier GGUF à déployer, pour les modèles qui ont une recette par quantification. Uniquement avec —repo.--namespace TEXT: l’espace de noms associé au point de terminaison d’inférence. Par défaut, l’espace de noms de l’utilisateur actuel est utilisé.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf endpoints catalog deploy —repo meta-llama/Llama-3.2-1B-Instruct $ hf endpoints catalog deploy —recipe sizzling-biryani-g4xsi1ac
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf endpoints catalog list
Liste les modèles disponibles dans le Catalogue de modèles. [alias: ls]
Une ligne par recette, c’est-à-dire par méthode de déploiement d’un modèle testée. Déployez-en un avec hf endpoints catalog deploy --recipe <RECIPE_ID>.
Utilisation :
$ hf endpoints catalog list [OPTIONS]Options :
--accelerator [cpu|gpu|neuron]: n’affiche que les recettes exécutées sur cet accélérateur.--engine [llamacpp|sglang|tei|vllm]: n’affiche que les recettes exécutées avec ce moteur d’inférence.--license TEXT: N’afficher que les modèles sous cette licence (par ex. ‘Apache 2.0’).--task TEXT: n’afficher que les modèles pour cette tâche (par exemple, ‘text-generation’).--search TEXT: Requête de recherche.--limit INTEGER: Limite le nombre de modèles à retourner.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf endpoints catalog ls $ hf endpoints catalog ls —engine vllm
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf endpoints delete
Supprimer définitivement un Inference Endpoint.
Utilisation :
$ hf endpoints delete [OPTIONS] NAMEArguments :
NAME: Nom du point de terminaison. [obligatoire]
Options :
--namespace TEXT: l’espace de noms associé au point de terminaison d’inférence. Par défaut, l’espace de noms de l’utilisateur actuel est utilisé.--yes: Ignore les invites de confirmation.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf endpoints delete my-endpoint
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf endpoints deploy
Déployer un point d’inférence à partir d’un dépôt du Hub.
Exécutez hf endpoints hardware pour lister les combinaisons valides de --vendor, --region, --accelerator, --instance-type et --instance-size.
Utilisation :
$ hf endpoints deploy [OPTIONS] NAMEArguments :
NAME: Nom du point de terminaison. [obligatoire]
Options :
--repo TEXT: Le nom du dépôt de modèle associé au point de terminaison d’inférence (par exemple ‘openai/gpt-oss-120b’). [obligatoire]--framework TEXT: le framework d’apprentissage automatique utilisé pour le modèle (par exemple ‘vllm’). [obligatoire]--accelerator TEXT: l'accélérateur matériel à utiliser pour l'inférence (par exemple, ‘cpu’). [obligatoire]--instance-size TEXT: La taille ou le type d’instance à utiliser pour l’hébergement du modèle (par ex. ‘x4’). [obligatoire]--instance-type TEXT: le type d’instance cloud sur lequel l’Inference Endpoint sera déployé (par ex. ‘intel-icl’). [obligatoire]--region TEXT: La région cloud dans laquelle le point de terminaison d’inférence sera créé (par exemple, ‘us-east-1’). [obligatoire]--vendor TEXT: le fournisseur cloud ou le fournisseur chez lequel l’Inference Endpoint sera hébergé (par exemple ‘aws’). [obligatoire]--namespace TEXT: l’espace de noms associé au point de terminaison d’inférence. Par défaut, l’espace de noms de l’utilisateur actuel est utilisé.--task TEXT: la tâche sur laquelle déployer le modèle (par exemple, ‘text-classification’).--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--min-replica INTEGER: Nombre minimal de répliques (instances) à maintenir en cours d'exécution pour le point de terminaison d'inférence. [défaut : 1]--max-replica INTEGER: Nombre maximal de répliques (instances) vers lequel mettre à l'échelle le point de terminaison d'inférence. [défaut : 1]--scale-to-zero-timeout INTEGER: durée en minutes avant qu'un point de terminaison inactif ne soit mis à l'échelle zéro.--scaling-metric [pendingRequests|hardwareUsage]: La métrique de référence pour le redimensionnement.--scaling-threshold FLOAT: Seuil de la métrique de mise à l'échelle utilisé pour déclencher une augmentation de la capacité. Ignoré si la métrique de mise à l'échelle n'est pas fournie.--revision TEXT: identifiant de révision Git, qui peut être un nom de branche, un tag ou un hachage de commit.--custom-image TEXT: URL de l’image Docker du conteneur à exécuter (par exemple ‘nexagi/sglang:v0.5.12’). Nécessite ‘—framework custom’.--engine [custom|hf-serve|llamacpp|sglang|tei|tgi|tgi-neuron|vllm|vllm-neuron]: Image de moteur géré à exécuter —custom-image avec (par exemple ‘vllm’). Par défaut, un conteneur arbitraire est utilisé.--health-route TEXT: Route de vérification de l’état de santé exposée par le conteneur (par ex. ‘/health’). Nécessite —custom-image.--port INTEGER: Port sur lequel le conteneur écoute (par exemple 30000). Nécessite —custom-image.--container-registry-username TEXT: nom d'utilisateur utilisé pour s'authentifier auprès du registre hébergeant —custom-image.--container-registry-password TEXT: Mot de passe facultatif utilisé pour s'authentifier auprès du registre hébergeant —custom-image.--tensor-parallel-size INTEGER: Nombre d'accélérateurs sur lesquels répartir une seule copie du modèle (moteurs vLLM et SGLang uniquement).--data-parallel-size INTEGER: Nombre de copies du modèle à exécuter, une par accélérateur (moteur vLLM uniquement).--container-command TEXT: Remplace le point d’entrée du conteneur, sous forme de chaîne entre guillemets découpée en jetons (par ex. « python -m sglang.launch_server »).--container-args TEXT: Arguments ajoutés à l'entrypoint du conteneur, sous forme de chaîne entre guillemets découpée en jetons (par ex. « —tp 8 —reasoning-parser qwen3 »).-e, --env TEXT: Définit des variables d’environnement. Par exemple —env ENV=value--env-file TEXT: Lit un fichier de variables d’environnement. Utilisez-pour les lire depuis l’entrée standard.-s, --secrets TEXT: Définit des variables d’environnement secrètes. Préférez--secrets SECRETpour lire la valeur depuis votre environnement (par ex.--secrets HF_TOKENpour transmettre votre jeton Hugging Face) ;--secrets SECRET=valueplace la valeur dans l’historique de votre shell.--secrets-file TEXT: Lit un fichier de variables d’environnement secrètes. Utilisez-pour les lire depuis l’entrée standard.--type [public|authenticated|private]: Type d'accès au point de terminaison. La valeur par défaut est « authenticated » (protégé par jeton, accessible publiquement).--help: Affiche ce message et quitte.
Exemples $ hf endpoints deploy my-endpoint —repo gpt2 —framework pytorch … $ hf endpoints deploy my-endpoint —repo openai/gpt-oss-120b —framework custom —engine vllm —custom-image vllm/vllm-openai:v0.23.0 —tensor-parallel-size 8 …
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf endpoints describe
Obtenir des informations sur un point de terminaison existant.
Utilisation :
$ hf endpoints describe [OPTIONS] NAMEArguments :
NAME: Nom du point de terminaison. [obligatoire]
Options :
--namespace TEXT: l’espace de noms associé au point de terminaison d’inférence. Par défaut, l’espace de noms de l’utilisateur actuel est utilisé.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf endpoints describe my-endpoint
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf endpoints hardware
Listez le matériel disponible pour déployer un Inference Endpoint.
Seuls les matériels sur lesquels l'espace de noms peut actuellement déployer sont répertoriés : un statut utilisable et un quota d'accélérateur suffisant pour un seul réplique. Utilisez --all pour répertorier toutes les combinaisons renvoyées par l'API.
Le quota est défini par espace de noms, passez donc le même --namespace que celui utilisé avec hf endpoints deploy. Les prix sont indiqués en
USD, par réplique et par heure.
Utilisation :
$ hf endpoints hardware [OPTIONS]Options :
--namespace TEXT: l’espace de noms associé au point de terminaison d’inférence. Par défaut, l’espace de noms de l’utilisateur actuel est utilisé.--vendor TEXT: N’afficher que le matériel hébergé par ce fournisseur cloud (par exemple, ‘aws’).--region TEXT: n’afficher que le matériel disponible dans cette région cloud (par exemple, ‘us-east-1’).--accelerator TEXT: N'afficher que le matériel doté de cet accélérateur (par ex. ‘cpu’, ‘gpu’, ‘neuron’).--instance-type TEXT: n’afficher que le matériel de ce type d’instance (par ex. ‘nvidia-l4’).-a, --all: Affiche également le matériel qui ne peut pas être déployé pour le moment (indisponible, obsolète ou hors quota).--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf endpoints hardware $ hf endpoints hardware —vendor aws —accelerator gpu
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf endpoints list
Liste tous les Inference Endpoints pour l'espace de noms donné. [alias: ls]
Utilisation :
$ hf endpoints list [OPTIONS]Options :
--namespace TEXT: l’espace de noms associé au point de terminaison d’inférence. Par défaut, l’espace de noms de l’utilisateur actuel est utilisé.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf endpoints ls $ hf endpoints ls —namespace my-org
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf endpoints list-catalog
Lister les modèles disponibles dans le catalogue de modèles.
Une ligne par recette, c’est-à-dire par méthode de déploiement d’un modèle testée. Déployez-en un avec hf endpoints catalog deploy --recipe <RECIPE_ID>.
Utilisation :
$ hf endpoints list-catalog [OPTIONS]Options :
--accelerator [cpu|gpu|neuron]: n’affiche que les recettes exécutées sur cet accélérateur.--engine [llamacpp|sglang|tei|vllm]: n’affiche que les recettes exécutées avec ce moteur d’inférence.--license TEXT: N’afficher que les modèles sous cette licence (par ex. ‘Apache 2.0’).--task TEXT: n’afficher que les modèles pour cette tâche (par exemple, ‘text-generation’).--search TEXT: Requête de recherche.--limit INTEGER: Limite le nombre de modèles à retourner.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
hf endpoints pause
Mettre en pause un point de terminaison d'inférence.
Utilisation :
$ hf endpoints pause [OPTIONS] NAMEArguments :
NAME: Nom du point de terminaison. [obligatoire]
Options :
--namespace TEXT: l’espace de noms associé au point de terminaison d’inférence. Par défaut, l’espace de noms de l’utilisateur actuel est utilisé.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf endpoints pause my-endpoint
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf endpoints resume
Reprendre un point de terminaison d’inférence.
Utilisation :
$ hf endpoints resume [OPTIONS] NAMEArguments :
NAME: Nom du point de terminaison. [obligatoire]
Options :
--namespace TEXT: l’espace de noms associé au point de terminaison d’inférence. Par défaut, l’espace de noms de l’utilisateur actuel est utilisé.--fail-if-already-running: siTrue, la méthode lève une erreur si l’Inference Endpoint est déjà en cours d’exécution.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf endpoints resume my-endpoint
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf endpoints scale-to-zero
Mettre à l’échelle un point de terminaison d’inférence à zéro.
Utilisation :
$ hf endpoints scale-to-zero [OPTIONS] NAMEArguments :
NAME: Nom du point de terminaison. [obligatoire]
Options :
--namespace TEXT: l’espace de noms associé au point de terminaison d’inférence. Par défaut, l’espace de noms de l’utilisateur actuel est utilisé.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf endpoints scale-to-zero my-endpoint
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf endpoints update
Mettre à jour un point de terminaison existant.
Utilisation :
$ hf endpoints update [OPTIONS] NAMEArguments :
NAME: Nom du point de terminaison. [obligatoire]
Options :
--namespace TEXT: l’espace de noms associé au point de terminaison d’inférence. Par défaut, l’espace de noms de l’utilisateur actuel est utilisé.--repo TEXT: Le nom du dépôt de modèle associé au point de terminaison d’inférence (par exemple, ‘openai/gpt-oss-120b’).--accelerator TEXT: l'accélérateur matériel à utiliser pour l'inférence (par exemple, ‘cpu’).--instance-size TEXT: La taille ou le type d’instance à utiliser pour l’hébergement du modèle (par exemple, ‘x4’).--instance-type TEXT: le type d’instance cloud sur lequel l’Inference Endpoint sera déployé (par exemple ‘intel-icl’).--framework TEXT: le framework d’apprentissage automatique utilisé pour le modèle (par exemple, ‘custom’).--revision TEXT: la révision spécifique du modèle à déployer sur l’Inference Endpoint (par exemple ‘6c0e6080953db56375760c0471a8c5f2929baf11’).--task TEXT: la tâche sur laquelle déployer le modèle (par exemple, ‘text-classification’).--custom-image TEXT: URL de l’image Docker du conteneur à exécuter (par ex. ‘nexagi/sglang:v0.5.12’). Remplace l’image actuellement configurée sur le point de terminaison au lieu de la modifier partiellement ; passez donc les réglages du moteur et du conteneur que vous souhaitez conserver avec elle, et exécutez d’abord ‘hf endpoints describe NAME’ pour les consulter.--engine [custom|hf-serve|llamacpp|sglang|tei|tgi|tgi-neuron|vllm|vllm-neuron]: Image de moteur géré à exécuter —custom-image avec (par exemple ‘vllm’). Par défaut, un conteneur arbitraire est utilisé.--health-route TEXT: Route de vérification de l’état de santé exposée par le conteneur (par ex. ‘/health’). Nécessite —custom-image.--port INTEGER: Port sur lequel le conteneur écoute (par exemple 30000). Nécessite —custom-image.--tensor-parallel-size INTEGER: Nombre d'accélérateurs sur lesquels répartir une seule copie du modèle (moteurs vLLM et SGLang uniquement).--data-parallel-size INTEGER: Nombre de copies du modèle à exécuter, une par accélérateur (moteur vLLM uniquement).--container-command TEXT: Remplace le point d’entrée du conteneur, sous forme de chaîne entre guillemets découpée en jetons (par ex. « python -m sglang.launch_server »). Remplace la valeur actuelle ; passez une chaîne vide pour l’effacer.--container-args TEXT: Arguments ajoutés à l’entrypoint du conteneur, sous forme de chaîne entre guillemets découpée en jetons (par ex. « —enable-auto-tool-choice —tool-call-parser lfm2 »). Remplace les arguments actuellement définis sur le point de terminaison au lieu de s’y ajouter ; incluez donc ceux que vous souhaitez conserver et exécutez d’abord « hf endpoints describe NAME » pour les consulter. Transmettez une chaîne vide pour les effacer.--min-replica INTEGER: Le nombre minimal de répliques (instances) à maintenir en cours d'exécution pour le point de terminaison d'inférence.--max-replica INTEGER: nombre maximal de répliques (instances) vers lequel mettre à l'échelle le point de terminaison d'inférence.--scale-to-zero-timeout INTEGER: durée en minutes avant qu'un point de terminaison inactif ne soit mis à l'échelle zéro.--scaling-metric [pendingRequests|hardwareUsage]: La métrique de référence pour le redimensionnement.--scaling-threshold FLOAT: Seuil de la métrique de mise à l'échelle utilisé pour déclencher une augmentation de la capacité. Ignoré si la métrique de mise à l'échelle n'est pas fournie.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf endpoints update my-endpoint —min-replica 2 $ hf endpoints update my-endpoint —tensor-parallel-size 8 $ hf endpoints update my-endpoint —container-args “—enable-auto-tool-choice —tool-call-parser lfm2”
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf env
Affiche des informations sur l'environnement.
Utilisation :
$ hf env [OPTIONS]Options :
--help: Affiche ce message et quitte.
hf extensions
Gérer les extensions de la CLI hf. [alias: ext]
Avertissement de sécurité : les extensions sont des exécutables ou des packages Python tiers. N’installez que depuis des sources de confiance.
Utilisation :
$ hf extensions [OPTIONS] COMMAND [ARGS]...Options :
--help: Affiche ce message et quitte.
Commandes :
exec: Exécuter une extension installée.install: Installe une extension à partir d'un dépôt GitHub public.list: Liste les commandes d’extension installées. [alias : ls]remove: Supprime une extension installée. [alias : rm]search: Recherche les extensions disponibles sur GitHub (étiquetées avec le sujet ‘hf-extension’).update: Met à jour l’extension ou les extensions installées vers leur dernière version.
hf extensions exec
Exécuter une extension installée.
Utilisation :
$ hf extensions exec [OPTIONS] NAMEArguments :
NAME: Nom de l’extension (avec ou sans préfixehf-). [obligatoire]
Options :
--help: Affiche ce message et quitte.
Exemples $ hf extensions exec claude — —help $ hf extensions exec claude —model zai-org/GLM-5
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf extensions install
Installer une extension depuis un dépôt GitHub public.
Avertissement de sécurité : cette opération installe un exécutable ou un package Python tiers. N’installez que depuis des sources de confiance.
Utilisation :
$ hf extensions install [OPTIONS] REPO_IDArguments :
REPO_ID: dépôt d’extension GitHub au format[OWNER/]hf-<name>. [obligatoire]
Options :
--force: Écraser si déjà installé.--help: Affiche ce message et quitte.
Exemples $ hf extensions install hf-claude $ hf extensions install hanouticelina/hf-claude $ hf extensions install alvarobartt/hf-mem
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf extensions list
Liste les commandes d’extension installées. [alias: ls]
Utilisation :
$ hf extensions list [OPTIONS]Options :
--help: Affiche ce message et quitte.
Exemples $c hf extensions list$
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf extensions remove
Supprimer une extension installée. [alias: rm]
Utilisation :
$ hf extensions remove [OPTIONS] NAMEArguments :
NAME: Nom de l’extension à supprimer (avec ou sans préfixehf-). [obligatoire]
Options :
--help: Affiche ce message et quitte.
Exemples $ hf extensions remove claude
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf extensions search
Rechercher les extensions disponibles sur GitHub (étiquetées avec le sujet ‘hf-extension’).
Utilisation :
$ hf extensions search [OPTIONS]Options :
--help: Affiche ce message et quitte.
Exemples $ hf extensions search
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf extensions update
Mettre à jour l'extension ou les extensions installées vers leur dernière version.
Utilisation :
$ hf extensions update [OPTIONS] [NAME]Arguments :
[NAME]: extension à mettre à jour (avec ou sans préfixehf-, éventuellement sous la formeOWNER/hf-<name>). Si omis, toutes les extensions installées sont vérifiées et celles qui sont obsolètes sont mises à jour.
Options :
--help: Affiche ce message et quitte.
Exemples $ hf extensions update $ hf extensions update hf-claude $ hf extensions update alvarobartt/hf-mem
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf jobs
Exécuter et gérer des Jobs sur le Hub.
Utilisation :
$ hf jobs [OPTIONS] COMMAND [ARGS]...Options :
--help: Affiche ce message et quitte.
Commandes :
cancel: Annuler un Jobexpose: Remplace les ports exposés sur un Job en cours d'exécution.hardware: Liste les options de matériel disponibles pour les Jobsinspect: Affiche des informations détaillées sur un ou plusieurs Jobslabels: Met à jour les étiquettes d’un Job.list: Liste les tâches. [alias : ls, ps]logs: Récupérer les journaux d'un Job.rerun: Exécuter un nouveau Job à partir de la spécification d’un Job existant.run: Exécuter un Job.scheduled: créez et gérez des Jobs planifiés sur le Hub.ssh: se connecter via SSH à un Job en cours d’exécution.stats: Récupère les statistiques et les métriques d'utilisation des ressources des Jobs.uv: Exécuter des scripts UV (Python avec des dépendances intégrées) sur l’infrastructure HF.wait: Attendre qu'un ou plusieurs Jobs atteignent un état terminal.
hf jobs cancel
Annuler un Job
Utilisation :
$ hf jobs cancel [OPTIONS] JOB_IDArguments :
JOB_ID: identifiant du job (ou ‘namespace/job_id’) [obligatoire]
Options :
--namespace TEXT: l’espace de noms dans lequel le travail sera exécuté. Par défaut, l’espace de noms de l’utilisateur actuel est utilisé.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf jobs cancel <job_id>
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf jobs expose
Remplacer les ports exposés sur un Job en cours d’exécution.
Utilisation :
$ hf jobs expose [OPTIONS] JOB_ID [PORTS]...Arguments :
JOB_ID: identifiant du job (ou ‘namespace/job_id’) [obligatoire][PORTS]...: Ports à exposer via le proxy des jobs. L’accès nécessite un jeton HF avec un accès en lecture à l’espace de noms du job.
Options :
--public INTEGER: Expose un port sans authentification. Répétez l’option pour plusieurs ports. Il n’est pas nécessaire de passer également le port en tant qu’argument positionnel.--clear: Ferme tous les ports exposés.--namespace TEXT: l’espace de noms dans lequel le travail sera exécuté. Par défaut, l’espace de noms de l’utilisateur actuel est utilisé.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf jobs expose <job_id> 8000 $ hf jobs expose <job_id> 8000 —public 9000 $ hf jobs expose <job_id> —clear
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf jobs hardware
Lister les options de matériel disponibles pour les Jobs
Utilisation :
$ hf jobs hardware [OPTIONS]Options :
--help: Affiche ce message et quitte.
Exemples $ hf jobs hardware
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf jobs inspect
Afficher des informations détaillées sur un ou plusieurs Jobs
Utilisation :
$ hf jobs inspect [OPTIONS] JOB_IDS...Arguments :
JOB_IDS...: identifiants des tâches à inspecter (ou ‘namespace/job_id’) [obligatoire]
Options :
--namespace TEXT: l’espace de noms dans lequel le travail sera exécuté. Par défaut, l’espace de noms de l’utilisateur actuel est utilisé.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf jobs inspect <job_id>
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf jobs labels
Mettre à jour les étiquettes d'un Job. Passer —label remplace toutes les étiquettes existantes ; passer —name seul les conserve.
Utilisation :
$ hf jobs labels [OPTIONS] JOB_IDArguments :
JOB_ID: identifiant du job (ou ‘namespace/job_id’) [obligatoire]
Options :
--name TEXT: Nomme le Job. Stocké en tant que libelléname. Les noms n'ont pas besoin d'être uniques. Par défaut, il s'agit du nom de l'image ou du script suivi d'un court hachage de la configuration de lancement résolue.-l, --label TEXT: Définit les étiquettes. Par exemple, —label KEY=VALUE ou —label LABEL--clear: Supprime tous les étiquettes du travail.--namespace TEXT: l’espace de noms dans lequel le travail sera exécuté. Par défaut, l’espace de noms de l’utilisateur actuel est utilisé.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf jobs labels <job_id> —name training-v2 $ hf jobs labels <job_id> —label env=prod —label team=ml $ hf jobs labels <job_id> —clear
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf jobs list | ls | ps
Lister les tâches.
Utilisez --status pour filtrer par statut (voir JobStage pour les valeurs possibles) et --label pour filtrer par les étiquettes key=value. Un Job doit correspondre à chaque filtre pour être listé.
Utilisation :
$ hf jobs list | ls | ps [OPTIONS]Options :
-a, --all: Affiche tous les Jobs (par défaut, seuls les Jobs en cours d'exécution et de planification sont affichés). Ne peut pas être combiné avec —status.--status [COMPLETED|CANCELED|ERROR|DELETED|SCHEDULING|RUNNING]: n’affiche que les Jobs ayant le statut indiqué. Séparés par des virgules ou répétés, par exemple--status running,scheduling.-l, --label TEXT: n’affiche que les Jobs portant l’étiquettekey=valueindiquée. Répétez pour exiger plusieurs étiquettes, par exemple--label env=prod --label team=ml.--name TEXT: N’afficher que les Jobs portant le nom indiqué (raccourci pour--label name=NAME).--limit INTEGER: Nombre maximal de Jobs à afficher. Définissez la valeur à 0 pour tout afficher (sans limite). [valeur par défaut : 100]--namespace TEXT: l’espace de noms dans lequel le travail sera exécuté. Par défaut, l’espace de noms de l’utilisateur actuel est utilisé.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf jobs ls $ hf jobs ls -a $ hf jobs ls —status running,scheduling $ hf jobs ls —name training-v2 $ hf jobs ls —label env=prod —label team=ml $ hf jobs ls —all —label hf-sandbox=1
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf jobs logs
Récupérer les journaux d'un Job.
Par défaut, affiche les journaux actuellement disponibles et se termine (non bloquant). Utilisez —follow/-f pour diffuser les journaux en temps réel jusqu'à la fin du travail. Utilisez —tail/-n pour limiter le nombre de lignes renvoyées (côté serveur si pris en charge).
Note : la commande hf jobs inspect <job_id> permet de vérifier l'état final.
Utilisation :
$ hf jobs logs [OPTIONS] JOB_IDArguments :
JOB_ID: identifiant du job (ou ‘namespace/job_id’) [obligatoire]
Options :
-f, --follow: Suivre la sortie des journaux (flux jusqu'à la fin du travail). Sans cet attribut, seuls les journaux actuellement disponibles sont affichés.-n, --tail INTEGER: Nombre de lignes à afficher à partir de la fin des journaux. Combiné à —follow, commence le flux à partir des N dernières lignes.--namespace TEXT: l’espace de noms dans lequel le travail sera exécuté. Par défaut, l’espace de noms de l’utilisateur actuel est utilisé.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf jobs logs <job_id> $ hf jobs logs -f <job_id> $ hf jobs logs —tail 20 <job_id> $ hf jobs logs -f —tail 100 <job_id>
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf jobs rerun
Exécuter un nouveau Job avec la spécification d'un Job existant.
Utilisation :
$ hf jobs rerun [OPTIONS] JOB_IDArguments :
JOB_ID: identifiant du job (ou ‘namespace/job_id’) [obligatoire]
Options :
-d, --detach: Exécute le Job en arrière-plan et affiche l’ID du Job.--namespace TEXT: l’espace de noms dans lequel le travail sera exécuté. Par défaut, l’espace de noms de l’utilisateur actuel est utilisé.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf jobs rerun <job_id> $ hf jobs rerun —detach <job_id>
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf jobs run
Lancer un Job.
Utilisation :
$ hf jobs run [OPTIONS] IMAGE COMMAND...Arguments :
IMAGE: L’image Docker à utiliser. [obligatoire]COMMAND...: La commande à exécuter. [obligatoire]
Options :
-e, --env TEXT: Définit des variables d’environnement. Par exemple —env ENV=value-s, --secrets TEXT: Définit des variables d’environnement secrètes. Préférez--secrets SECRETpour lire la valeur depuis votre environnement (par ex.--secrets HF_TOKENpour transmettre votre jeton Hugging Face) ;--secrets SECRET=valueplace la valeur dans l’historique de votre shell.--name TEXT: Nomme le Job. Stocké en tant que libelléname. Les noms n'ont pas besoin d'être uniques. Par défaut, il s'agit du nom de l'image ou du script suivi d'un court hachage de la configuration de lancement résolue.-l, --label TEXT: Définit les étiquettes. Par exemple, —label KEY=VALUE ou —label LABEL-v, --volume TEXT: monte un ou plusieurs volumes. Format : hf://[TYPE/]SOURCE:/MOUNT_PATH[:ro|:rw] ou LOCAL_DIR:/MOUNT_PATH[:ro|:rw]. TYPE est l’un des éléments suivants : models, datasets, spaces, buckets. Si TYPE est omis, il est défini par défaut sur models. models, datasets et spaces sont toujours montés en lecture seule. buckets sont montés en lecture et écriture par défaut. Une source de répertoire local est d’abord synchronisée vers un bucket et montée en lecture seule par défaut. Par exemple, -v hf://datasets/org/ds:/data ou -v hf://buckets/org/b:/mnt:ro ou -v ./inputs:/inputs--env-file TEXT: Lit un fichier de variables d’environnement. Utilisez-pour les lire depuis l’entrée standard.--secrets-file TEXT: Lit un fichier de variables d’environnement secrètes. Utilisez-pour les lire depuis l’entrée standard.--flavor [cpu-basic|cpu-upgrade|cpu-performance|cpu-xl|t4-small|t4-medium|l4x1|l4x4|l40sx1|l40sx4|l40sx8|a10g-small|a10g-large|a10g-largex2|a10g-largex4|a100-large|a100x4|a100x8|h200|h200x2|h200x4|h200x8|rtx-pro-6000|rtx-pro-6000x2|rtx-pro-6000x4|rtx-pro-6000x8]: Saveur pour le matériel. Exécutez « hf jobs hardware » pour lister les saveurs disponibles. La valeur par défaut estcpu-basic.--timeout TEXT: Durée maximale : entier avec s (secondes, par défaut), m (minutes), h (heures) ou d (jours).--attempts INTEGER RANGE: Nombre maximal de tentatives, y compris la première exécution. Valeur par défaut : 1. [x>=1]-d, --detach: Exécute le Job en arrière-plan et affiche l’ID du Job.--dry-run: Affiche la configuration résolue du Job sans le soumettre.--expose INTEGER: Exposer un port de conteneur via le proxy des jobs. Répétez le drapeau pour plusieurs ports (par ex.--expose 8000 --expose 8001). Chaque port exposé est accessible sur le domaine public des jobs ; l’accès nécessite un jeton HF avec un accès en lecture à l’espace de noms du job.--expose-public INTEGER: Expose un port de conteneur via le proxy des jobs sans authentification. Répétez le drapeau pour plusieurs ports. Il n'est pas nécessaire de passer également le port avec--expose.--ssh: Rendre le conteneur du job accessible via SSH. Connectez-vous avechf jobs ssh <job_id>. Nécessite une clé publique SSH enregistrée sur https://huggingface.co/settings/keys.--network-group TEXT: Rejoindre un groupe de réseau. Les jobs du même espace de noms et du même groupe de ressources partageant un groupe sont placés ensemble et se rejoignent sur chaque port. Au sein de chaque membre,$HF_NETWORK_GROUP_HOSTNAMEse résout vers chaque membre. Alphanumériques minuscules et tirets, 46 caractères maximum.--network-alias TEXT: Réclamer un alias dans le groupe réseau. Les membres accèdent aux jobs qui le réclament à l’adresse${HF_NETWORK_GROUP_PREFIX}<alias>. Répétez le drapeau pour plusieurs alias. Alphanumériques minuscules et tirets, 34 caractères maximum, unique au sein du job. Nécessite--network-group.--resource-group-id TEXT: l'identifiant du groupe de ressources dans lequel créer le Job. Utilisé pour contrôler l'accès aux ressources au sein d'une organisation et pour les fonctionnalités d'attribution des coûts et de limites de dépenses.--namespace TEXT: l’espace de noms dans lequel le travail sera exécuté. Par défaut, l’espace de noms de l’utilisateur actuel est utilisé.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--format [agent|auto|human|json|quiet]: Format de sortie. La valeur par défaut est « auto », qui choisit « agent » ou « human » en fonction du terminal.--json: sortie au format JSON. Équivalent à ‘—format json’.-q, --quiet: Sortie silencieuse (un ID par ligne). Équivalent à ‘—format quiet’.--help: Affiche ce message et quitte.
Exemples $ hf jobs run —name hello-world python:3.12 python -c ‘print(“Hello!”)’ $ hf jobs run —detach python:3.12 python script.py $ hf jobs run -e FOO=foo python:3.12 python script.py $ hf jobs run —secrets HF_TOKEN python:3.12 python script.py $ hf jobs run -v hf://org/my-model:/data -v hf://buckets/org/b:/mnt python:3.12 python script.py
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf jobs scheduled
Créer et gérer des Jobs planifiés sur le Hub.
Utilisation :
$ hf jobs scheduled [OPTIONS] COMMAND [ARGS]...Options :
--help: Affiche ce message et quitte.
Commandes :
delete: Supprime un Job planifié.inspect: Affiche des informations détaillées sur un ou plusieurs Jobs planifiéslabels: Met à jour les étiquettes d’un Job planifié.list: Liste les Jobs planifiés. [alias : ls, ps]reschedule: Modifier le moment d'exécution d'un Job planifié.resume: Reprend (dépause) un Job planifié.run: Planifier un Job.suspend: Suspendre (mettre en pause) un Job planifié.trigger: Déclencher l'exécution immédiate d'un Job planifié (ne modifie pas le planning).uv: Planifier des scripts UV sur l’infrastructure HF.
hf jobs scheduled delete
Supprimer un Job planifié.
Utilisation :
$ hf jobs scheduled delete [OPTIONS] SCHEDULED_JOB_IDArguments :
SCHEDULED_JOB_ID: ID du job planifié (ou ‘namespace/scheduled_job_id’) [obligatoire]
Options :
--namespace TEXT: l’espace de noms dans lequel le travail sera exécuté. Par défaut, l’espace de noms de l’utilisateur actuel est utilisé.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf jobs scheduled delete <id>
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf jobs scheduled inspect
Afficher des informations détaillées sur un ou plusieurs Jobs planifiés
Utilisation :
$ hf jobs scheduled inspect [OPTIONS] SCHEDULED_JOB_IDS...Arguments :
SCHEDULED_JOB_IDS...: identifiants des tâches planifiées à inspecter (ou ‘namespace/scheduled_job_id’) [obligatoire]
Options :
--namespace TEXT: l’espace de noms dans lequel le travail sera exécuté. Par défaut, l’espace de noms de l’utilisateur actuel est utilisé.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf jobs scheduled inspect <id>
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf jobs scheduled labels
Mettre à jour les étiquettes d'un Job planifié. Passer —label remplace toutes les étiquettes existantes ; passer —name seul les conserve.
Utilisation :
$ hf jobs scheduled labels [OPTIONS] SCHEDULED_JOB_IDArguments :
SCHEDULED_JOB_ID: ID du job planifié (ou ‘namespace/scheduled_job_id’) [obligatoire]
Options :
--name TEXT: Nomme le Job. Stocké en tant que libelléname. Les noms n'ont pas besoin d'être uniques. Par défaut, il s'agit du nom de l'image ou du script suivi d'un court hachage de la configuration de lancement résolue.-l, --label TEXT: Définit les étiquettes. Par exemple, —label KEY=VALUE ou —label LABEL--clear: Supprime tous les étiquettes du planifié.--namespace TEXT: l’espace de noms dans lequel le travail sera exécuté. Par défaut, l’espace de noms de l’utilisateur actuel est utilisé.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf jobs scheduled labels <id> —name daily-script $ hf jobs scheduled labels <id> —label env=prod —label team=ml $ hf jobs scheduled labels <id> —clear
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf jobs scheduled list | ls | ps
Lister les Jobs planifiés.
Utilisez --status pour filtrer par statut (active ou suspended) et --label pour filtrer par étiquettes key=value.
Un Job planifié doit correspondre à tous les filtres pour être listé.
Utilisation :
$ hf jobs scheduled list | ls | ps [OPTIONS]Options :
-a, --all: Affiche tous les Jobs planifiés (par défaut, les Jobs suspendus sont masqués). Ne peut pas être combiné avec —status.--status [active|suspended]: n’affiche que les Jobs planifiés ayant le statut indiqué. Séparés par des virgules ou répétés, par exemple--status suspended.-l, --label TEXT: n’affiche que les Jobs planifiés portant l’étiquettekey=valueindiquée. Répétez pour exiger plusieurs étiquettes, par exemple--label env=prod --label team=ml.--name TEXT: N’afficher que les Jobs planifiés portant le nom indiqué (raccourci pour--label name=NAME).--namespace TEXT: l’espace de noms dans lequel le travail sera exécuté. Par défaut, l’espace de noms de l’utilisateur actuel est utilisé.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf jobs scheduled ls $ hf jobs scheduled ls -a $ hf jobs scheduled ls —status suspended $ hf jobs scheduled ls —name daily-script $ hf jobs scheduled ls —label env=prod —label team=ml
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf jobs scheduled reschedule
Modifier le moment d’exécution d’un Job planifié.
Utilisation :
$ hf jobs scheduled reschedule [OPTIONS] SCHEDULED_JOB_ID SCHEDULEArguments :
SCHEDULED_JOB_ID: ID du job planifié (ou ‘namespace/scheduled_job_id’) [obligatoire]SCHEDULE: l'une des valeurs @annually, @yearly, @monthly, @weekly, @daily, @hourly, ou une expression d'horaire CRON. [obligatoire]
Options :
--namespace TEXT: l’espace de noms dans lequel le travail sera exécuté. Par défaut, l’espace de noms de l’utilisateur actuel est utilisé.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf jobs scheduled reschedule <id> “0 9 * * 1”
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf jobs scheduled resume
Reprendre (dépauser) un Job planifié.
Utilisation :
$ hf jobs scheduled resume [OPTIONS] SCHEDULED_JOB_IDArguments :
SCHEDULED_JOB_ID: ID du job planifié (ou ‘namespace/scheduled_job_id’) [obligatoire]
Options :
--namespace TEXT: l’espace de noms dans lequel le travail sera exécuté. Par défaut, l’espace de noms de l’utilisateur actuel est utilisé.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf jobs scheduled resume <id>
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf jobs scheduled run
Planifier un travail.
Utilisation :
$ hf jobs scheduled run [OPTIONS] SCHEDULE IMAGE COMMAND...Arguments :
SCHEDULE: l'une des valeurs @annually, @yearly, @monthly, @weekly, @daily, @hourly, ou une expression d'horaire CRON. [obligatoire]IMAGE: L’image Docker à utiliser. [obligatoire]COMMAND...: La commande à exécuter. [obligatoire]
Options :
--suspend / --no-suspend: Suspendre (mettre en pause) le Job planifié--concurrency / --no-concurrency: autoriser l’exécution simultanée de plusieurs instances de ce Job-e, --env TEXT: Définit des variables d’environnement. Par exemple —env ENV=value-s, --secrets TEXT: Définit des variables d’environnement secrètes. Préférez--secrets SECRETpour lire la valeur depuis votre environnement (par ex.--secrets HF_TOKENpour transmettre votre jeton Hugging Face) ;--secrets SECRET=valueplace la valeur dans l’historique de votre shell.--name TEXT: Nomme le Job. Stocké en tant que libelléname. Les noms n'ont pas besoin d'être uniques. Par défaut, il s'agit du nom de l'image ou du script suivi d'un court hachage de la configuration de lancement résolue.-l, --label TEXT: Définit les étiquettes. Par exemple, —label KEY=VALUE ou —label LABEL-v, --volume TEXT: monte un ou plusieurs volumes. Format : hf://[TYPE/]SOURCE:/MOUNT_PATH[:ro|:rw] ou LOCAL_DIR:/MOUNT_PATH[:ro|:rw]. TYPE est l’un des éléments suivants : models, datasets, spaces, buckets. Si TYPE est omis, il est défini par défaut sur models. models, datasets et spaces sont toujours montés en lecture seule. buckets sont montés en lecture et écriture par défaut. Une source de répertoire local est d’abord synchronisée vers un bucket et montée en lecture seule par défaut. Par exemple, -v hf://datasets/org/ds:/data ou -v hf://buckets/org/b:/mnt:ro ou -v ./inputs:/inputs--env-file TEXT: Lit un fichier de variables d’environnement. Utilisez-pour les lire depuis l’entrée standard.--secrets-file TEXT: Lit un fichier de variables d’environnement secrètes. Utilisez-pour les lire depuis l’entrée standard.--flavor [cpu-basic|cpu-upgrade|cpu-performance|cpu-xl|t4-small|t4-medium|l4x1|l4x4|l40sx1|l40sx4|l40sx8|a10g-small|a10g-large|a10g-largex2|a10g-largex4|a100-large|a100x4|a100x8|h200|h200x2|h200x4|h200x8|rtx-pro-6000|rtx-pro-6000x2|rtx-pro-6000x4|rtx-pro-6000x8]: Saveur pour le matériel. Exécutez « hf jobs hardware » pour lister les saveurs disponibles. La valeur par défaut estcpu-basic.--timeout TEXT: Durée maximale : entier avec s (secondes, par défaut), m (minutes), h (heures) ou d (jours).--attempts INTEGER RANGE: Nombre maximal de tentatives, y compris la première exécution. Valeur par défaut : 1. [x>=1]--dry-run: Affiche la configuration résolue du Job sans le soumettre.--expose INTEGER: Exposer un port de conteneur via le proxy des jobs. Répétez le drapeau pour plusieurs ports (par ex.--expose 8000 --expose 8001). Chaque port exposé est accessible sur le domaine public des jobs ; l’accès nécessite un jeton HF avec un accès en lecture à l’espace de noms du job.--expose-public INTEGER: Expose un port de conteneur via le proxy des jobs sans authentification. Répétez le drapeau pour plusieurs ports. Il n'est pas nécessaire de passer également le port avec--expose.--resource-group-id TEXT: l'identifiant du groupe de ressources dans lequel créer le Job. Utilisé pour contrôler l'accès aux ressources au sein d'une organisation et pour les fonctionnalités d'attribution des coûts et de limites de dépenses.--namespace TEXT: l’espace de noms dans lequel le travail sera exécuté. Par défaut, l’espace de noms de l’utilisateur actuel est utilisé.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--format [agent|auto|human|json|quiet]: Format de sortie. La valeur par défaut est « auto », qui choisit « agent » ou « human » en fonction du terminal.--json: sortie au format JSON. Équivalent à ‘—format json’.-q, --quiet: Sortie silencieuse (un ID par ligne). Équivalent à ‘—format quiet’.--help: Affiche ce message et quitte.
Exemples $ hf jobs scheduled run “0 0 * * *” —name daily-script python:3.12 python script.py
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf jobs scheduled suspend
Suspendre (mettre en pause) un Job planifié.
Utilisation :
$ hf jobs scheduled suspend [OPTIONS] SCHEDULED_JOB_IDArguments :
SCHEDULED_JOB_ID: ID du job planifié (ou ‘namespace/scheduled_job_id’) [obligatoire]
Options :
--namespace TEXT: l’espace de noms dans lequel le travail sera exécuté. Par défaut, l’espace de noms de l’utilisateur actuel est utilisé.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf jobs scheduled suspend <id>
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf jobs scheduled trigger
Déclencher l'exécution immédiate d'un Job planifié (ne modifie pas le planning).
Utilisation :
$ hf jobs scheduled trigger [OPTIONS] SCHEDULED_JOB_IDArguments :
SCHEDULED_JOB_ID: ID du job planifié (ou ‘namespace/scheduled_job_id’) [obligatoire]
Options :
--namespace TEXT: l’espace de noms dans lequel le travail sera exécuté. Par défaut, l’espace de noms de l’utilisateur actuel est utilisé.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf jobs scheduled trigger <id>
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf jobs scheduled uv
Planifier les scripts UV sur l'infrastructure HF.
Utilisation :
$ hf jobs scheduled uv [OPTIONS] COMMAND [ARGS]...Options :
--help: Affiche ce message et quitte.
Commandes :
run: Exécuter un script UV (fichier local ou URL) sur l’infrastructure HF
hf jobs scheduled uv run
Exécuter un script UV (fichier local ou URL) sur l’infrastructure HF
Utilisation :
$ hf jobs scheduled uv run [OPTIONS] SCHEDULE SCRIPT [SCRIPT_ARGS]...Arguments :
SCHEDULE: l'une des valeurs @annually, @yearly, @monthly, @weekly, @daily, @hourly, ou une expression d'horaire CRON. [obligatoire]SCRIPT: script UV à exécuter (fichier local ou URL) [obligatoire][SCRIPT_ARGS]...: Arguments du script
Options :
--suspend / --no-suspend: Suspendre (mettre en pause) le Job planifié--concurrency / --no-concurrency: autoriser l’exécution simultanée de plusieurs instances de ce Job--image TEXT: Utiliser une image Docker personnalisée avecuvinstallé.--flavor [cpu-basic|cpu-upgrade|cpu-performance|cpu-xl|t4-small|t4-medium|l4x1|l4x4|l40sx1|l40sx4|l40sx8|a10g-small|a10g-large|a10g-largex2|a10g-largex4|a100-large|a100x4|a100x8|h200|h200x2|h200x4|h200x8|rtx-pro-6000|rtx-pro-6000x2|rtx-pro-6000x4|rtx-pro-6000x8]: Saveur pour le matériel. Exécutez « hf jobs hardware » pour lister les saveurs disponibles. La valeur par défaut estcpu-basic.-e, --env TEXT: Définit des variables d’environnement. Par exemple —env ENV=value-s, --secrets TEXT: Définit des variables d’environnement secrètes. Préférez--secrets SECRETpour lire la valeur depuis votre environnement (par ex.--secrets HF_TOKENpour transmettre votre jeton Hugging Face) ;--secrets SECRET=valueplace la valeur dans l’historique de votre shell.--name TEXT: Nomme le Job. Stocké en tant que libelléname. Les noms n'ont pas besoin d'être uniques. Par défaut, il s'agit du nom de l'image ou du script suivi d'un court hachage de la configuration de lancement résolue.-l, --label TEXT: Définit les étiquettes. Par exemple, —label KEY=VALUE ou —label LABEL-v, --volume TEXT: monte un ou plusieurs volumes. Format : hf://[TYPE/]SOURCE:/MOUNT_PATH[:ro|:rw] ou LOCAL_DIR:/MOUNT_PATH[:ro|:rw]. TYPE est l’un des éléments suivants : models, datasets, spaces, buckets. Si TYPE est omis, il est défini par défaut sur models. models, datasets et spaces sont toujours montés en lecture seule. buckets sont montés en lecture et écriture par défaut. Une source de répertoire local est d’abord synchronisée vers un bucket et montée en lecture seule par défaut. Par exemple, -v hf://datasets/org/ds:/data ou -v hf://buckets/org/b:/mnt:ro ou -v ./inputs:/inputs--env-file TEXT: Lit un fichier de variables d’environnement. Utilisez-pour les lire depuis l’entrée standard.--secrets-file TEXT: Lit un fichier de variables d’environnement secrètes. Utilisez-pour les lire depuis l’entrée standard.--timeout TEXT: Durée maximale : entier avec s (secondes, par défaut), m (minutes), h (heures) ou d (jours).--attempts INTEGER RANGE: Nombre maximal de tentatives, y compris la première exécution. Valeur par défaut : 1. [x>=1]--dry-run: Affiche la configuration résolue du Job sans le soumettre.--expose INTEGER: Exposer un port de conteneur via le proxy des jobs. Répétez le drapeau pour plusieurs ports (par ex.--expose 8000 --expose 8001). Chaque port exposé est accessible sur le domaine public des jobs ; l’accès nécessite un jeton HF avec un accès en lecture à l’espace de noms du job.--expose-public INTEGER: Expose un port de conteneur via le proxy des jobs sans authentification. Répétez le drapeau pour plusieurs ports. Il n'est pas nécessaire de passer également le port avec--expose.--resource-group-id TEXT: l'identifiant du groupe de ressources dans lequel créer le Job. Utilisé pour contrôler l'accès aux ressources au sein d'une organisation et pour les fonctionnalités d'attribution des coûts et de limites de dépenses.--namespace TEXT: l’espace de noms dans lequel le travail sera exécuté. Par défaut, l’espace de noms de l’utilisateur actuel est utilisé.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--with TEXT: Exécuter avec les paquets spécifiés installés-p, --python TEXT: l'interpréteur Python à utiliser pour l'environnement d'exécution--format [agent|auto|human|json|quiet]: Format de sortie. La valeur par défaut est « auto », qui choisit « agent » ou « human » en fonction du terminal.--json: sortie au format JSON. Équivalent à ‘—format json’.-q, --quiet: Sortie silencieuse (un ID par ligne). Équivalent à ‘—format quiet’.--help: Affiche ce message et quitte.
Exemples $ hf jobs scheduled uv run “0 0 * * ” —name daily-script script.py $ hf jobs scheduled uv run “0 0 * *” script.py —with pandas
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf jobs ssh
Se connecter par SSH à un Job en cours d’exécution.
Si le Job n'est pas encore en cours d'exécution, attend qu'il atteigne l'état RUNNING avant de se connecter. Nécessite que le Job ait été démarré avec SSH activé (hf jobs run --ssh ...) et que votre clé publique SSH soit enregistrée sur https://huggingface.co/settings/keys.
Utilisation :
$ hf jobs ssh [OPTIONS] JOB_IDArguments :
JOB_ID: identifiant du job (ou ‘namespace/job_id’) [obligatoire]
Options :
-i, --identity-file PATH: Chemin vers le fichier d'identité SSH (transmis àssh -i).--dry-run: Affiche la commande SSH au lieu de l'exécuter.--namespace TEXT: l’espace de noms dans lequel le travail sera exécuté. Par défaut, l’espace de noms de l’utilisateur actuel est utilisé.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf jobs ssh <job_id> $ hf jobs ssh <job_id> —dry-run $ hf jobs ssh <job_id> -i ~/.ssh/id_ed25519
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf jobs stats
Récupérer les statistiques et les métriques d'utilisation des ressources des Jobs.
Par défaut, affiche un instantané des statistiques actuelles et se termine (non bloquant). Utilisez —follow/-f pour afficher les statistiques en direct jusqu'à la fin des Jobs.
Utilisation :
$ hf jobs stats [OPTIONS] [JOB_IDS]...Arguments :
[JOB_IDS]...: identifiants de tâches (ou ‘namespace/job_id’)
Options :
-f, --follow: Suivre la sortie des statistiques (vue en direct jusqu'à la fin des Jobs). Sans ce drapeau, un instantané unique est affiché.--namespace TEXT: l’espace de noms dans lequel le travail sera exécuté. Par défaut, l’espace de noms de l’utilisateur actuel est utilisé.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf jobs stats $ hf jobs stats <job_id> $ hf jobs stats -f <job_id>
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf jobs uv
Exécuter des scripts UV (Python avec des dépendances intégrées) sur l’infrastructure HF.
Utilisation :
$ hf jobs uv [OPTIONS] COMMAND [ARGS]...Options :
--help: Affiche ce message et quitte.
Commandes :
run: Exécuter un script UV (fichier local ou URL) sur l’infrastructure HF
hf jobs uv run
Exécuter un script UV (fichier local ou URL) sur l’infrastructure HF
Utilisation :
$ hf jobs uv run [OPTIONS] SCRIPT [SCRIPT_ARGS]...Arguments :
SCRIPT: script UV à exécuter (fichier local ou URL) [obligatoire][SCRIPT_ARGS]...: Arguments du script
Options :
--image TEXT: Utiliser une image Docker personnalisée avecuvinstallé.--flavor [cpu-basic|cpu-upgrade|cpu-performance|cpu-xl|t4-small|t4-medium|l4x1|l4x4|l40sx1|l40sx4|l40sx8|a10g-small|a10g-large|a10g-largex2|a10g-largex4|a100-large|a100x4|a100x8|h200|h200x2|h200x4|h200x8|rtx-pro-6000|rtx-pro-6000x2|rtx-pro-6000x4|rtx-pro-6000x8]: Saveur pour le matériel. Exécutez « hf jobs hardware » pour lister les saveurs disponibles. La valeur par défaut estcpu-basic.-e, --env TEXT: Définit des variables d’environnement. Par exemple —env ENV=value-s, --secrets TEXT: Définit des variables d’environnement secrètes. Préférez--secrets SECRETpour lire la valeur depuis votre environnement (par ex.--secrets HF_TOKENpour transmettre votre jeton Hugging Face) ;--secrets SECRET=valueplace la valeur dans l’historique de votre shell.--name TEXT: Nomme le Job. Stocké en tant que libelléname. Les noms n'ont pas besoin d'être uniques. Par défaut, il s'agit du nom de l'image ou du script suivi d'un court hachage de la configuration de lancement résolue.-l, --label TEXT: Définit les étiquettes. Par exemple, —label KEY=VALUE ou —label LABEL-v, --volume TEXT: monte un ou plusieurs volumes. Format : hf://[TYPE/]SOURCE:/MOUNT_PATH[:ro|:rw] ou LOCAL_DIR:/MOUNT_PATH[:ro|:rw]. TYPE est l’un des éléments suivants : models, datasets, spaces, buckets. Si TYPE est omis, il est défini par défaut sur models. models, datasets et spaces sont toujours montés en lecture seule. buckets sont montés en lecture et écriture par défaut. Une source de répertoire local est d’abord synchronisée vers un bucket et montée en lecture seule par défaut. Par exemple, -v hf://datasets/org/ds:/data ou -v hf://buckets/org/b:/mnt:ro ou -v ./inputs:/inputs--env-file TEXT: Lit un fichier de variables d’environnement. Utilisez-pour les lire depuis l’entrée standard.--secrets-file TEXT: Lit un fichier de variables d’environnement secrètes. Utilisez-pour les lire depuis l’entrée standard.--timeout TEXT: Durée maximale : entier avec s (secondes, par défaut), m (minutes), h (heures) ou d (jours).--attempts INTEGER RANGE: Nombre maximal de tentatives, y compris la première exécution. Valeur par défaut : 1. [x>=1]-d, --detach: Exécute le Job en arrière-plan et affiche l’ID du Job.--dry-run: Affiche la configuration résolue du Job sans le soumettre.--expose INTEGER: Exposer un port de conteneur via le proxy des jobs. Répétez le drapeau pour plusieurs ports (par ex.--expose 8000 --expose 8001). Chaque port exposé est accessible sur le domaine public des jobs ; l’accès nécessite un jeton HF avec un accès en lecture à l’espace de noms du job.--expose-public INTEGER: Expose un port de conteneur via le proxy des jobs sans authentification. Répétez le drapeau pour plusieurs ports. Il n'est pas nécessaire de passer également le port avec--expose.--ssh: Rendre le conteneur du job accessible via SSH. Connectez-vous avechf jobs ssh <job_id>. Nécessite une clé publique SSH enregistrée sur https://huggingface.co/settings/keys.--network-group TEXT: Rejoindre un groupe de réseau. Les jobs du même espace de noms et du même groupe de ressources partageant un groupe sont placés ensemble et se rejoignent sur chaque port. Au sein de chaque membre,$HF_NETWORK_GROUP_HOSTNAMEse résout vers chaque membre. Alphanumériques minuscules et tirets, 46 caractères maximum.--network-alias TEXT: Réclamer un alias dans le groupe réseau. Les membres accèdent aux jobs qui le réclament à l’adresse${HF_NETWORK_GROUP_PREFIX}<alias>. Répétez le drapeau pour plusieurs alias. Alphanumériques minuscules et tirets, 34 caractères maximum, unique au sein du job. Nécessite--network-group.--resource-group-id TEXT: l'identifiant du groupe de ressources dans lequel créer le Job. Utilisé pour contrôler l'accès aux ressources au sein d'une organisation et pour les fonctionnalités d'attribution des coûts et de limites de dépenses.--namespace TEXT: l’espace de noms dans lequel le travail sera exécuté. Par défaut, l’espace de noms de l’utilisateur actuel est utilisé.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--with TEXT: Exécuter avec les paquets spécifiés installés-p, --python TEXT: l'interpréteur Python à utiliser pour l'environnement d'exécution--format [agent|auto|human|json|quiet]: Format de sortie. La valeur par défaut est « auto », qui choisit « agent » ou « human » en fonction du terminal.--json: sortie au format JSON. Équivalent à ‘—format json’.-q, --quiet: Sortie silencieuse (un ID par ligne). Équivalent à ‘—format quiet’.--help: Affiche ce message et quitte.
Exemples $ hf jobs uv run —name my-script my_script.py $ hf jobs uv run —detach my_script.py $ hf jobs uv run —flavor a10g-small ml_training.py $ hf jobs uv run —with transformers train.py $ hf jobs uv run -v hf://org/my-model:/data -v hf://buckets/org/b:/mnt script.py $ hf jobs uv run —dry-run script.py
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf jobs wait
Attendre qu'un ou plusieurs Jobs atteignent un état terminal.
Bloque jusqu'à ce que tous les Jobs aient terminé, puis quitte avec le code 0 si tous les Jobs ont abouti avec succès, ou avec un code de sortie non nul si un Job a été annulé, a généré une erreur ou a été supprimé.
Tous les Jobs doivent appartenir au même espace de noms.
Utilisation :
$ hf jobs wait [OPTIONS] JOB_IDS...Arguments :
JOB_IDS...: identifiants des tâches à attendre (ou ‘namespace/job_id’). [obligatoire]
Options :
--timeout TEXT: Durée maximale d'attente : entier avec s (secondes, par défaut), m (minutes), h (heures) ou d (jours).--namespace TEXT: l’espace de noms dans lequel le travail sera exécuté. Par défaut, l’espace de noms de l’utilisateur actuel est utilisé.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf jobs wait <job_id> $ hf jobs wait <job_id_1> <job_id_2> $ hf jobs ls -q | xargs hf jobs wait
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf lfs-enable-largefiles
Configurez votre dépôt pour autoriser le téléversement de fichiers > 5 Go.
Cette commande configure git-lfs pour utiliser l'agent de transfert multipart personnalisé, qui permet le téléchargement efficace de fichiers volumineux par lots.
Utilisation :
$ hf lfs-enable-largefiles [OPTIONS] PATHArguments :
PATH: Chemin local du dépôt que vous souhaitez configurer. [obligatoire]
Options :
--help: Affiche ce message et quitte.
hf lfs-multipart-upload
Agent de transfert personnalisé git-lfs interne pour les téléversements multipart.
Cette fonction implémente le protocole de transfert personnalisé pour les téléversements multipart de git-lfs. Gère les téléversements par morceaux de fichiers volumineux vers Hugging Face Hub.
Utilisation :
$ hf lfs-multipart-upload [OPTIONS]Options :
--help: Affiche ce message et quitte.
hf models
Interagissez avec les modèles sur le Hub.
Utilisation :
$ hf models [OPTIONS] COMMAND [ARGS]...Options :
--help: Affiche ce message et quitte.
Commandes :
card: Récupérer la carte du modèle (README) pour un modèle sur le Hub.info: Récupérer des informations sur un modèle du Hub.list: Liste les modèles sur le Hub, ou les fichiers d’un dépôt de modèle. [alias : ls]
hf models card
Obtenir la carte du modèle (README) d'un modèle sur le Hub.
Utilisation :
$ hf models card [OPTIONS] MODEL_IDArguments :
MODEL_ID: l'identifiant du modèle (par exempleusername/repo-name). [obligatoire]
Options :
--metadata: Affiche uniquement les métadonnées de la carte.--text: Affiche uniquement le corps du texte (sans métadonnées).--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf models card google/gemma-4-31B-it $ hf models card google/gemma-4-31B-it —metadata $ hf models card google/gemma-4-31B-it —metadata —format json $ hf models card google/gemma-4-31B-it —text
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf models info
Obtenir des informations sur un modèle sur le Hub.
Utilisation :
$ hf models info [OPTIONS] MODEL_IDArguments :
MODEL_ID: l'identifiant du modèle (par exempleusername/repo-name). [obligatoire]
Options :
--revision TEXT: identifiant de révision Git, qui peut être un nom de branche, un tag ou un hachage de commit.--expand TEXT: Propriétés à retourner, séparées par des virgules. Lorsqu’il est utilisé, seules les propriétés listées (et id) sont retournées. Exemple : ‘—expand=downloads,likes,tags’. Valides : author, baseModels, cardData, childrenModelCount, config, createdAt, disabled, downloads, downloadsAllTime, evalResults, gated, gguf, inference, inferenceProviderMapping, lastModified, library_name, likes, mask_token, model-index, pipeline_tag, private, resourceGroup, safetensors, sha, siblings, spaces, tags, transformersInfo, trendingScore, usedStorage, widgetData.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf models info meta-llama/Llama-3.2-1B-Instruct $ hf models info Qwen/Qwen3.5-9B —expand downloads,likes,tags
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf models list
Liste les modèles sur le Hub, ou les fichiers d’un dépôt de modèle. [alias: ls]
Lorsqu'il est appelé sans argument, il liste les modèles sur le Hub. Lorsqu'il est appelé avec un identifiant de modèle, il liste les fichiers du dépôt de ce modèle.
Utilisation :
$ hf models list [OPTIONS] [REPO_ID]Arguments :
[REPO_ID]: ID du modèle (par exempleusername/repo-name) à partir duquel lister les fichiers. S'il est omis, liste les modèles.
Options :
--search TEXT: Requête de recherche.--author TEXT: Filtrer par auteur ou organisation.--filter TEXT: Filtre par balises (par ex. ‘text-classification’). Peut être utilisé plusieurs fois.--pipeline-tag TEXT: Filtre par balise de pipeline (tâche canonique), par exemple ‘summarization’.--gated / --no-gated: Filtre par statut de contrôle d’accès. « —gated » pour les modèles contrôlés uniquement, « —no-gated » pour les modèles non contrôlés uniquement.--apps TEXT: Filtre par application(s) pouvant exécuter le modèle, par exemple ‘ollama’ ou ‘vllm’.--num-parameters TEXT: Filtre par nombre de paramètres, par exemple ‘min:6B,max:128B’.--inference-provider [baseten|cerebras|cohere|deepinfra|fal-ai|featherless-ai|fireworks-ai|groq|hf-inference|novita|nscale|openai|ovhcloud|publicai|replicate|scaleway|together|wavespeed|zai-org]: Filtre par fournisseur(s) d’inférence servant le modèle, par exemple ‘fireworks-ai’.--warm: n’affiche que les modèles actuellement servis par au moins un fournisseur d’inférence.--sort [created_at|downloads|last_modified|likes|trending_score]: Trier les résultats.--limit INTEGER: Limite le nombre de résultats. [défaut : 30]--expand TEXT: Propriétés à retourner, séparées par des virgules. Lorsqu’il est utilisé, seules les propriétés listées (et id) sont retournées. Exemple : ‘—expand=downloads,likes,tags’. Valides : author, baseModels, cardData, childrenModelCount, config, createdAt, disabled, downloads, downloadsAllTime, evalResults, gated, gguf, inference, inferenceProviderMapping, lastModified, library_name, likes, mask_token, model-index, pipeline_tag, private, resourceGroup, safetensors, sha, siblings, spaces, tags, transformersInfo, trendingScore, usedStorage, widgetData.-h, --human-readable: Affiche les tailles dans un format lisible (uniquement pour la liste des fichiers).--tree: Liste les fichiers au format arborescence (uniquement pour la liste des fichiers).-R, --recursive: Liste les fichiers de manière récursive (uniquement pour la liste des fichiers).--revision TEXT: identifiant de révision Git, qui peut être un nom de branche, un tag ou un hachage de commit.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf models ls —sort downloads —limit 10 $ hf models ls —search “llama” —author meta-llama $ hf models ls —pipeline-tag text-generation —warm $ hf models ls —num-parameters min:6B,max:128B —sort likes $ hf models ls —no-gated —author google $ hf models ls —apps llama.cpp —apps vllm $ hf models ls —inference-provider fireworks-ai —sort downloads $ hf models ls —warm —search llama $ hf models ls meta-llama/Llama-3.2-1B-Instruct $ hf models ls meta-llama/Llama-3.2-1B-Instruct -R $ hf models ls meta-llama/Llama-3.2-1B-Instruct —tree -h
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf papers
Interagissez avec les papiers sur le Hub.
Utilisation :
$ hf papers [OPTIONS] COMMAND [ARGS]...Options :
--help: Affiche ce message et quitte.
Commandes :
info: Récupère des informations sur un article du Hub.list: Liste les papiers quotidiens sur le Hub. [alias : ls]read: Lit un article au format Markdown.search: Rechercher des articles sur le Hub.
hf papers info
Obtenir des informations sur un article du Hub.
Utilisation :
$ hf papers info [OPTIONS] PAPER_IDArguments :
PAPER_ID: l'identifiant du papier arXiv (par exemple, ‘2502.08025’). [obligatoire]
Options :
--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf papers info 2601.15621
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf papers list
Liste les papiers du jour sur le Hub. [alias: ls]
Utilisation :
$ hf papers list [OPTIONS]Options :
--date TEXT: Date au format ISO (AAAA-MM-JJ) ou « today ».--week TEXT: semaine ISO à utiliser pour le filtrage, par exemple ‘2025-W09’.--month TEXT: Mois à utiliser pour le filtre, au format ISO (AAAA-MM), par exemple ‘2025-02’.--submitter TEXT: Filtre par nom d'utilisateur du soumetteur.--sort [publishedAt|trending]: Trier les résultats.--limit INTEGER: Limite le nombre de résultats. [défaut : 50]--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf papers ls $ hf papers ls —sort trending $ hf papers ls —date 2025-01-23 $ hf papers ls —week 2025-W09 $ hf papers ls —submitter akhaliq $ hf papers ls —format json
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf papers read
Lire un article au format Markdown.
Utilisation :
$ hf papers read [OPTIONS] PAPER_IDArguments :
PAPER_ID: l'identifiant du papier arXiv (par exemple, ‘2502.08025’). [obligatoire]
Options :
--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf papers read 2601.15621
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf papers search
Rechercher des articles sur le Hub.
Utilisation :
$ hf papers search [OPTIONS] QUERYArguments :
QUERY: Chaîne de requête de recherche. [obligatoire]
Options :
--limit INTEGER: Limite le nombre de résultats. [défaut : 20]--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf papers search “vision language” $ hf papers search “attention mechanism” —limit 10 $ hf papers search “diffusion” —format json
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf repos
Gérer les dépôts sur le Hub.
Utilisation :
$ hf repos [OPTIONS] COMMAND [ARGS]...Options :
--help: Affiche ce message et quitte.
Commandes :
branch: Gérer les branches d’un dépôt sur le Hub.cp: Copie des fichiers entre des chemins locaux, des dépôts et des buckets.create: crée un nouveau dépôt sur le Hub.delete: Supprimer un dépôt du Hub.delete-files: Supprime des fichiers d’un dépôt sur le Hub.duplicate: Dupliquer un dépôt sur le Hub (modèle, jeu de données ou Space).list: Liste tous les dépôts (modèles, jeux de données, espaces, buckets) avec les informations de stockage. [alias : ls]move: Déplacer un dépôt d'un espace de noms vers un autre.settings: Met à jour les paramètres d’un dépôt.tag: Gérer les tags d’un dépôt sur le Hub.
hf repos branch
Gérer les branches d’un dépôt sur le Hub.
Utilisation :
$ hf repos branch [OPTIONS] COMMAND [ARGS]...Options :
--help: Affiche ce message et quitte.
Commandes :
create: crée une nouvelle branche pour un dépôt sur le Hub.delete: Supprime une branche d'un dépôt sur le Hub.
hf repos branch create
Créer une nouvelle branche pour un dépôt sur le Hub.
Utilisation :
$ hf repos branch create [OPTIONS] REPO_ID BRANCHArguments :
REPO_ID: l'identifiant du dépôt (par exempleusername/repo-nameouspaces/username/repo-name). [obligatoire]BRANCH: Le nom de la branche à créer. [obligatoire]
Options :
--revision TEXT: identifiant de révision Git, qui peut être un nom de branche, un tag ou un hachage de commit.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--type, --repo-type [model|dataset|space|kernel]: le type de dépôt (model, dataset, space ou kernel). [défaut : model]--exist-ok / --no-exist-ok: Si défini sur True, ne lève pas d'erreur si la branche existe déjà. [défaut : no-exist-ok]--help: Affiche ce message et quitte.
Exemples $ hf repos branch create my-model dev $ hf repos branch create my-model dev —revision abc123
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf repos branch delete
Supprimer une branche d’un dépôt sur le Hub.
Utilisation :
$ hf repos branch delete [OPTIONS] REPO_ID BRANCHArguments :
REPO_ID: l'identifiant du dépôt (par exempleusername/repo-nameouspaces/username/repo-name). [obligatoire]BRANCH: Le nom de la branche à supprimer. [obligatoire]
Options :
--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--type, --repo-type [model|dataset|space|kernel]: le type de dépôt (model, dataset, space ou kernel). [défaut : model]--help: Affiche ce message et quitte.
Exemples $c hf repos branch delete my-model dev$
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf repos cp
Copier des fichiers entre des chemins locaux, des dépôts et des buckets.
Gère les téléversements (local/stdin -> dépôt/bac), les téléchargements (dépôt/bac -> local/stdout) et les copies distantes (dépôt/bac -> dépôt/bac). Les copies bac-vers-dépôt et local-vers-local ne sont pas prises en charge. Pour les répertoires, utilisez hf upload/hf download (dépôts) ou hf buckets sync (bacs). Les copies distantes ne fonctionnent que dans la même région de stockage (https://huggingface.co/docs/hub/storage-regions).
Utilisation :
$ hf repos cp [OPTIONS] SRC [DST]Arguments :
SRC: Source : fichier local, URI hf:// (dépôt ou bucket) ou - pour l'entrée standard. [obligatoire][DST]: Destination : chemin local, URI hf:// (dépôt ou bucket) ou - pour la sortie standard.
Options :
--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf repos cp hf://username/my-model/config.json config.json $ hf repos cp hf://datasets/username/my-dataset/data.csv data/ $ hf repos cp hf://username/my-model/config.json - $ hf repos cp model.safetensors hf://username/my-model/model.safetensors $ hf repos cp config.json hf://username/my-model/logs/ $ hf repos cp - hf://username/my-model/config.json $ hf repos cp hf://username/source-model/config.json hf://username/dest-model/config.json $ hf repos cp hf://datasets/username/my-dataset/processed/ hf://datasets/username/dest-dataset/processed/ $ hf repos cp hf://username/my-model/logs/ hf://username/archive-model/logs/
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf repos create
Créez un nouveau dépôt sur le Hub.
Utilisation :
$ hf repos create [OPTIONS] REPO_IDArguments :
REPO_ID: l'identifiant du dépôt (par exempleusername/repo-nameouspaces/username/repo-name). [obligatoire]
Options :
--type, --repo-type [model|dataset|space|kernel]: le type de dépôt (model, dataset, space ou kernel). [défaut : model]--sdk, --space-sdk TEXT: type de SDK Hugging Face Spaces. Obligatoire lorsque —type est défini sur ‘space’.--template TEXT: Crée un Space à partir d’un modèle officiel. Passez l’identifiant du dépôt du modèle (par ex. ‘SpacesExamples/jupyterlab’) ou son nom court (par ex. ‘JupyterLab’). Listez les modèles disponibles avechf spaces templates. Spaces uniquement.--private / --no-private: Indique s'il faut créer un dépôt privé si le dépôt n'existe pas sur le Hub. Ignoré si le dépôt existe déjà.--public: Indique si le dépôt doit être public. Ignoré si le dépôt existe déjà.--protected: Indique si l’Espace doit être protégé (Espaces uniquement). Ignoré si le dépôt existe déjà.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--exist-ok / --no-exist-ok: Ne pas lever d'erreur si le dépôt existe déjà. [valeur par défaut : no-exist-ok]--resource-group-id TEXT: Groupe de ressources dans lequel créer le dépôt. Les groupes de ressources ne sont disponibles que pour les organisations Enterprise Hub.--region [us|eu]: Région cloud dans laquelle créer le dépôt. Peut être ‘us’ ou ‘eu’. Nécessite un abonnement Team ou supérieur.--flavor [cpu-basic|cpu-upgrade|zero-a10g|t4-small|t4-medium|l4x1|l4x4|l40sx1|l40sx4|l40sx8|a10g-small|a10g-large|a10g-largex2|a10g-largex4|a100-large|a100x4|a100x8|rtx-pro-6000|rtx-pro-6000x2|rtx-pro-6000x4|rtx-pro-6000x8]: Type de matériel de l’espace (par exemple ‘cpu-basic’, ‘t4-medium’, ‘l4x4’). Uniquement pour les Spaces.--sleep-time INTEGER: Nombre de secondes d'inactivité avant que le Space ne passe en veille. Utilisez -1 pour désactiver. Uniquement pour les Spaces.-s, --secrets TEXT: Définit des variables d’environnement secrètes. Préférez--secrets SECRETpour lire la valeur depuis votre environnement (par ex.--secrets HF_TOKENpour transmettre votre jeton Hugging Face) ;--secrets SECRET=valueplace la valeur dans l’historique de votre shell.--secrets-file TEXT: Lit un fichier de variables d’environnement secrètes. Utilisez-pour les lire depuis l’entrée standard.-e, --env TEXT: Définit des variables d’environnement. Par exemple —env ENV=value--env-file TEXT: Lit un fichier de variables d’environnement. Utilisez-pour les lire depuis l’entrée standard.-v, --volume TEXT: monte un ou plusieurs volumes. Format : hf://[TYPE/]SOURCE:/MOUNT_PATH[:ro]. TYPE est l'un des éléments suivants : models, datasets, spaces, buckets. Si TYPE est omis, il est défini par défaut sur models. models, datasets et spaces sont toujours montés en lecture seule. buckets sont en lecture + écriture par défaut. Par exemple, -v hf://org/m:/data ou -v hf://datasets/org/ds:/data ou -v hf://buckets/org/b:/mnt:ro--help: Affiche ce message et quitte.
Exemples $ hf repos create my-model $ hf repos create my-dataset —repo-type dataset —private $ hf repos create my-space —type space —sdk gradio —flavor t4-medium —secrets HF_TOKEN -e THEME=dark —protected $ hf repos create my-jupyterlab —type space —template SpacesExamples/jupyterlab $ hf repos create my-space —type space —sdk gradio -v hf://org/my-model:/models -v hf://buckets/org/b:/data $ hf repos create my-model —region us
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf repos delete
Supprimer un dépôt du Hub. Cette opération est irréversible.
Utilisation :
$ hf repos delete [OPTIONS] REPO_IDArguments :
REPO_ID: l'identifiant du dépôt (par exempleusername/repo-nameouspaces/username/repo-name). [obligatoire]
Options :
--type, --repo-type [model|dataset|space|kernel]: le type de dépôt (model, dataset, space ou kernel). [défaut : model]--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--missing-ok / --no-missing-ok: si défini sur True, ne lève pas d'erreur si le dépôt n'existe pas. [valeur par défaut : no-missing-ok]-y, --yes: Répondre automatiquement Oui à la demande.--help: Affiche ce message et quitte.
Exemples $ hf repos delete my-model
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf repos delete-files
Supprimer des fichiers d’un dépôt sur le Hub.
Utilisation :
$ hf repos delete-files [OPTIONS] REPO_ID PATTERNS...Arguments :
REPO_ID: l'identifiant du dépôt (par exempleusername/repo-nameouspaces/username/repo-name). [obligatoire]PATTERNS...: Motifs glob pour correspondre aux fichiers à supprimer. Basé sur fnmatch, ’*’ correspond récursivement aux fichiers. [obligatoire]
Options :
--type, --repo-type [model|dataset|space|kernel]: le type de dépôt (model, dataset, space ou kernel). [défaut : model]--revision TEXT: identifiant de révision Git, qui peut être un nom de branche, un tag ou un hachage de commit.--commit-message TEXT: le résumé / titre / première ligne du commit généré.--commit-description TEXT: La description du commit généré.--create-pr / --no-create-pr: Indique s'il faut créer une nouvelle Pull Request pour ces modifications. [défaut : no-create-pr]--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf repos delete-files my-model file.txt $ hf repos delete-files my-model “*.json” $ hf repos delete-files my-model folder/
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf repos duplicate
Dupliquer un dépôt sur le Hub (modèle, jeu de données ou Space).
Utilisation :
$ hf repos duplicate [OPTIONS] FROM_ID [TO_ID]Arguments :
FROM_ID: l'identifiant du dépôt (par exempleusername/repo-nameouspaces/username/repo-name). [obligatoire][TO_ID]: ID du dépôt de destination (par ex.myorg/my-copy). Par défaut, votre espace de noms avec le même nom de dépôt.
Options :
--type, --repo-type [model|dataset|space|kernel]: le type de dépôt (model, dataset, space ou kernel). [défaut : model]--private / --no-private: Indique s'il faut créer un dépôt privé si le dépôt n'existe pas sur le Hub. Ignoré si le dépôt existe déjà.--public: Indique si le dépôt doit être public. Ignoré si le dépôt existe déjà.--protected: Indique si l’Espace doit être protégé (Espaces uniquement). Ignoré si le dépôt existe déjà.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--exist-ok / --no-exist-ok: Ne pas lever d'erreur si le dépôt existe déjà. [valeur par défaut : no-exist-ok]--resource-group-id TEXT: Groupe de ressources dans lequel créer le nouveau dépôt. Les groupes de ressources ne sont disponibles que pour les organisations Enterprise Hub.--flavor [cpu-basic|cpu-upgrade|zero-a10g|t4-small|t4-medium|l4x1|l4x4|l40sx1|l40sx4|l40sx8|a10g-small|a10g-large|a10g-largex2|a10g-largex4|a100-large|a100x4|a100x8|rtx-pro-6000|rtx-pro-6000x2|rtx-pro-6000x4|rtx-pro-6000x8]: Type de matériel de l’espace (par exemple ‘cpu-basic’, ‘t4-medium’, ‘l4x4’). Uniquement pour les Spaces.--sleep-time INTEGER: Nombre de secondes d'inactivité avant que le Space ne passe en veille. Utilisez -1 pour désactiver. Uniquement pour les Spaces.-s, --secrets TEXT: Définit des variables d’environnement secrètes. Préférez--secrets SECRETpour lire la valeur depuis votre environnement (par ex.--secrets HF_TOKENpour transmettre votre jeton Hugging Face) ;--secrets SECRET=valueplace la valeur dans l’historique de votre shell.--secrets-file TEXT: Lit un fichier de variables d’environnement secrètes. Utilisez-pour les lire depuis l’entrée standard.-e, --env TEXT: Définit des variables d’environnement. Par exemple —env ENV=value--env-file TEXT: Lit un fichier de variables d’environnement. Utilisez-pour les lire depuis l’entrée standard.-v, --volume TEXT: monte un ou plusieurs volumes. Format : hf://[TYPE/]SOURCE:/MOUNT_PATH[:ro]. TYPE est l'un des éléments suivants : models, datasets, spaces, buckets. Si TYPE est omis, il est défini par défaut sur models. models, datasets et spaces sont toujours montés en lecture seule. buckets sont en lecture + écriture par défaut. Par exemple, -v hf://org/m:/data ou -v hf://datasets/org/ds:/data ou -v hf://buckets/org/b:/mnt:ro--help: Affiche ce message et quitte.
Exemples $ hf repos duplicate openai/gdpval —type dataset $ hf repos duplicate multimodalart/dreambooth-training my-dreambooth —type space —flavor l4x4 —secrets HF_TOKEN —private $ hf repos duplicate org/my-space my-space —type space -v hf://org/my-model:/models -v hf://buckets/org/b:/data
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf repos list
Liste tous les dépôts (modèles, jeux de données, espaces, buckets) avec les informations de stockage. [alias: ls]
Utilisation :
$ hf repos list [OPTIONS]Options :
--namespace TEXT: Nom de l’organisation. S’il n’est pas fourni, liste les dépôts de l’utilisateur authentifié.--type, --repo-type [model|dataset|space|bucket]: filtre par type de dépôt (model, dataset, space ou bucket).--search TEXT: Requête de recherche.--limit INTEGER: Limite le nombre de résultats. [défaut : 30]--explore: Explorez vos dépôts sous forme de ville 3D interactive.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf repos ls $ hf repos ls —explore $ hf repos ls —namespace my-org —search bert
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf repos move
Déplacer un dépôt d'un espace de noms vers un autre espace de noms.
Utilisation :
$ hf repos move [OPTIONS] FROM_ID TO_IDArguments :
FROM_ID: l'identifiant du dépôt (par exempleusername/repo-nameouspaces/username/repo-name). [obligatoire]TO_ID: l'identifiant du dépôt (par exempleusername/repo-nameouspaces/username/repo-name). [obligatoire]
Options :
--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--type, --repo-type [model|dataset|space|kernel]: le type de dépôt (model, dataset, space ou kernel). [défaut : model]--help: Affiche ce message et quitte.
Exemples $ hf repos move old-namespace/my-model new-namespace/my-model
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf repos settings
Mettre à jour les paramètres d'un dépôt.
Utilisation :
$ hf repos settings [OPTIONS] REPO_IDArguments :
REPO_ID: l'identifiant du dépôt (par exempleusername/repo-nameouspaces/username/repo-name). [obligatoire]
Options :
--gated [auto|manual|false]: Statut de contrôle d'accès du dépôt.--private / --no-private: Indique s'il faut créer un dépôt privé si le dépôt n'existe pas sur le Hub. Ignoré si le dépôt existe déjà.--public: Indique si le dépôt doit être public. Ignoré si le dépôt existe déjà.--protected: Indique si l’Espace doit être protégé (Espaces uniquement). Ignoré si le dépôt existe déjà.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--type, --repo-type [model|dataset|space|kernel]: le type de dépôt (model, dataset, space ou kernel). [défaut : model]--help: Affiche ce message et quitte.
Exemples $ hf repos settings my-model —private $ hf repos settings my-model —gated auto $ hf repos settings my-space —repo-type space —protected
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf repos tag
Gérer les tags d’un dépôt sur le Hub.
Utilisation :
$ hf repos tag [OPTIONS] COMMAND [ARGS]...Options :
--help: Affiche ce message et quitte.
Commandes :
create: crée un tag pour un dépôt.delete: Supprime un tag d'un dépôt.list: Affiche les tags d'un dépôt. [alias : ls]
hf repos tag create
Créer un tag pour un dépôt.
Utilisation :
$ hf repos tag create [OPTIONS] REPO_ID TAGArguments :
REPO_ID: l'identifiant du dépôt (par exempleusername/repo-nameouspaces/username/repo-name). [obligatoire]TAG: Le nom de la balise à créer. [obligatoire]
Options :
-m, --message TEXT: La description de la balise à créer.--revision TEXT: identifiant de révision Git, qui peut être un nom de branche, un tag ou un hachage de commit.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--type, --repo-type [model|dataset|space|kernel]: le type de dépôt (model, dataset, space ou kernel). [défaut : model]--help: Affiche ce message et quitte.
Exemples $ hf repos tag create my-model v1.0 $ hf repos tag create my-model v1.0 -m “First release”
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf repos tag delete
Supprimer un tag pour un dépôt.
Utilisation :
$ hf repos tag delete [OPTIONS] REPO_ID TAGArguments :
REPO_ID: l'identifiant du dépôt (par exempleusername/repo-nameouspaces/username/repo-name). [obligatoire]TAG: Le nom de la balise à supprimer. [obligatoire]
Options :
-y, --yes: Répondre automatiquement Oui à la demande--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--type, --repo-type [model|dataset|space|kernel]: le type de dépôt (model, dataset, space ou kernel). [défaut : model]--help: Affiche ce message et quitte.
Exemples $ hf repos tag delete my-model v1.0
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf repos tag list
Liste les tags d’un dépôt. [alias: ls]
Utilisation :
$ hf repos tag list [OPTIONS] REPO_IDArguments :
REPO_ID: l'identifiant du dépôt (par exempleusername/repo-nameouspaces/username/repo-name). [obligatoire]
Options :
--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--type, --repo-type [model|dataset|space|kernel]: le type de dépôt (model, dataset, space ou kernel). [défaut : model]--help: Affiche ce message et quitte.
Exemples $c hf repos tag list my-model
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf sandbox
Exécutez et gérez des environnements de test sur Hugging Face Jobs.
Utilisation :
$ hf sandbox [OPTIONS] COMMAND [ARGS]...Options :
--help: Affiche ce message et quitte.
Commandes :
cp: Copie un fichier entre la machine locale et un bac à sable (style docker).create: crée un bac à sable : une VM dédiée par défaut, ou une VM partagée économique avec--pool.exec: Exécute une commande dans un bac à sable, avec diffusion de la sortie.kill: Mettre fin à un bac à sable, à un hôte partagé entier ou à tout (—all).pool: Préchauffe les pools de machines virtuelles hôte et crée des sandbox partagés expérimentaux pour les charges de travail au sein de la même frontière de confiance.process: Liste et arrête les processus en arrière-plan exécutés dans un bac à sable.spawn: lance une commande longue en arrière-plan et renvoie son pid (sans attendre).
hf sandbox cp
Copier un fichier entre la machine locale et un bac à sable (style docker).
Utilisation :
$ hf sandbox cp [OPTIONS] SRC DSTArguments :
SRC: Source : un chemin local ou <sandbox_id>:<path>. [obligatoire]DST: Destination : un chemin local ou <sandbox_id>:<path>. [obligatoire]
Options :
--namespace TEXT: l’espace de noms dans lequel le travail sera exécuté. Par défaut, l’espace de noms de l’utilisateur actuel est utilisé.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf sandbox cp data.csv <sandbox_id>:/data/data.csv $ hf sandbox cp <sandbox_id>:/app/result.json result.json
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf sandbox create
Créez un bac à sable : une VM dédiée par défaut, ou une VM partagée économique avec --pool.
Env et idle-timeout s’appliquent au bac à sable dans les deux modes. Avec --pool, l’image et le flavor proviennent du pool, donc les passer ici est une erreur ; --secrets est également rejeté car les bacs à sable du pool n’ont pas de canal de secrets chiffrés (utilisez --env). Définissez d’abord un pool avec hf sandbox pool create.
Utilisation :
$ hf sandbox create [OPTIONS] [IMAGE]Arguments :
[IMAGE]: image Docker (nécessite /bin/sh).
Options :
--pool TEXT: Démarre un bac à sable partagé économique dans ce pool (à partir dehf sandbox pool create).--flavor [cpu-basic|cpu-upgrade|cpu-performance|cpu-xl|t4-small|t4-medium|l4x1|l4x4|l40sx1|l40sx4|l40sx8|a10g-small|a10g-large|a10g-largex2|a10g-largex4|a100-large|a100x4|a100x8|h200|h200x2|h200x4|h200x8|rtx-pro-6000|rtx-pro-6000x2|rtx-pro-6000x4|rtx-pro-6000x8]: Saveur pour le matériel. Exécutez « hf jobs hardware » pour lister les saveurs disponibles. La valeur par défaut estcpu-basic.--idle-timeout TEXT: Met fin automatiquement au sandbox après cette durée d'inactivité (par ex. ‘10m’). Valeur par défaut : 10m.-e, --env TEXT: Définit des variables d’environnement. Par exemple —env ENV=value-s, --secrets TEXT: Définit des variables d’environnement secrètes. Préférez--secrets SECRETpour lire la valeur depuis votre environnement (par ex.--secrets HF_TOKENpour transmettre votre jeton Hugging Face) ;--secrets SECRET=valueplace la valeur dans l’historique de votre shell.-l, --label TEXT: Définit les étiquettes. Par exemple, —label KEY=VALUE ou —label LABEL--env-file TEXT: Lit un fichier de variables d’environnement. Utilisez-pour les lire depuis l’entrée standard.--secrets-file TEXT: Lit un fichier de variables d’environnement secrètes. Utilisez-pour les lire depuis l’entrée standard.-v, --volume TEXT: monte un ou plusieurs volumes. Format : hf://[TYPE/]SOURCE:/MOUNT_PATH[:ro]. TYPE est l'un des éléments suivants : models, datasets, spaces, buckets. Si TYPE est omis, il est défini par défaut sur models. models, datasets et spaces sont toujours montés en lecture seule. buckets sont en lecture + écriture par défaut. Par exemple, -v hf://org/m:/data ou -v hf://datasets/org/ds:/data ou -v hf://buckets/org/b:/mnt:ro--namespace TEXT: l’espace de noms dans lequel le travail sera exécuté. Par défaut, l’espace de noms de l’utilisateur actuel est utilisé.--forward-hf-token: injecte votre jeton HF en tant que HF_TOKEN dans le bac à sable.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf sandbox create $ hf sandbox create ubuntu:24.04 $ hf sandbox create —flavor a10g-small $ hf sandbox create —label controller-run=run-42 $ hf sandbox create —pool pool-ab12cd34ef56 —env LOG_LEVEL=debug
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf sandbox exec
Exécute une commande dans un bac à sable, en diffusant la sortie en continu. Se termine avec le code de sortie de la commande.
Pour lancer une commande longue en arrière-plan au lieu d’attendre sa fin, utilisez hf sandbox spawn.
Utilisation :
$ hf sandbox exec [OPTIONS] SANDBOX_ID COMMAND...Arguments :
SANDBOX_ID: l'identifiant du bac à sable tel qu'affiché parhf sandbox create. [obligatoire]COMMAND...: La commande à exécuter. [obligatoire]
Options :
-w, --workdir TEXT: Répertoire de travail.-e, --env TEXT: Définit des variables d’environnement. Par exemple —env ENV=value--env-file TEXT: Lit un fichier de variables d’environnement. Utilisez-pour les lire depuis l’entrée standard.--timeout FLOAT: Interrompt la commande après ce nombre de secondes.--namespace TEXT: l’espace de noms dans lequel le travail sera exécuté. Par défaut, l’espace de noms de l’utilisateur actuel est utilisé.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf sandbox exec <sandbox_id> — python -c “print(42)” $ hf sandbox exec -w /app <sandbox_id> — pytest -x
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf sandbox kill
Terminer un bac à sable, un hôte partagé entier ou tout (—all).
Utilisation :
$ hf sandbox kill [OPTIONS] [SANDBOX_ID]Arguments :
[SANDBOX_ID]: identifiant du bac à sable ou de l'hôte à terminer.
Options :
--all: Met fin à tous les sandbox et hôtes de l'espace de noms.-y, --yes: Répondre automatiquement « Oui » aux invites.--namespace TEXT: l’espace de noms dans lequel le travail sera exécuté. Par défaut, l’espace de noms de l’utilisateur actuel est utilisé.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf sandbox kill <sandbox_id> $ hf sandbox kill <host_id> # tue un hôte partagé entier (tous ses sandboxes) $ hf sandbox kill —all
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf sandbox pool
Préchauffer les pools de machines virtuelles hôte et générer des sandboxes partagées expérimentales pour les charges de travail au sein de la même frontière de confiance.
Utilisation :
$ hf sandbox pool [OPTIONS] COMMAND [ARGS]...Options :
--help: Affiche ce message et quitte.
Commandes :
create: Préchauffer un pool : démarrer une VM hôte maintenant, avec un tag pour qu'elle puisse être trouvée plus tard par son identifiant de pool.delete: Met fin à toutes les machines virtuelles hôte d’un pool (et donc à tous ses sandboxes). [alias : rm]ls: Liste les pools de sandbox en cours d’exécution (regroupés à partir de leurs VM hôtes). [alias : list]
hf sandbox pool create
Préchauffer un pool : démarrer une machine virtuelle hôte maintenant, avec un tag permettant de la retrouver plus tard par son identifiant de pool.
Utilisation :
$ hf sandbox pool create [OPTIONS] [IMAGE]Arguments :
[IMAGE]: image Docker pour les hôtes (nécessite /bin/sh).
Options :
--flavor [cpu-basic|cpu-upgrade|cpu-performance|cpu-xl|t4-small|t4-medium|l4x1|l4x4|l40sx1|l40sx4|l40sx8|a10g-small|a10g-large|a10g-largex2|a10g-largex4|a100-large|a100x4|a100x8|h200|h200x2|h200x4|h200x8|rtx-pro-6000|rtx-pro-6000x2|rtx-pro-6000x4|rtx-pro-6000x8]: Saveur pour le matériel. Exécutez « hf jobs hardware » pour lister les saveurs disponibles. La valeur par défaut estcpu-basic.--per-host INTEGER RANGE: Nombre de sandboxes regroupés par machine virtuelle hôte (50 par défaut). [défaut : 50 ; x>=1]--max-hosts INTEGER RANGE: Plafond facultatif du nombre de machines virtuelles hôte. [x>=1]--idle-timeout TEXT: Arrête un hôte une fois qu’il n’a plus de sandbox depuis cette durée (par exemple ‘10m’). Valeur par défaut : 10m.--namespace TEXT: l’espace de noms dans lequel le travail sera exécuté. Par défaut, l’espace de noms de l’utilisateur actuel est utilisé.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf sandbox pool create $ hf sandbox pool create python:3.12 —flavor cpu-basic $ hf sandbox pool create —per-host 50 —idle-timeout 30m
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf sandbox pool delete
Mettre fin à chaque machine virtuelle hôte d'un pool (et donc à tous ses sandboxes). [alias: rm]
Utilisation :
$ hf sandbox pool delete [OPTIONS] POOL_IDArguments :
POOL_ID: identifiant du pool à supprimer. [obligatoire]
Options :
-y, --yes: Répondre automatiquement « Oui » aux invites.--namespace TEXT: l’espace de noms dans lequel le travail sera exécuté. Par défaut, l’espace de noms de l’utilisateur actuel est utilisé.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf sandbox pool delete <pool_id>
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf sandbox pool ls
Liste les pools de sandbox en cours d’exécution (groupés à partir de leurs VM hôtes). [alias: list]
Utilisation :
$ hf sandbox pool ls [OPTIONS]Options :
--namespace TEXT: l’espace de noms dans lequel le travail sera exécuté. Par défaut, l’espace de noms de l’utilisateur actuel est utilisé.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $c hf sandbox pool ls$
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf sandbox process
Lister et arrêter les processus en arrière-plan exécutés dans un bac à sable.
Utilisation :
$ hf sandbox process [OPTIONS] COMMAND [ARGS]...Options :
--help: Affiche ce message et quitte.
Commandes :
kill: Arrêter un processus en arrière-plan exécuté dans un bac à sable.ls: Liste les processus en arrière-plan exécutés dans un bac à sable (démarrés avechf sandbox spawn). [alias : list]
hf sandbox process kill
Arrêter un processus en arrière-plan exécuté dans un bac à sable.
Utilisation :
$ hf sandbox process kill [OPTIONS] SANDBOX_ID PIDArguments :
SANDBOX_ID: l'identifiant du bac à sable tel qu'affiché parhf sandbox create. [obligatoire]PID: le pid tel qu’affiché parhf sandbox process ls. [obligatoire]
Options :
--namespace TEXT: l’espace de noms dans lequel le travail sera exécuté. Par défaut, l’espace de noms de l’utilisateur actuel est utilisé.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf sandbox process kill <sandbox_id> <pid>
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf sandbox process ls
Liste les processus en arrière-plan en cours d’exécution dans un bac à sable (démarrés avec hf sandbox spawn). [alias: list]
Utilisation :
$ hf sandbox process ls [OPTIONS] SANDBOX_IDArguments :
SANDBOX_ID: l'identifiant du bac à sable tel qu'affiché parhf sandbox create. [obligatoire]
Options :
--namespace TEXT: l’espace de noms dans lequel le travail sera exécuté. Par défaut, l’espace de noms de l’utilisateur actuel est utilisé.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf sandbox process ls <sandbox_id>
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf sandbox spawn
Lancez une commande longue en arrière-plan et retournez son pid (sans attendre).
Listez les processus d’un bac à sable avec hf sandbox process ls et arrêtez-en un avec hf sandbox process kill.
Utilisation :
$ hf sandbox spawn [OPTIONS] SANDBOX_ID COMMAND...Arguments :
SANDBOX_ID: l'identifiant du bac à sable tel qu'affiché parhf sandbox create. [obligatoire]COMMAND...: La commande à exécuter en arrière-plan. [obligatoire]
Options :
-w, --workdir TEXT: Répertoire de travail.-e, --env TEXT: Définit des variables d’environnement. Par exemple —env ENV=value--env-file TEXT: Lit un fichier de variables d’environnement. Utilisez-pour les lire depuis l’entrée standard.--namespace TEXT: l’espace de noms dans lequel le travail sera exécuté. Par défaut, l’espace de noms de l’utilisateur actuel est utilisé.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf sandbox spawn <sandbox_id> — python -m http.server 8000 $ hf sandbox spawn -w /app <sandbox_id> — uvicorn app:app
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf skills
Gérer les compétences des assistants IA.
Utilisation :
$ hf skills [OPTIONS] COMMAND [ARGS]...Options :
--help: Affiche ce message et quitte.
Commandes :
add: Installe une compétence Hugging Face pour un assistant IA.list: Liste les compétences disponibles sur le marché Hugging Face. [alias : ls]preview: Affiche le fichier SKILL.md généré parhf-clisur la sortie standard.update: Met à jour les compétences du marché Hugging Face installées.
hf skills add
Installer une compétence Hugging Face pour un assistant IA.
La compétence par défaut hf-cli est générée localement à partir de la version du CLI installée ;
les autres compétences sont téléchargées depuis le marché Hugging Face.
L’emplacement par défaut est le répertoire courant (.agents/skills) ou le niveau utilisateur (~/.agents/skills).
La compétence est également liée symboliquement dans le répertoire des compétences de Claude Code (.claude/skills ou ~/.claude/skills,
en respectant CLAUDE_CONFIG_DIR s’il est défini), sauf si --dest est utilisé.
Utilisation :
$ hf skills add [OPTIONS] [NAME]Arguments :
[NAME]: Nom de la compétence du marché.
Options :
-g, --global: Installe globalement (au niveau de l'utilisateur) au lieu de l'installer dans le répertoire du projet actuel.--dest PATH: Installer dans une destination personnalisée (chemin vers le répertoire des compétences).--force: Écrase les compétences existantes dans la destination.--help: Affiche ce message et quitte.
Exemples $ hf skills add $ hf skills add huggingface-gradio —dest=~/my-skills $ hf skills add —global $ hf skills add huggingface-gradio —global
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf skills list
Liste les compétences disponibles sur le marché Hugging Face. [alias: ls]
Utilisation :
$ hf skills list [OPTIONS]Options :
--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf skills list $ hf skills list —format json
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf skills preview
Afficher le fichier hf-cli SKILL.md généré sur la sortie standard.
Utilisation :
$ hf skills preview [OPTIONS]Options :
--help: Affiche ce message et quitte.
hf skills update
Mettre à jour les compétences du marché Hugging Face installées.
Utilisation :
$ hf skills update [OPTIONS] [NAME]Arguments :
[NAME]: Nom facultatif de la compétence installée à mettre à jour.
Options :
-g, --global: Utilise les répertoires de compétences globales au lieu du projet actuel.--dest PATH: Met à jour les compétences dans un répertoire de compétences personnalisé.--help: Affiche ce message et quitte.
Exemples $ hf skills update $ hf skills update hf-cli $ hf skills update huggingface-gradio —dest=~/my-skills $ hf skills update -g
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf spaces
Interagissez avec les espaces sur le Hub.
Utilisation :
$ hf spaces [OPTIONS] COMMAND [ARGS]...Options :
--help: Affiche ce message et quitte.
Commandes :
card: Récupérer la carte (README) d'un Space sur le Hub.dev-mode: Activer ou désactiver le mode développement sur un Space.hardware: Liste les options de matériel disponibles pour Spaces.hot-reload: Rechargez à chaud n'importe quel fichier Python d'un Space sans reconstruction ni redémarrage complets.info: Récupère des informations sur un espace sur le Hub.list: Liste les espaces sur le Hub, ou les fichiers d'un dépôt d'espace. [alias : ls]logs: Récupérer les journaux d’exécution ou de construction d’un Space.pause: Pause a Space.restart: Redémarrer un Space.search: Recherche des espaces sur le Hub à l'aide de la recherche sémantique.secrets: Gérer les secrets d'un Space sur le Hub.settings: Met à jour les paramètres d'un Space.ssh: se connecter en SSH au conteneur Dev Mode d’un Space.templates: Liste les modèles d’espaces disponibles.variables: Gérer les variables d’environnement d’un Space sur le Hub.volumes: Gérer les volumes d'un Space sur le Hub.wait: Attendre qu'un Space ait terminé sa construction/démarrage.zero-gpu: Gérez votre utilisation de ZeroGPU sur le Hub.
hf spaces card
Obtenir la carte Space (README) d’un Space sur le Hub.
Utilisation :
$ hf spaces card [OPTIONS] SPACE_IDArguments :
SPACE_ID: l'identifiant de l'espace (par exempleusername/repo-name). [obligatoire]
Options :
--metadata: Affiche uniquement les métadonnées de la carte.--text: Affiche uniquement le corps du texte (sans métadonnées).--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf spaces card mteb/leaderboard $ hf spaces card mteb/leaderboard —metadata $ hf spaces card mteb/leaderboard —metadata —format json $ hf spaces card mteb/leaderboard —text
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf spaces dev-mode
Activer ou désactiver le mode dev sur un Space.
Spaces Dev Mode facilite le débogage de votre application et accélère l’itération sur les Spaces en vous permettant de redémarrer votre application sans arrêter le conteneur du Space lui-même. L’activation du mode dev nécessite un plan PRO ou Team & Enterprise. La désactivation (--stop) est toujours autorisée.
Voir la documentation : https://huggingface.co/docs/hub/spaces-dev-mode
Utilisation :
$ hf spaces dev-mode [OPTIONS] SPACE_IDArguments :
SPACE_ID: l'identifiant de l'espace (par exempleusername/repo-name). [obligatoire]
Options :
--stop / --no-stop: Arrêter le mode développement. [valeur par défaut : no-stop]--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf spaces dev-mode my-user-name/deepsite
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf spaces matériel
Liste les options de matériel disponibles pour Spaces.
Utilisation :
$ hf spaces hardware [OPTIONS]Options :
--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf spaces hardware
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf spaces hot-reload
Rechargez à chaud n'importe quel fichier Python d'un Space sans reconstruction ni redémarrage complets.
⚠ Cette fonctionnalité est expérimentale ⚠
Fonctionne uniquement avec le SDK Gradio (6.1+) Ouvre un éditeur interactif, sauf si —local-file/-f est spécifié.
Cette commande applique des correctifs au processus Python en cours d’exécution à l’aide de https://github.com/breuleux/jurigged (diffs basés sur l’AST, mises à jour de fonctions in situ, etc.), intégré à la prise en charge native du rechargement à chaud de Gradio (ce qui signifie que les modifications de l’objet de démonstration Gradio sont reflétées dans l’interface utilisateur)
La commande crée un commit distant.
Si vous travaillez depuis un clone local, exécutez git pull --autostash par la suite
pour récupérer le commit et synchroniser l'état local de git.
Utilisation :
$ hf spaces hot-reload [OPTIONS] SPACE_ID [FILENAME]Arguments :
SPACE_ID: l'identifiant de l'espace (par exempleusername/repo-name). [obligatoire][FILENAME]: Chemin vers le fichier Python dans le dépôt du Space. Peut être omis si —local-file est spécifié et que le chemin dans le dépôt correspond.
Options :
-f, --local-file PATH: Chemin du fichier local. Mode d’éditeur interactif si non spécifié--skip-checks / --no-skip-checks: Ignorer les vérifications de compatibilité du rechargement à chaud. [défaut : no-skip-checks]--skip-summary / --no-skip-summary: Ignorer l’affichage du récapitulatif après le déclenchement du rechargement à chaud [défaut : no-skip-summary]--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf spaces hot-reload username/repo-name app.py # Open an interactive editor to the remote app.py file $ hf spaces hot-reload username/repo-name -f app.py # Take local version from ./app.py and patch app.py remotely $ hf spaces hot-reload username/repo-name app.py -f src/app.py # Take local version from ./src/app.py
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf spaces info
Obtenir des informations sur un espace sur le Hub.
Utilisation :
$ hf spaces info [OPTIONS] SPACE_IDArguments :
SPACE_ID: l'identifiant de l'espace (par exempleusername/repo-name). [obligatoire]
Options :
--revision TEXT: identifiant de révision Git, qui peut être un nom de branche, un tag ou un hachage de commit.--expand TEXT: Propriétés à retourner, séparées par des virgules. Lorsqu’il est utilisé, seules les propriétés listées (et id) sont retournées. Exemple : ‘—expand=likes,tags’. Valides : author, cardData, createdAt, datasets, disabled, lastModified, likes, models, private, region, resourceGroup, runtime, sdk, sha, siblings, subdomain, tags, trendingScore, usedStorage, visibility.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf spaces info enzostvs/deepsite $ hf spaces info gradio/theme_builder —expand sdk,runtime,likes
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf spaces list
Liste les espaces sur le Hub, ou les fichiers dans un dépôt d’espace. [alias: ls]
Lorsqu'elle est appelée sans argument, elle liste les espaces sur le Hub. Lorsqu'elle est appelée avec un identifiant d'espace, elle liste les fichiers du dépôt de cet espace.
Utilisation :
$ hf spaces list [OPTIONS] [REPO_ID]Arguments :
[REPO_ID]: identifiant de l’espace (par exempleusername/repo-name) à partir duquel lister les fichiers. S’il est omis, liste les espaces.
Options :
--search TEXT: Requête de recherche.--author TEXT: Filtrer par auteur ou organisation.--filter TEXT: Filtre par balises (par ex. ‘text-classification’). Peut être utilisé plusieurs fois.--sort [created_at|last_modified|likes|trending_score]: Trier les résultats.--limit INTEGER: Limite le nombre de résultats. [défaut : 30]--expand TEXT: Propriétés à retourner, séparées par des virgules. Lorsqu’il est utilisé, seules les propriétés listées (et id) sont retournées. Exemple : ‘—expand=likes,tags’. Valides : author, cardData, createdAt, datasets, disabled, lastModified, likes, models, private, region, resourceGroup, runtime, sdk, sha, siblings, subdomain, tags, trendingScore, usedStorage, visibility.-h, --human-readable: Affiche les tailles dans un format lisible (uniquement pour la liste des fichiers).--tree: Liste les fichiers au format arborescence (uniquement pour la liste des fichiers).-R, --recursive: Liste les fichiers de manière récursive (uniquement pour la liste des fichiers).--revision TEXT: identifiant de révision Git, qui peut être un nom de branche, un tag ou un hachage de commit.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf spaces ls —limit 10 $ hf spaces ls —search “chatbot” —author huggingface $ hf spaces ls victor/deepsite $ hf spaces ls victor/deepsite -R $ hf spaces ls victor/deepsite —tree -h
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf spaces logs
Récupérer les journaux d’exécution ou de construction d’un Space.
Par défaut, affiche les journaux d’exécution actuellement disponibles et quitte (non bloquant, comme docker logs). Utilisez —follow/-f pour diffuser en continu jusqu’à ce que le serveur ferme le flux.
Utilisez —build pour afficher les journaux de construction du conteneur à la place (utile lorsqu’un Space est bloqué en BUILD_ERROR).
Utilisation :
$ hf spaces logs [OPTIONS] SPACE_IDArguments :
SPACE_ID: l'identifiant de l'espace (par exempleusername/repo-name). [obligatoire]
Options :
--build: Récupère les journaux de construction du conteneur au lieu des journaux d’exécution. Utile lorsqu’un Space est bloqué en BUILD_ERROR.-f, --follow: Suivre la sortie des journaux (flux jusqu'à la fermeture du flux par le serveur). Sans cet attribut, seuls les journaux actuellement disponibles sont affichés.-n, --tail INTEGER: Nombre de lignes à afficher à partir de la fin des journaux.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf spaces logs username/my-space $ hf spaces logs username/my-space —build $ hf spaces logs -f username/my-space $ hf spaces logs -n 50 username/my-space
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf spaces pause
Appuyez sur Espace.
Utilisation :
$ hf spaces pause [OPTIONS] SPACE_IDArguments :
SPACE_ID: l'identifiant de l'espace (par exempleusername/repo-name). [obligatoire]
Options :
--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $c hf spaces pause username/my-space
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf spaces restart
Redémarrer un Space.
Utilisation :
$ hf spaces restart [OPTIONS] SPACE_IDArguments :
SPACE_ID: l'identifiant de l'espace (par exempleusername/repo-name). [obligatoire]
Options :
--factory-reboot: Reconstruit l'espace de zéro sans utiliser le cache de build.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf spaces restart username/my-space $ hf spaces restart username/my-space —factory-reboot
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf spaces search
Recherchez des espaces sur le Hub à l'aide de la recherche sémantique.
Utilisation :
$ hf spaces search [OPTIONS] QUERYArguments :
QUERY: Requête de recherche. [obligatoire]
Options :
--filter TEXT: Filtre par balises (par ex. ‘text-classification’). Peut être utilisé plusieurs fois.--sdk TEXT: Filtrer par SDK (par ex. gradio, docker, static).--include-non-running / --no-include-non-running: Inclut les espaces non actifs dans les résultats. [valeur par défaut : no-include-non-running]--description / --no-description: Afficher les descriptions générées par IA. [défaut : no-description]--limit INTEGER: Limite le nombre de résultats. [défaut : 10]--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf spaces search “generate image” $ hf spaces search “identify objects in pictures” —sdk gradio —limit 5 $ hf spaces search “remove background from photo” —description —json
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf spaces secrets
Gérer les secrets d'un Space sur le Hub.
Utilisation :
$ hf spaces secrets [OPTIONS] COMMAND [ARGS]...Options :
--help: Affiche ce message et quitte.
Commandes :
add: Ajoute ou met à jour les secrets d'un Space.delete: Supprime un secret d'un Space.list: Liste les secrets d'un Space. [alias : ls]
hf spaces secrets add
Ajouter ou mettre à jour des secrets pour un Space.
Utilisation :
$ hf spaces secrets add [OPTIONS] SPACE_IDArguments :
SPACE_ID: l'identifiant de l'espace (par exempleusername/repo-name). [obligatoire]
Options :
-s, --secrets TEXT: Définit des variables d’environnement secrètes. Préférez--secrets SECRETpour lire la valeur depuis votre environnement (par ex.--secrets HF_TOKENpour transmettre votre jeton Hugging Face) ;--secrets SECRET=valueplace la valeur dans l’historique de votre shell.--secrets-file TEXT: Lit un fichier de variables d’environnement secrètes. Utilisez-pour les lire depuis l’entrée standard.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf spaces secrets add username/my-space -s HF_TOKEN $ hf spaces secrets add username/my-space -s OPENAI_API_KEY=sk-… -s ANTHROPIC_API_KEY=sk-… $ hf spaces secrets add username/my-space —secrets-file .env.secrets
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf spaces secrets delete
Supprimer un secret d'un Space.
Utilisation :
$ hf spaces secrets delete [OPTIONS] SPACE_ID KEYArguments :
SPACE_ID: l'identifiant de l'espace (par exempleusername/repo-name). [obligatoire]KEY: Nom du secret à supprimer. [obligatoire]
Options :
-y, --yes: Répondre automatiquement Oui à la demande.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf spaces secrets delete username/my-space HF_TOKEN $ hf spaces secrets delete username/my-space HF_TOKEN —yes
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf spaces secrets list
Liste les secrets d'un Space. Les valeurs des secrets sont en écriture seule et ne sont pas renvoyées. [alias: ls]
Utilisation :
$ hf spaces secrets list [OPTIONS] SPACE_IDArguments :
SPACE_ID: l'identifiant de l'espace (par exempleusername/repo-name). [obligatoire]
Options :
--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf spaces secrets ls username/my-space
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf spaces settings
Mettre à jour les paramètres d'un Space.
Utilisation :
$ hf spaces settings [OPTIONS] SPACE_IDArguments :
SPACE_ID: l'identifiant de l'espace (par exempleusername/repo-name). [obligatoire]
Options :
--sleep-time INTEGER: Temps d'inactivité en secondes après lequel le Space passe en veille. Utilisez -1 pour qu'il ne passe jamais en veille. Disponible uniquement sur le matériel mis à niveau.--hardware [cpu-basic|cpu-upgrade|zero-a10g|t4-small|t4-medium|l4x1|l4x4|l40sx1|l40sx4|l40sx8|a10g-small|a10g-large|a10g-largex2|a10g-largex4|a100-large|a100x4|a100x8|rtx-pro-6000|rtx-pro-6000x2|rtx-pro-6000x4|rtx-pro-6000x8]: Type de matériel de l’espace (par exemple, ‘cpu-basic’, ‘t4-medium’, ‘l4x4’). Exécutez ‘hf spaces hardware’ pour afficher les options disponibles.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf spaces settings username/my-space —sleep-time 300 $ hf spaces settings username/my-space —hardware t4-medium
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf spaces ssh
Se connecter en SSH au conteneur du mode Dev d’un Space.
Nécessite que le Dev Mode soit actif sur le Space et que votre clé publique SSH soit enregistrée sur https://huggingface.co/settings/keys.
Voir : https://huggingface.co/docs/hub/spaces-dev-mode
Utilisation :
$ hf spaces ssh [OPTIONS] SPACE_IDArguments :
SPACE_ID: l'identifiant de l'espace (par exempleusername/repo-name). [obligatoire]
Options :
-i, --identity-file PATH: Chemin vers le fichier d'identité SSH (transmis àssh -i).--dry-run: Affiche la commande SSH au lieu de l'exécuter.--auto: Active le mode Dev sans demande s'il n'est pas déjà activé.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf spaces ssh username/my-space $ hf spaces ssh username/my-space —dry-run $ hf spaces ssh username/my-space -i ~/.ssh/id_ed25519 $ hf spaces ssh username/my-space —auto
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf spaces templates
Lister les modèles d’espaces disponibles.
Le repo_id (ou name) d’un modèle peut être transmis à hf repos create --template ... pour créer un nouvel espace à partir de ce modèle.
Utilisation :
$ hf spaces templates [OPTIONS]Options :
--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf spaces templates
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf spaces variables
Gérer les variables d’environnement d’un Space sur le Hub.
Utilisation :
$ hf spaces variables [OPTIONS] COMMAND [ARGS]...Options :
--help: Affiche ce message et quitte.
Commandes :
add: Ajoute ou met à jour les variables d’environnement d’un Space.delete: Supprime une variable d’environnement d’un Space.list: Liste les variables d’environnement d’un Space. [alias : ls]
hf spaces variables add
Ajouter ou mettre à jour des variables d’environnement pour un Space.
Utilisation :
$ hf spaces variables add [OPTIONS] SPACE_IDArguments :
SPACE_ID: l'identifiant de l'espace (par exempleusername/repo-name). [obligatoire]
Options :
-e, --env TEXT: Définit des variables d’environnement. Par exemple —env ENV=value--env-file TEXT: Lit un fichier de variables d’environnement. Utilisez-pour les lire depuis l’entrée standard.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf spaces variables add username/my-space -e DEBUG=1 $ hf spaces variables add username/my-space -e MODEL_ID=gpt2 -e MAX_TOKENS=512 $ hf spaces variables add username/my-space —env-file .env
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf spaces variables delete
Supprimer une variable d’environnement d’un Space.
Utilisation :
$ hf spaces variables delete [OPTIONS] SPACE_ID KEYArguments :
SPACE_ID: l'identifiant de l'espace (par exempleusername/repo-name). [obligatoire]KEY: Nom de la variable à supprimer. [obligatoire]
Options :
-y, --yes: Répondre automatiquement Oui à la demande.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf spaces variables delete username/my-space DEBUG $ hf spaces variables delete username/my-space DEBUG —yes
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf spaces variables list
Liste les variables d’environnement d’un Space. [alias: ls]
Utilisation :
$ hf spaces variables list [OPTIONS] SPACE_IDArguments :
SPACE_ID: l'identifiant de l'espace (par exempleusername/repo-name). [obligatoire]
Options :
--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $c hf spaces variables ls username/my-space
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf spaces volumes
Gérer les volumes d'un Space sur le Hub.
Utilisation :
$ hf spaces volumes [OPTIONS] COMMAND [ARGS]...Options :
--help: Affiche ce message et quitte.
Commandes :
delete: Supprime tous les volumes d'un Space.list: Liste les volumes montés dans un Space. [alias : ls]set: définit (remplace) les volumes d'un Space.
hf spaces volumes delete
Supprimer tous les volumes d'un Space.
Utilisation :
$ hf spaces volumes delete [OPTIONS] SPACE_IDArguments :
SPACE_ID: l'identifiant de l'espace (par exempleusername/repo-name). [obligatoire]
Options :
-y, --yes: Répondre automatiquement Oui à la demande.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf spaces volumes delete username/my-space $ hf spaces volumes delete username/my-space —yes
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf spaces volumes list
Liste les volumes montés dans un Space. [alias: ls]
Utilisation :
$ hf spaces volumes list [OPTIONS] SPACE_IDArguments :
SPACE_ID: l'identifiant de l'espace (par exempleusername/repo-name). [obligatoire]
Options :
--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $c hf spaces volumes ls username/my-space
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf spaces volumes set
Définir (remplacer) les volumes d'un Space.
Utilisation :
$ hf spaces volumes set [OPTIONS] SPACE_IDArguments :
SPACE_ID: l'identifiant de l'espace (par exempleusername/repo-name). [obligatoire]
Options :
-v, --volume TEXT: monte un ou plusieurs volumes. Format : hf://[TYPE/]SOURCE:/MOUNT_PATH[:ro]. TYPE est l'un des éléments suivants : models, datasets, spaces, buckets. Si TYPE est omis, il est défini par défaut sur models. models, datasets et spaces sont toujours montés en lecture seule. buckets sont en lecture + écriture par défaut. Par exemple, -v hf://org/m:/data ou -v hf://datasets/org/ds:/data ou -v hf://buckets/org/b:/mnt:ro--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf spaces volumes set username/my-space -v hf://models/username/my-model:/models $ hf spaces volumes set username/my-space -v hf://buckets/username/my-bucket:/data -v hf://datasets/username/my-dataset:/datasets:ro
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf spaces wait
Attendez qu'un Space ait terminé sa construction/démarrage.
Bloque jusqu'à ce que le Space quitte une étape intermédiaire (BUILDING, APP_STARTING, etc.) et atteigne une étape stable. Se termine avec le code 0 si le Space est en RUNNING, ou avec un code de sortie non nul dans le cas contraire (par exemple BUILD_ERROR, RUNTIME_ERROR).
Utilisation :
$ hf spaces wait [OPTIONS] SPACE_IDArguments :
SPACE_ID: l'identifiant de l'espace (par exempleusername/repo-name). [obligatoire]
Options :
--timeout TEXT: Durée maximale d'attente : entier avec s (secondes, par défaut), m (minutes), h (heures) ou d (jours).--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf spaces wait username/my-space $ hf spaces wait username/my-space —timeout 5m
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf spaces zero-gpu
Gérez votre utilisation de ZeroGPU sur le Hub.
Utilisation :
$ hf spaces zero-gpu [OPTIONS] COMMAND [ARGS]...Options :
--help: Affiche ce message et quitte.
Commandes :
quota: Affiche votre quota ZeroGPU (temps GPU restant et date de réinitialisation).
hf spaces quota zero-gpu
Afficher votre quota ZeroGPU (temps GPU restant et date de réinitialisation).
Les valeurs sont exprimées en secondes-GPU. Avec --quiet, seules les secondes-GPU restantes sont affichées.
Utilisation :
$ hf spaces zero-gpu quota [OPTIONS]Options :
--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf spaces zero-gpu quota $ hf spaces zero-gpu quota —format json
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf sync
Synchroniser les fichiers entre un répertoire local et un bucket.
Utilisation :
$ hf sync [OPTIONS] [SOURCE] [DEST]Arguments :
[SOURCE]: Chemin source : répertoire local ou hf://buckets/namespace/bucket_name(/prefix)[DEST]: Chemin de destination : répertoire local ou hf://buckets/namespace/bucket_name(/prefix)
Options :
--delete / --no-delete: Supprime les fichiers de destination qui ne sont pas présents dans la source. [valeur par défaut : no-delete]--ignore-times: Ignorer les fichiers uniquement en fonction de leur taille, en ignorant les dates de modification.--ignore-sizes: Ignorer les fichiers uniquement sur la base des horodatages de modification, en ignorant les tailles.--plan TEXT: Enregistre le plan de synchronisation dans un fichier JSONL pour examen au lieu de l'exécuter.--apply TEXT: Applique un fichier de plan enregistré précédemment.--dry-run: Affiche le plan de synchronisation sur la sortie standard au format JSONL sans l'exécuter.--include TEXT: Inclure les fichiers correspondant au motif (plusieurs motifs peuvent être spécifiés).--exclude TEXT: Exclure les fichiers correspondant au motif (peut être spécifié plusieurs fois).--filter-from TEXT: Lit les motifs d'inclusion/exclusion depuis un fichier.--existing: Ignorer la création de nouveaux fichiers sur le récepteur (ne mettre à jour que les fichiers existants).--ignore-existing: Ignore la mise à jour des fichiers existants sur le récepteur (crée uniquement de nouveaux fichiers).-v, --verbose: Affiche un journal détaillé avec le raisonnement.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
hf update
Mettez à jour le CLI hf vers la dernière version.
Utilisation :
$ hf update [OPTIONS]Options :
--help: Affiche ce message et quitte.
hf upload
Téléversez un fichier ou un dossier sur le Hub.
Les dossiers contenant de nombreux fichiers sont répartis en plusieurs commits. Si l’envoi d’un dossier est interrompu, relancez la même commande pour reprendre l’opération.
Utilisation :
$ hf upload [OPTIONS] REPO_ID [LOCAL_PATH] [PATH_IN_REPO]Arguments :
REPO_ID: l'identifiant du dépôt (par exempleusername/repo-nameouspaces/username/repo-name). [obligatoire][LOCAL_PATH]: Chemin local du fichier ou du dossier à téléverser. Les motifs avec caractères jokers sont pris en charge. Par défaut, le répertoire courant est utilisé.[PATH_IN_REPO]: Chemin du fichier ou du dossier dans le dépôt. Par défaut, le chemin relatif du fichier ou du dossier est utilisé.
Options :
--type, --repo-type [model|dataset|space|kernel]: le type de dépôt (model, dataset, space ou kernel). [défaut : (model)]--revision TEXT: identifiant de révision Git, qui peut être un nom de branche, un tag ou un hachage de commit.--private / --no-private: Indique s'il faut créer un dépôt privé si le dépôt n'existe pas sur le Hub. Ignoré si le dépôt existe déjà.--include TEXT: motifs glob pour correspondre aux fichiers à téléverser.--exclude TEXT: motifs glob à exclure des fichiers à téléverser.--delete TEXT: motifs glob des fichiers à supprimer du dépôt lors de l'engagement.--commit-message TEXT: le résumé / titre / première ligne du commit généré.--commit-description TEXT: La description du commit généré.--create-pr / --no-create-pr: Indique si le contenu doit être téléversé sous forme de nouvelle Pull Request. [défaut : no-create-pr]--every FLOAT: Si défini, une tâche en arrière-plan est planifiée pour créer des commits toutes leseveryminutes.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf upload my-cool-model . . $ hf upload Wauplin/my-cool-model ./models/model.safetensors $ hf upload Wauplin/my-cool-dataset ./data /train —repo-type=dataset $ hf upload Wauplin/my-cool-model ./models . —commit-message=“Epoch 34/50” —commit-description=“Val accuracy: 68%” $ hf upload bigcode/the-stack . . —repo-type dataset —create-pr
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf version
Affiche des informations sur la version de hf.
Utilisation :
$ hf version [OPTIONS]Options :
--help: Affiche ce message et quitte.
hf webhooks
Gérer les webhooks sur le Hub.
Utilisation :
$ hf webhooks [OPTIONS] COMMAND [ARGS]...Options :
--help: Affiche ce message et quitte.
Commandes :
create: Créer un nouveau webhook.delete: Supprimer définitivement un webhook.disable: Désactiver un webhook actif.enable: Activer un webhook désactivé.info: Affiche tous les détails d'un webhook unique.list: Liste tous les webhooks de l'utilisateur actuel. [alias : ls]update: Met à jour un webhook existant.
hf webhooks create
Créer un nouveau webhook.
Fournissez soit —url (pour envoyer une requête à un serveur distant), soit —job-id (pour déclencher un Job), mais pas les deux. Les secrets du Job source ne sont pas copiés vers le webhook : passez-les à nouveau avec —secrets / —secrets-file.
Utilisation :
$ hf webhooks create [OPTIONS]Options :
--watch TEXT: Élément à surveiller, au format « type:name » (par ex. « model:bert-base-uncased »). Répétable. [obligatoire]--url TEXT: URL à laquelle envoyer les charges utiles du webhook. Mutuellement exclusif avec —job-id.--job-id TEXT: ID d'un Job à déclencher (depuis job.id) au lieu de pinger une URL. Mutuellement exclusif avec —url.--domain [repo|discussion]: Domaine à surveiller : ‘repo’ ou ‘discussion’. Répétable. Par défaut, tous les domaines.--secret TEXT: secret facultatif utilisé pour signer les charges utiles des webhooks.-s, --secrets TEXT: Définit des variables d’environnement secrètes. Préférez--secrets SECRETpour lire la valeur depuis votre environnement (par ex.--secrets HF_TOKENpour transmettre votre jeton Hugging Face) ;--secrets SECRET=valueplace la valeur dans l’historique de votre shell.--secrets-file TEXT: Lit un fichier de variables d’environnement secrètes. Utilisez-pour les lire depuis l’entrée standard.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf webhooks create —url https://example.com/hook —watch model:bert-base-uncased $ hf webhooks create —url https://example.com/hook —watch org:HuggingFace —watch model:gpt2 —domain repo $ hf webhooks create —job-id 687f911eaea852de79c4a50a —watch user:julien-c $ hf webhooks create —job-id 687f911eaea852de79c4a50a —watch bucket:my-org/my-bucket —secrets HF_TOKEN
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf webhooks delete
Supprimer définitivement un webhook.
Utilisation :
$ hf webhooks delete [OPTIONS] WEBHOOK_IDArguments :
WEBHOOK_ID: l’identifiant du webhook à supprimer. [obligatoire]
Options :
-y, --yes: Ignore la demande de confirmation.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf webhooks delete abc123 $ hf webhooks delete abc123 —yes
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf webhooks disable
Désactiver un webhook actif.
Utilisation :
$ hf webhooks disable [OPTIONS] WEBHOOK_IDArguments :
WEBHOOK_ID: l'identifiant du webhook à désactiver. [obligatoire]
Options :
--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf webhooks disable abc123
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf webhooks enable
Activer un webhook désactivé.
Utilisation :
$ hf webhooks enable [OPTIONS] WEBHOOK_IDArguments :
WEBHOOK_ID: l’identifiant du webhook à activer. [obligatoire]
Options :
--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf webhooks enable abc123
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf webhooks info
Afficher tous les détails d'un webhook unique.
Utilisation :
$ hf webhooks info [OPTIONS] WEBHOOK_IDArguments :
WEBHOOK_ID: l'identifiant du webhook. [obligatoire]
Options :
--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $c hf webhooks info abc123$
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf webhooks list
Liste tous les webhooks de l'utilisateur actuel. [alias: ls]
Utilisation :
$ hf webhooks list [OPTIONS]Options :
--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf webhooks ls $ hf webhooks ls —format json $ hf webhooks ls —format quiet
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli
hf webhooks update
Mettre à jour un webhook existant. Seules les options fournies sont modifiées.
Les secrets de tâche passés avec —secrets remplacent les valeurs stockées portant le même nom ; les autres sont conservées.
Utilisation :
$ hf webhooks update [OPTIONS] WEBHOOK_IDArguments :
WEBHOOK_ID: l'identifiant du webhook à mettre à jour. [obligatoire]
Options :
--url TEXT: nouvelle URL vers laquelle envoyer les charges utiles du webhook.--job-id TEXT: ID du Job source à déclencher (peut être le Job actuel). Obligatoire avec —secrets / —secrets-file.--watch TEXT: Nouvelle liste d'éléments à surveiller, au format « type:name ». Répétable. Remplace l'ensemble de la liste de surveillance existante.--domain [repo|discussion]: nouvelle liste de domaines à surveiller : ‘repo’ ou ‘discussion’. Répétable.--secret TEXT: Nouveau secret utilisé pour signer les charges utiles des webhooks.-s, --secrets TEXT: Définit des variables d’environnement secrètes. Préférez--secrets SECRETpour lire la valeur depuis votre environnement (par ex.--secrets HF_TOKENpour transmettre votre jeton Hugging Face) ;--secrets SECRET=valueplace la valeur dans l’historique de votre shell.--secrets-file TEXT: Lit un fichier de variables d’environnement secrètes. Utilisez-pour les lire depuis l’entrée standard.--token TEXT: un jeton d'accès utilisateur généré depuis https://huggingface.co/settings/tokens.--help: Affiche ce message et quitte.
Exemples $ hf webhooks update abc123 —url https://new-url.com/hook $ hf webhooks update abc123 —watch model:gpt2 —domain repo $ hf webhooks update abc123 —secret newsecret $ hf webhooks update abc123 —job-id 687f911eaea852de79c4a50a —secrets HF_TOKEN
En savoir plus
Utilisez hf <command> --help pour plus d'informations sur une commande.
Consultez la documentation sur https://huggingface.co/docs/huggingface_hub/en/guides/cli