Como instalar a ferramenta da CLI (Interface de Linha de Comando) do ML.NET
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
(Opcional) Visual Studio 2022
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.
