hf CLI : une CLI Hugging Face plus rapide et plus conviviale avec Jobs

Vue d’ensemble

Hugging Face a officiellement renommé l’interface en ligne de commande de huggingface-cli en hf. Le but est d’améliorer l’ergonomie et la clarté en réorganisant les commandes selon une structure pilotée par les ressources. Le nouveau modèle est hf , avec des commandes racines comme hf upload et hf download parmi les plus utilisées. Le CLI est conçu pour être prévisible et facile à découvrir, préparant le terrain pour de futures fonctionnalités tout en conservant la compatibilité avec le huggingface-cli hérité pour faciliter la transition. L’un des moteurs du changement est de simplifier l’accès aux fonctionnalités à mesure que de nouvelles capacités sont ajoutées (upload, download, gestion du cache, gestion des dépôts, etc.). Une addition notable est la commande dédiée pour Hugging Face Jobs. Jobs vous permet d’exécuter des scripts ou des images Docker sur l’infrastructure de Hugging Face en utilisant le matériel de votre choix. La tarification de Jobs est au usage, et l’accès est limité aux utilisateurs Pro et aux organisations Team ou Enterprise. Le CLI s’inspire fortement du style Docker pour être familier aux développeurs. Pour commencer, vous devez installer la dernière version de huggingface_hub, redémarrer votre terminal et tester des commandes de base comme hf version et hf —help. Si vous avez utilisé huggingface-cli, la plupart des commandes vous paraîtront familières, mais la nouvelle organisation rend l’authentification et d’autres tâches courantes plus cohérentes. Pour voir comment le CLI est organisé, pensez en termes de groupes de ressources comme hf auth, hf cache, hf repo, etc., avec l’exception importante que hf upload et hf download sont exposés à la racine pour un accès rapide.

Fonctionnalités clés

hf remplace huggingface-cli par une interface plus rapide et plus ergonomique.
Les commandes suivent le motif prévisible : hf .
Des commandes racines pour les actions les plus utilisées, notamment hf upload et hf download.
Des groupes de commandes comme hf auth, hf cache, hf repo organisent les fonctionnalités par ressource.
Le cli legacy reste actif et pleinement fonctionnel pour faciliter la migration, avec un avertissement pointant vers les équivalents hf.
Une commande dédiée hf jobs permet d’exécuter des scripts ou des images Docker sur l’infrastructure HF.
Jobs est disponible uniquement pour les utilisateurs Pro et les organisations Team ou Enterprise, avec une tarification à l’usage.
Le design du CLI s’inspire de Docker, afin de favoriser la familiarité et l’apprentissage.
L’authentification a été repensée : toutes les commandes d’authentification sont regroupées sous hf auth, y compris hf auth list pour lister les profils locaux.
Après l’installation, rechargez votre terminal et vérifiez avec des commandes comme hf version et hf —help.

Remarque : si vous utilisiez le CLI hérité, vous verrez des avertissements vous orientant vers les équivalents hf.

Cas d’utilisation courants

S’authentifier avec plusieurs profils locaux via hf auth et hf auth list.
Gérer les caches locaux et les références de dépôts via hf cache et hf repo.
Envoyer ou récupérer rapidement des artefacts avec hf upload et hf download à la racine.
Explorer la nouvelle structure du CLI avec hf —help et approfondir n’importe quel groupe avec —help.
Lancer et gérer des Jobs sur l’infrastructure Hugging Face via hf jobs (sous conditions de plan).
Migrer progressivement depuis huggingface-cli en tolérant des avertissements et en adoptant progressivement la nouvelle syntaxe.

Installation & configuration

Pour commencer, installez la dernière version de huggingface_hub et rechargez votre session terminal. L’emplacement exact de la commande d’installation n’est pas fourni dans l’extrait, mais le guide conseille de mettre à jour huggingface_hub et de redémarrer le terminal avant de tester.

# commande d’installation exacte non fournie dans l’extrait

Après l’installation, testez l’installation :

hf version
hf --help

Vous pouvez aussi vérifier l’état de l’authentification et les profils :

hf auth list

Pour explorer Jobs :

hf jobs --help

Quick start (exemple minimal)

Installez la version la plus récente de huggingface_hub et redémarrez le terminal.
Vérifiez l’installation :

Exécutez hf version pour confirmer la disponibilité du CLI.
Exécutez hf —help pour voir la structure des commandes par ressource.

Listez les profils locaux avec hf auth list.
Utilisez les commandes racines pour les tâches courantes, comme upload ou download :

hf upload (commande racine)

Si vous êtes sur un plan Pro/Team/Enterprise, explorez Jobs avec hf jobs —help pour comprendre comment lancer des scripts ou des images Docker sur l’infrastructure HF. Note : les commandes exactes d’installation ne sont pas fournies dans l’extrait; suivez l’indication de mettre à jour huggingface_hub et de redémarrer le terminal pour commencer.

Avantages et inconvénients

Avantages :
CLI plus propre et prévisible avec la structure hf .
Commandes racines facilitant les tâches courantes.
Service Jobs dédié offre une exécution en nuage avec tarification à l’usage.
Le CLI hérité demeure disponible pour minimiser les interruptions lors de la migration.
Conception inspirée de Docker favorisant l’apprentissage rapide.
Inconvénients :
Les nouvelles fonctionnalités nécessitent la mise à jour vers la version la plus récente de huggingface_hub et peuvent introduire des avertissements de migration.
L’accès à Jobs est limité aux plans Pro et supérieurs, avec tarification à l’usage.
Pour les utilisateurs fortement dépendants de l’ancien layout, la migration peut nécessiter une adaptation.

Alternatives (comparaison brève)

| Aspects | huggingface-cli (hérité) | hf (nouveau) |---|---|---| | Modèle de commandes | commandes spécifiques par fonction | hf ; structure plus uniforme |Actions racines | pas clairement soulignées | hf upload et hf download exposés à la racine |Authentification | commandes d’authentification variées | authentification regroupée sous hf auth, hf auth list pour les profils locaux |Voie de migration | actif avec avertissements | le CLI hérité reste disponible pendant la transition |Jobs | non mis en avant | hf jobs pour exécuter des scripts/images sur l’infra HF |

Prix ou Licence

Jobs Hugging Face est disponible uniquement pour les utilisateurs Pro et les organisations Team ou Enterprise. La tarification des Jobs est pay-as-you-go, ce qui signifie que vous ne payez que pour les secondes d’usage.