了解如何在 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) 通过 Visual Studio 运行生成的 C# 代码项目。
注意:如果在安装 .NET SDK dotnet tool 后命令不起作用,请从 Windows 注销并再次登录。
Install
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 可以安装在默认目录或特定位置。 默认目录为:
| 操作系统 | 路径 |
|---|---|
| Linux/macOS | $HOME/.dotnet/tools |
| Windows操作系统 | %USERPROFILE%\.dotnet\tools |
首次运行 SDK 时,这些位置将添加到用户的路径,因此可以直接调用已安装全局工具。
注意:全局工具是针对用户的,而不是针对整台计算机的。 特定于用户意味着无法安装可供计算机所有用户使用的全局工具。 该工具仅适用于安装该工具的每个用户配置文件。
全局工具也可以安装在特定目录中。 在特定目录中安装时,用户必须确保命令可用,方法是在路径中包含该目录、使用指定的目录调用命令或从指定目录中调用该工具。 在这种情况下,.NET CLI 不会自动将此位置添加到 PATH 环境变量。