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.
Observação
Este artigo refere-se ao ML.NET CLI e ML.NET AutoML, que estão atualmente em pré-visualização, e cujo material está 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 (CLI .NET).
Nota: 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 ML.NET é instalada como qualquer outra ferramenta global dotnet. Usa o comando dotnet tool install --global .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.
Observação
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
BRAÇO
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 o ARCH nesse caso devem corresponder aos valores do sistema operacional e da arquitetura do processador selecionados ao instalar a CLI ML.NET.
Você pode confirmar que a instalação foi bem-sucedida digitando o seguinte comando:
mlnet
Deve consultar a ajuda para os comandos disponíveis para a ferramenta mlnet, como o comando 'classificação'.
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ê instala o 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 comando dotnet tool list --global. Em seguida, use o comando dotnet tool uninstall --global.
x64
dotnet tool uninstall --global mlnet-win-x64
BRAÇO
dotnet tool uninstall --global mlnet-win-arm64
Atualizar o pacote da CLI
Para atualizar a CLI ML.NET, use a ID do pacote que você pode obter executando o comando dotnet tool list --global. Em seguida, use o comando dotnet tool update --global.
x64
dotnet tool update --global mlnet-win-x64
BRAÇO
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.
