Guide pratique pour installer l’outil CLI ML.NET
Découvrez comment installer l’interface de ligne de commande (CLI) ML.NET sur Windows, Mac ou Linux.
L’interface CLI ML.NET génère des modèles ML.NET et du code source de bonne qualité à l’aide du Machine Learning automatisé (AutoML) et d’un jeu de données d’entraînement.
Remarque
Cet article fait référence à l’interface CLI ML.NET et à AutoML ML.NET qui sont actuellement en préversion et peuvent donc faire l’objet de modifications.
Conditions préalables
(Facultatif) Visual Studio 2022
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 (CLI .NET).
Remarque : Si après l’installation du Kit de développement logiciel (SDK) .NET, la commande dotnet tool ne fonctionne pas, déconnectez-vous de Windows et reconnectez-vous.
Installer
L’interface CLI ML.NET est installée comme tout autre outil global dotnet. Vous utilisez la commande CLI .NET dotnet tool install --global.
L’interface CLI ML.NET est disponible pour Windows, macOS et Linux. Selon l’architecture de votre processeur, choisissez la version x64 ou ARM.
Notes
Les versions 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 dans le flux NuGet par défaut), des messages d’erreur sont affichés. Assurez-vous que les flux attendus sont vérifiés.
Si l’installation réussit, un message s’affiche indiquant 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 les ARCH dans ce cas doivent correspondre aux valeurs pour l’architecture du système d’exploitation et le processeur que vous avez sélectionnés lors de l’installation de l’interface CLI ML.NET.
Vous pouvez vérifier que l’installation a réussi en tapant la commande suivante :
mlnet
Vous devez voir l’aide des commandes disponibles pour l’outil mlnet, telles que la commande « classification ».
Important
Si vous travaillez sur 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 les autorisations d’exécution pour mlnet et inclure mlnet dans le chemin d’accès système. En général, pour cela, utilisez la commande suivante :
chmod +x <PATH-TO-MLNET-CLI-EXECUTABLE>
Des instructions plus détaillées sur la façon de procéder devraient 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 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 de la CLI
Pour désinstaller le ML.NET CLI, utilisez l’ID de package que vous pouvez obtenir en exécutant la commande dotnet tool list --global. Utilisez ensuite la commande dotnet tool uninstall --global.
x64
dotnet tool uninstall --global mlnet-win-x64
ARM
dotnet tool uninstall --global mlnet-win-arm64
Mettre à jour le package de la 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 commande dotnet tool list --global. Utilisez ensuite la commande dotnet tool update --global.
x64
dotnet tool update --global mlnet-win-x64
ARM
dotnet tool update --global mlnet-win-arm64
Répertoire d’installation
Il est possible d’installer la CLI ML.NET dans le répertoire par défaut ou à un emplacement spécifique. Les répertoires par défaut sont :
| Système d''exploitation | Chemin d’accès |
|---|---|
| Linux/mac OS | $HOME/.dotnet/tools |
| Windows | %USERPROFILE%\.dotnet\tools |
Ces emplacements sont ajoutés au chemin de l’utilisateur lors de la première exécution du SDK, si bien que les outils globaux qui y sont installés peuvent être appelées directement.
Remarque : Les outils globaux sont propres à l’utilisateur, et non globaux pour la machine. Le fait d’être propre à l’utilisateur signifie que vous ne pouvez pas installer un outil global disponible pour tous les utilisateurs de la machine. L’outil est uniquement disponible pour chaque profil utilisateur dans lequel l’outil a été installé.
Les outils globaux peuvent également être installés dans un répertoire spécifique. Lors d’une installation dans un répertoire spécifique, l’utilisateur doit vérifier que la commande est disponible, en incluant ce répertoire dans le chemin, en appelant la commande avec le répertoire spécifié, ou en appelant l’outil à partir du répertoire spécifié. Dans ce cas, CLI .NET n’ajoute pas automatiquement cet emplacement à la variable d’environnement PATH.
