如何安裝 ML.NET 命令列介面 (CLI) 工具

  • 文章

了解如何在 Windows、Mac 或 Linux 上安裝 ML.NET CLI (命令列介面)。

ML.NET CLI 會使用自動化機器學習 (AutoML) 和定型資料集，產生高品質的 ML.NET 模型和原始程式碼。

注意

本文參考的是 ML.NET CLI 和 ML.NET AutoML，其目前為公開預覽版，因此内容可能會有變更。

必要條件

您可以透過按 F5 鍵或使用 dotnet run (.NET CLI) 來執行使用 Visual Studio 產生的 C# 程式碼專案。

附註：如果在安裝 .NET SDK 後，dotnet tool 命令無法運作，請登出 Windows，並再次登入。

安裝

ML.NET CLI 的安裝就像任何其他 dotnet 通用工具。 您會使用 dotnet tool install --global .NET CLI 命令。

目前提供適用於 Windows、macOS 及 Linux 的 ML.NET CLI。 根據您的處理器架構，選擇 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

安裝特定的發行版本

如果您要嘗試安裝發行前版本或特定版本的工具，可以使用下列格式指定作業系統、處理器架構以及架構：

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

您也可以鍵入下列命令，檢查套件是否正確安裝：

dotnet tool list -g

解除安裝 CLI 套件

若要解除安裝 ML.NET CLI，請使用您可以從執行 dotnet tool list --global 命令取得的套件識別碼。 然後，使用 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 命令取得的套件識別碼。 然後，使用 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 環境變數。

另請參閱