Partager via

Comment installer l'outil de l'interface de ligne de commande ML.NET (CLI)

Découvrez comment installer l’interface CLI ML.NET (interface de ligne de commande) sur Windows, Mac ou Linux.

La CLI de ML.NET génère de bons modèles ML.NET et du code source à l'aide de l'apprentissage automatique (AutoML) et d'un jeu de données d’entraînement.

Note

Cet article fait référence à ML.NET CLI et ML.NET AutoML, qui sont actuellement en préversion, et le matériel est susceptible de changer.

Prerequisites

Vous pouvez exécuter les projets de code C# générés avec Visual Studio en appuyant sur la touche F5 ou avec dotnet run (.NET CLI).

Remarque : Si après l’installation du Kit de développement logiciel (SDK) .NET, la dotnet tool commande ne fonctionne pas, déconnectez-vous de Windows et reconnectez-vous.

Installez

L’interface CLI ML.NET est installée comme n’importe quel autre outil global dotnet. Vous utilisez la dotnet tool install --global commande CLI .NET.

L’interface CLI ML.NET est disponible pour Windows, macOS et Linux. Selon l’architecture de votre processeur, choisissez la version x64 ou ARM.

Note

Les versions basées sur ARM de l’interface CLI ML.NET ne prennent pas en charge les scénarios de classification d’images.

x64

dotnet tool install --global mlnet-win-x64

ARM

dotnet tool install --global mlnet-win-arm64

Si l’outil ne peut pas être installé (autrement dit, s’il n’est pas disponible au flux NuGet par défaut), les messages d’erreur sont affichés. Vérifiez que les flux attendus sont vérifiés.

Si l’installation réussit, un message s’affiche montrant la commande utilisée pour appeler l’outil et la version installée, comme dans l’exemple suivant :

You can invoke the tool using the following command: mlnet
Tool 'mlnet-<OS>-<ARCH>' (version 'X.X.X') was successfully installed.

Les OS et ARCH dans ce cas doivent correspondre aux valeurs de l'architecture du système d'exploitation et du processeur que vous avez sélectionnées lors de l'installation du CLI ML.NET.

Vous pouvez confirmer que l’installation a réussi en tapant la commande suivante :

mlnet

Vous devriez consulter l’aide pour les commandes disponibles de l’outil mlnet, telles que la commande 'classification'.

Important

Si vous exécutez Linux ou macOS et que vous utilisez une console autre que Bash (par exemple, zsh, qui est la nouvelle valeur par défaut pour macOS), vous devez accorder mlnet des autorisations exécutables et inclure mlnet le chemin d’accès système. En général, vous pouvez le faire avec la commande suivante :

chmod +x <PATH-TO-MLNET-CLI-EXECUTABLE>

Des instructions plus détaillées sur la façon de procéder doivent apparaître dans le terminal lorsque vous installez mlnet (ou tout outil global).

Vous pouvez également essayer d’utiliser la commande suivante pour exécuter l’outil mlnet :

~/.dotnet/tools/mlnet

Installer une version spécifique

Si vous essayez d’installer une version préliminaire ou une version spécifique de l’outil, vous pouvez spécifier le système d’exploitation, l’architecture du processeur et l’infrastructure au format suivant :

dotnet tool install -g mlnet-<OS>-<ARCH> --framework <FRAMEWORK>

Vous pouvez également vérifier si le package est correctement installé en tapant la commande suivante :

dotnet tool list -g

Désinstaller le package CLI

Pour désinstaller l’interface CLI ML.NET utilisez l’ID de package que vous pouvez obtenir à partir de l’exécution de la dotnet tool list --global commande. Utilisez ensuite la dotnet tool uninstall --global commande.

x64

dotnet tool uninstall --global mlnet-win-x64

ARM

dotnet tool uninstall --global mlnet-win-arm64

Mettre à jour le package CLI

Pour mettre à jour l’interface CLI ML.NET utilisez l’ID de package que vous pouvez obtenir à partir de l’exécution de la dotnet tool list --global commande. Utilisez ensuite la dotnet tool update --global commande.

x64

dotnet tool update --global mlnet-win-x64

ARM

dotnet tool update --global mlnet-win-arm64

Répertoire d’installation

L’interface CLI ML.NET peut être installée dans le répertoire par défaut ou dans un emplacement spécifique. Les répertoires par défaut sont les suivants :

Système d'exploitation Chemin
Linux/macOS $HOME/.dotnet/tools
Fenêtres %USERPROFILE%\.dotnet\tools

Ces emplacements sont ajoutés au chemin d’accès de l’utilisateur lorsque le Kit de développement logiciel (SDK) est exécuté pour la première fois. Les outils globaux installés peuvent donc être appelés directement.

Remarque : les outils globaux sont spécifiques à l’utilisateur, et non à l’ordinateur global. Étant spécifique à l’utilisateur, vous ne pouvez pas installer un outil global disponible pour tous les utilisateurs de l’ordinateur. L’outil est disponible uniquement pour chaque profil utilisateur où l’outil a été installé.

Les outils globaux peuvent également être installés dans un répertoire spécifique. Lorsqu’il est installé dans un répertoire spécifique, l’utilisateur doit s’assurer que la commande est disponible, en incluant ce répertoire dans le chemin d’accès, en appelant la commande avec le répertoire spécifié ou en appelant l’outil à partir du répertoire spécifié. Dans ce cas, l’interface CLI .NET n’ajoute pas cet emplacement automatiquement à la variable d’environnement PATH.

Voir aussi

  • Last updated on