Como instalar a ferramenta da CLI (Interface de Linha de Comando) do ML.NET

  • Artigo

Aprenda a instalar a CLI (interface de linha de comando) do ML.NET no Windows, no Mac ou no Linux.

A CLI do ML.NET gera modelos e código-fonte do ML.NET de boa qualidade usando autoML (machine learning automatizado) e um conjunto de dados de treinamento.

Observação

Este artigo refere-se à CLI do ML.NET e ao AutoML do ML.NET, que estão atualmente em versão prévia, e o material pode estar sujeito a alterações.

Pré-requisitos

Você pode executar os projetos de código C# gerados com o Visual Studio pressionando a tecla F5 ou usando dotnet run (CLI do .NET).

Observação: se, depois de instalar o SDK do .NET, o comando dotnet tool não estiver funcionando, saia do Windows e entre novamente.

Instalar

A CLI do ML.NET é instalada como qualquer outra Ferramenta Global do dotnet. Você usa o comando da CLI do .NET dotnet tool install --global.

A CLI do ML.NET está disponível para Windows, macOS e Linux. Dependendo da arquitetura do processador, escolha a versão x64 ou ARM.

Observação

As versões baseadas em ARM da CLI de ML.NET não dão suporte a cenários de classificação de imagem.

x64

dotnet tool install --global mlnet-win-x64

ARM

dotnet tool install --global mlnet-win-arm64

Se a ferramenta não puder ser instalada (ou seja, não estiver disponível no feed do NuGet padrão), mensagens de erro serão exibidas. Verifique se os feeds esperados estão sendo verificados.

Se a instalação for bem-sucedida, será exibida uma mensagem mostrando o comando usado para chamar a ferramenta e a versão instalada, de maneira semelhante ao seguinte exemplo:

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

OS eARCH, nesse caso, devem corresponder aos valores da arquitetura do sistema operacional e do processador que você selecionou ao instalar a CLI do ML.NET.

Você pode confirmar que a instalação foi bem-sucedida digitando o seguinte comando:

mlnet

Você deve ver a ajuda para os comandos disponíveis para a ferramenta mlnet, como o comando 'classification'.

Importante

Se estiver executando Linux ou macOS e usando um console que não seja o Bash (por exemplo, zsh, que é o novo padrão para macOS), você precisará fornecer permissões executáveis mlnet e incluir mlnet ao caminho do sistema. Em geral, você pode fazer isso com o seguinte comando:

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

Instruções mais detalhadas sobre como fazer isso devem aparecer no terminal quando você instala mlnet (ou qualquer ferramenta global).

Como alternativa, você pode tentar usar o seguinte comando para executar a ferramenta mlnet:

~/.dotnet/tools/mlnet

Instalar uma versão de liberação específica

Se você estiver tentando instalar uma versão de pré-lançamento ou uma versão específica da ferramenta, especifique o SO, a arquitetura do processador e a estrutura usando o seguinte formato:

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

Você também poderá verificar se o pacote está instalado corretamente digitando o seguinte comando:

dotnet tool list -g

Desinstalar o pacote da CLI

Para desinstalar a CLI do ML.NET, use a ID do pacote que você pode obter com a execução do comando dotnet tool list --global. Em seguida, use o comando dotnet tool uninstall --global.

x64

dotnet tool uninstall --global mlnet-win-x64

ARM

dotnet tool uninstall --global mlnet-win-arm64

Atualizar o pacote da CLI

Para atualizar a CLI do ML.NET, use a ID do pacote que você pode obter com a execução do comando dotnet tool list --global. Em seguida, use o comando dotnet tool update --global.

x64

dotnet tool update --global mlnet-win-x64

ARM

dotnet tool update --global mlnet-win-arm64

Diretório de instalação

A CLI do ML.NET pode ser instalada no diretório padrão ou em um local específico. Os diretórios padrão são:

Sistema operacional Caminho
Linux/macOS $HOME/.dotnet/tools
Windows %USERPROFILE%\.dotnet\tools

Esses locais são adicionados ao caminho do usuário quando o SDK é executado pela primeira vez e, portanto, as Ferramentas Globais instaladas nesses locais podem ser chamadas diretamente.

Observação: as Ferramentas Globais são específicas ao usuário e não globais no computador. Ser específico ao usuário significa que não é possível instalar uma Ferramenta Global que esteja disponível para todos os usuários do computador. A ferramenta só fica disponível para cada perfil de usuário no qual a ferramenta foi instalada.

As Ferramentas Globais também podem ser instaladas em um diretório específico. Quando elas forem instaladas em um diretório específico, o usuário precisará garantir que o comando esteja disponível, incluindo o diretório no caminho, chamando o comando com o diretório especificado ou chamando a ferramenta no diretório especificado. Nesse caso, a CLI do .NET não adiciona esse local automaticamente à variável de ambiente PATH.

Confira também