如何安装 ML.NET 命令行接口 (CLI) 工具

  • 项目

了解如何在 Windows、Mac 或 Linux 上安装 ML.NET CLI（命令行接口）。

ML.NET CLI 使用自动化机器学习 (AutoML) 和训练数据集生成质量良好的 ML.NET 模型和源代码。

注意

本文涉及目前处于预览状态的 ML.NET CLI 和 ML.NET AutoML，且材料可能会有所变化。

先决条件

可以使用 Visual Studio 按 F5 键或 dotnet run (.NET CLI) 运行生成的 C# 代码项目。

注意：如果在安装 .NET SDK 后，dotnet tool 命令不起作用，请从 Windows 注销并再次登录。

安装

ML.NET CLI 的安装方式与任何其他 dotnet 全局工具一样。 使用 dotnet tool install --global .NET CLI 命令。

ML.NET CLI 适用于 Windows、macOS 和 Linux。 根据处理器体系结构，选择 x64 或 ARM 版本。

注意

基于 ARM 的 ML.NET CLI 版本不支持图像分类方案。

X64

dotnet tool install --global mlnet-win-x64

ARM

dotnet tool install --global mlnet-win-arm64

如果无法安装该工具（即，如果它在默认 NuGet 源中不可用），则会显示错误消息。 检查所需源是否正在被检查。

如果安装成功，会出现一条消息，显示用于调用工具的命令以及所安装的版本，类似于以下示例：

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

在这种情况下，OS 和 ARCH 应与安装 ML.NET CLI 时选择的操作系统和处理器体系结构的值匹配。

可以通过键入以下命令来确认安装是否成功：

mlnet

应看到 mlnet 工具的可用命令帮助，例如“classification”命令。

重要

如果你运行的是 Linux 或 macOS，并且使用的控制台不是 Bash（例如 zsh，这是 macOS 的新默认值），需要授予 mlnet 可执行文件权限并将 mlnet 包含到系统路径中。 通常可使用以下命令实现此目的：

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

在安装 mlnet（或任何全局工具）时，应该会在终端中显示如何执行此操作的更详细的说明。

或者，可以尝试使用以下命令运行 mlnet 工具：

~/.dotnet/tools/mlnet

安装特定版本

如果想安装工具的预发布版本或特定版本，可以采用以下格式指定 OS、处理器体系结构和框架：

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

还可以通过键入以下命令来检查包是否已正确安装：

dotnet tool list -g

卸载 CLI 包

若要卸载 ML.NET CLI，请使用可通过运行 dotnet tool list --global 命令获取的包 ID。 然后使用 dotnet tool uninstall --global 命令。

X64

dotnet tool uninstall --global mlnet-win-x64

ARM

dotnet tool uninstall --global mlnet-win-arm64

更新 CLI 包

若要更新 ML.NET CLI，请使用可通过运行 dotnet tool list --global 命令获取的包 ID。 然后使用 dotnet tool update --global 命令。

X64

dotnet tool update --global mlnet-win-x64

ARM

dotnet tool update --global mlnet-win-arm64

安装目录

ML.NET CLI 可安装在默认目录或特定位置。 默认目录为：

(OS) 路径
Linux/macOS $HOME/.dotnet/tools
Windows %USERPROFILE%\.dotnet\tools

这些位置在首次运行 SDK 时添加到用户的路径，所以可以直接调用安装在这里的全局工具。

注意：全局工具特定于用户，而不针对计算机全局。 特定于用户的意思是无法在一台计算机上安装所有用户都可用的全局工具。 只有安装了该工具的用户配置文件才能使用它。

也可在特定目录安装全局工具。 如果在特定目录安装全局工具，用户必须确保命令是可用的，方法是将该目录添加至路径、使用指定目录调用命令或从特定目录调用该工具。 在这种情况下，.NET CLI 不将此地址自动添加至 PATH 环境变量。

请参阅