Como instalar a ferramenta ML.NET Command-Line Interface (CLI)
Saiba como instalar a CLI (interface de linha de comando) do ML.NET no Windows, Mac ou Linux.
A CLI ML.NET gera modelos de ML.NET de boa qualidade e código-fonte usando aprendizado de máquina automatizado (AutoML) e um conjunto de dados de treinamento.
Nota
Este artigo refere-se a ML.NET CLI e ML.NET AutoML, que estão atualmente em Visualização, 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 com dotnet run (.NET CLI).
Nota: Se depois de instalar o SDK do .NET o dotnet tool comando não estiver funcionando, saia do Windows e entre novamente.
Instalar
A CLI ML.NET é instalada como qualquer outra ferramenta global dotnet. Use o dotnet tool install --global comando .NET CLI.
A ML.NET CLI está disponível para Windows, macOS e Linux. Dependendo da arquitetura do processador, escolha a versão x64 ou ARM.
Nota
As versões baseadas em ARM da CLI do ML.NET não suportam 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 não estiver disponível no feed padrão do NuGet), serão exibidas mensagens de erro. Verifique se os feeds esperados estão a ser 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.
O OS e ARCH neste caso deve corresponder aos valores para o sistema operacional e arquitetura do processador que você selecionou ao instalar o ML.NET CLI.
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 você estiver executando Linux ou macOS e usando um console diferente do Bash (por exemplo, zsh, que é o novo padrão para macOS), precisará dar 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 de lançamento 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
Desinstale o pacote da CLI
Para desinstalar a CLI do ML.NET, use a ID do pacote que você pode obter executando 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 executando o 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 ML.NET CLI pode ser instalada no diretório padrão ou em um local específico. Os diretórios padrão são:
| SO | 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.
Nota: as Ferramentas Globais são específicas do utilizador, não globais da máquina. 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 da máquina. A ferramenta só está disponível para cada perfil de usuário onde 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.
