Compartilhar via

Como instalar a ferramenta CLI (ML.NET Command-Line Interface)

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

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

Observação

Este artigo refere-se a ML.NET CLI e ML.NET AutoML, que estão atualmente em versão prévia, e o material está 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 com dotnet run a CLI (.NET).

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

Install

A CLI do ML.NET é instalada como qualquer outra ferramenta global dotnet. Use o comando CLI do dotnet tool install --global .NET.

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 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, se ela não estiver disponível no feed do NuGet padrão), as mensagens de erro serão exibidas. Verifique se os feeds esperados estão sendo verificados.

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

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

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

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

mlnet

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

Importante

Se você estiver executando Linux ou macOS e usando um console diferente do Bash (por exemplo, zsh, que é o novo padrão para macOS), será necessário conceder mlnet permissões executáveis e incluir mlnet no 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ê instalar 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 específica

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

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

Você também pode 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 ao executar o dotnet tool list --global comando. Em seguida, use o dotnet tool uninstall --global comando.

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 dotnet tool list --global comando. Em seguida, use o dotnet tool update --global comando.

x64

dotnet tool update --global mlnet-win-x64

ARM

dotnet tool update --global mlnet-win-arm64

Diretório de instalação

A CLI 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, portanto, as Ferramentas Globais instaladas lá podem ser chamadas diretamente.

Observação: as Ferramentas Globais são específicas do usuário, não do computador global. Ser específico do usuário significa que você não pode instalar uma Ferramenta Global que esteja disponível para todos os usuários do computador. A ferramenta só está disponível para cada perfil de usuário em que a ferramenta foi instalada.

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

Consulte também

  • Last updated on