Come installare lo strumento dell'interfaccia della riga di comando (CLI) di ML.NET

  • Articolo

Informazioni su come installare l'interfaccia della riga di comando di ML.NET in Windows, Mac o Linux.

L'interfaccia della riga di comando di ML.NET genera modelli di ML.NET di qualità e codice sorgente usando Machine Learning automatizzato (AutoML) e un set di dati di training.

Nota

Questo articolo fa riferimento all'interfaccia della riga di comando ML.NET e alla funzionalità di Machine Learning automatico ML.NET attualmente in anteprima e il materiale può essere soggetto a modifiche.

Prerequisiti

È possibile eseguire i progetti di codice C# generati con Visual Studio premendo F5 o con dotnet run (interfaccia della riga di comando .NET).

Nota: se dopo l'installazione di .NET SDK il comando dotnet tool non funziona, disconnettersi da Windows e accedere di nuovo.

Installare

L'interfaccia della riga di comando di ML.NET viene installata come gli altri strumenti globali dotnet. Usare il comando dell'interfaccia della riga di comando di .NET dotnet tool install --global.

L'interfaccia della riga di comando ML.NET è disponibile per Windows, macOS e Linux. A seconda dell'architettura del processore, scegliere la versione x64 o ARM.

Nota

Le versioni basate su ARM dell'interfaccia della riga di comando di ML.NET non supportano scenari di classificazione delle immagini.

x64

dotnet tool install --global mlnet-win-x64

ARM

dotnet tool install --global mlnet-win-arm64

Se lo strumento non può essere installato (ovvero, se non è disponibile nel feed NuGet predefinito), vengono visualizzati i messaggi di errore. Verificare che i feed previsti vengano controllati.

Se l'installazione ha esito positivo, viene visualizzato un messaggio che mostra il comando usato per chiamare lo strumento e la versione installata, simile all'esempio seguente:

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

OS e ARCH in questo caso devono corrispondere ai valori per il sistema operativo e l'architettura del processore selezionati durante l'installazione dell'interfaccia della riga di comando di ML.NET.

È possibile verificare che l'installazione sia avvenuta correttamente digitando il comando seguente:

mlnet

Verrà visualizzata la Guida per i comandi disponibili per lo strumento mlnet, ad esempio il comando 'classification'.

Importante

Se si esegue Linux o macOS e si usa una console diversa da Bash (ad esempio, zsh, che è il nuovo valore predefinito per macOS), sarà necessario assegnare autorizzazioni eseguibili mlnet e includere mlnet al percorso di sistema. In generale, è possibile farlo con il comando seguente:

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

Le istruzioni più dettagliate su come eseguire questa operazione dovrebbero essere visualizzate nel terminale quando si installa mlnet (o qualsiasi strumento globale).

In alternativa, è possibile provare a usare il comando seguente per eseguire lo strumento mlnet:

~/.dotnet/tools/mlnet

Installare una versione specifica

Se si sta tentando di installare una versione non definitiva o una versione specifica dello strumento, è possibile specificare il sistema operativo, l'architettura del processore e il framework usando il formato seguente:

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

È anche possibile verificare se il pacchetto è installato correttamente digitando il comando seguente:

dotnet tool list -g

Disinstallare il pacchetto dell'interfaccia della riga di comando

Per disinstallare l'interfaccia della riga di comando di ML.NET usare l'ID pacchetto che è possibile ottenere dall'esecuzione del comando dotnet tool list --global. Usare quindi il comando dotnet tool uninstall --global.

x64

dotnet tool uninstall --global mlnet-win-x64

ARM

dotnet tool uninstall --global mlnet-win-arm64

Aggiornare il pacchetto dell'interfaccia della riga di comando

Per aggiornare l'interfaccia della riga di comando di ML.NET usare l'ID pacchetto che è possibile ottenere eseguendo il comando dotnet tool list --global. Usare quindi il comando dotnet tool update --global.

x64

dotnet tool update --global mlnet-win-x64

ARM

dotnet tool update --global mlnet-win-arm64

Directory di installazione

L'interfaccia della riga di comando di ML.NET può essere installata nella directory predefinita o in un percorso specifico. Le directory predefinite sono:

Sistema operativo Percorso
Linux/macOS $HOME/.dotnet/tools
Windows %USERPROFILE%\.dotnet\tools

Questi percorsi vengono aggiunti al percorso dell'utente alla prima esecuzione dell'SDK in modo che gli strumenti globali installati possano essere chiamati direttamente.

Nota: gli strumenti globali sono specifici dell'utente e non globali del computer. Per questa ragione non è possibile installare uno strumento globale disponibile per tutti gli utenti del computer. Lo strumento è disponibile solo per i singoli profili utente in cui è stato installato.

Gli strumenti globali possono anche essere installati in una directory specifica. Quando vengono installati in una directory specifica, l'utente deve verificare che il comando sia disponibile includendo la directory nel percorso, chiamando il comando con la directory specificata chiamando lo strumento dall'interno della directory specificata. In questo caso, l'interfaccia della riga di comando di .NET non aggiunge automaticamente questa posizione alla variabile di ambiente PATH.

Vedi anche