Teilen über


So installieren Sie das Tool ML.NET Command-Line Interface (CLI)

Erfahren Sie, wie Sie die ML.NET CLI (Befehlszeilenschnittstelle) unter Windows, Mac oder Linux installieren.

Die ML.NET CLI generiert hochwertige ML.NET-Modelle und Quellcode mit automatisiertem maschinellem Lernen (AutoML) und einem Trainingsdatensatz.

Hinweis

Dieser Artikel bezieht sich auf ML.NET CLI und ML.NET AutoML, die sich derzeit in der Vorschau befinden, und Material kann geändert werden.

Voraussetzungen

Sie können die generierten C#-Codeprojekte mit Visual Studio ausführen, indem Sie F5 oder mit dotnet run (.NET CLI) drücken.

Hinweis: Wenn der Befehl nach der Installation von .NET SDK dotnet tool nicht funktioniert, melden Sie sich von Windows ab, und melden Sie sich erneut an.

Install

Die ML.NET CLI wird wie jedes andere dotnet Global Tool installiert. Sie verwenden den dotnet tool install --global .NET CLI-Befehl.

Die ML.NET CLI ist für Windows, macOS und Linux verfügbar. Wählen Sie je nach Prozessorarchitektur die x64- oder ARM-Version aus.

Hinweis

ARM-basierte Versionen der ML.NET CLI unterstützen keine Bildklassifizierungsszenarien.

x64

dotnet tool install --global mlnet-win-x64

ARM

dotnet tool install --global mlnet-win-arm64

Wenn das Tool nicht installiert werden kann (d. h., wenn es nicht im Standard-NuGet-Feed verfügbar ist), werden Fehlermeldungen angezeigt. Überprüfen Sie, ob die erwarteten Feeds überprüft werden.

Wenn die Installation erfolgreich ist, wird eine Meldung mit dem Befehl angezeigt, der zum Aufrufen des Tools und der installierten Version verwendet wird, ähnlich dem folgenden Beispiel:

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

In diesem Fall sollten OS und ARCH zu den Werten für die von Ihnen bei der Installation der ML.NET CLI ausgewählten Betriebssystem- und Prozessorarchitektur passen.

Sie können bestätigen, dass die Installation erfolgreich war, indem Sie den folgenden Befehl eingeben:

mlnet

Die Hilfe zu den verfügbaren Befehlen für das mlnet-Tool, z. B. den Befehl "Klassifizierung", sollte angezeigt werden.

Von Bedeutung

Wenn Sie Linux oder macOS verwenden und eine andere Konsole als Bash nutzen (z. B. zsh, das die neue Standardeinstellung für macOS ist), müssen Sie für mlnet ausführbare Berechtigungen erteilen und mlnet in den Systempfad aufnehmen. Im Allgemeinen können Sie dies mit dem folgenden Befehl tun:

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

Ausführlichere Anweisungen dazu sollten beim Installieren mlnet (oder eines globalen Tools) im Terminal angezeigt werden.

Alternativ können Sie versuchen, den folgenden Befehl zum Ausführen des mlnet-Tools zu verwenden:

~/.dotnet/tools/mlnet

Installieren einer bestimmten Release-Version

Wenn Sie versuchen, eine Vorabversion oder eine bestimmte Version des Tools zu installieren, können Sie das Betriebssystem, die Prozessorarchitektur und das Framework mit dem folgenden Format angeben:

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

Sie können auch überprüfen, ob das Paket ordnungsgemäß installiert ist, indem Sie den folgenden Befehl eingeben:

dotnet tool list -g

Deinstallieren des CLI-Pakets

Um die ML.NET CLI zu deinstallieren, verwenden Sie die Paket-ID, die Sie vom Ausführen des dotnet tool list --global Befehls abrufen können. Verwenden Sie dann den dotnet tool uninstall --global Befehl.

x64

dotnet tool uninstall --global mlnet-win-x64

ARM

dotnet tool uninstall --global mlnet-win-arm64

Aktualisieren des CLI-Pakets

Um die ML.NET CLI zu aktualisieren, verwenden Sie die Paket-ID, die Sie von der Ausführung des dotnet tool list --global Befehls abrufen können. Verwenden Sie dann den dotnet tool update --global Befehl.

x64

dotnet tool update --global mlnet-win-x64

ARM

dotnet tool update --global mlnet-win-arm64

Installationsverzeichnis

Die ML.NET CLI kann im Standardverzeichnis oder an einem bestimmten Speicherort installiert werden. Die Standardverzeichnisse sind:

OS Pfad
Linux/macOS $HOME/.dotnet/tools
Fenster %USERPROFILE%\.dotnet\tools

Diese Speicherorte werden dem Pfad des Benutzers hinzugefügt, wenn das SDK zum ersten Mal ausgeführt wird, sodass die dort installierten globalen Tools direkt aufgerufen werden können.

Hinweis: Die Globalen Tools sind benutzerspezifisch und nicht maschinenübergreifend global. Wenn Sie benutzerspezifisch sind, können Sie kein globales Tool installieren, das allen Benutzern des Computers zur Verfügung steht. Das Tool ist nur für jedes Benutzerprofil verfügbar, in dem das Tool installiert wurde.

Globale Tools können auch in einem bestimmten Verzeichnis installiert werden. Wenn er in einem bestimmten Verzeichnis installiert ist, muss der Benutzer sicherstellen, dass der Befehl verfügbar ist, indem er dieses Verzeichnis in den Pfad eingibt, indem er den Befehl mit dem angegebenen Verzeichnis aufruft oder das Tool aus dem angegebenen Verzeichnis aufruft. In diesem Fall fügt die .NET CLI diesen Speicherort nicht automatisch zur PATH-Umgebungsvariable hinzu.

Siehe auch