Installieren des ML.NET-Befehlszeilenschnittstellen-Tools (CLI)

  • Artikel

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

Die ML.NET-CLI generiert qualitativ hochwertige ML.NET-Modelle und Quellcode mithilfe von automatisiertem Machine Learning (AutoML) und einem Trainingsdataset.

Hinweis

Dieser Artikel bezieht sich auf die ML.NET-CLI und ML.NET AutoML, die derzeit als Vorschauversion verfügbar sind. Änderungen sind vorbehalten.

Voraussetzungen

Sie können die generierten C#-Codeprojekte mit Visual Studio durch Drücken der Taste F5 oder mit dem Befehl dotnet run (.NET-CLI) ausführen.

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

Installieren

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

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 im standardmäßigen NuGet-Feed nicht verfügbar ist), werden Fehlermeldungen angezeigt. Stellen Sie sicher, dass die erwarteten Feeds überprüft werden.

Wenn die Installation erfolgreich abgeschlossen wurde, wird eine Meldung angezeigt, die den Befehl zum Aufrufen des Tools und die installierte Version ähnlich wie im folgenden Beispiel anzeigt:

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

OS und ARCH sollten in diesem Fall mit den Werten für die Betriebssystem- und Prozessorarchitektur übereinstimmen, die Sie bei der Installation der ML.NET-CLI ausgewählt haben.

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

mlnet

Es sollte die Hilfe zu den verfügbaren Befehlen für das ML.NET-Tool angezeigt werden, z. B. der Befehl „classification“.

Wichtig

Wenn Sie Linux oder macOS ausführen und eine andere Konsole als Bash verwenden (z. B. zsh, die neue Standardeinstellung für macOS), müssen Sie mlnet Ausführungsberechtigungen erteilen und mlnet in den Systempfad einschließen. Im Allgemeinen können Sie dazu folgenden Befehl verwenden:

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

Ausführlichere Anweisungen dazu sollten im Terminal angezeigt werden, wenn Sie mlnet (oder ein globales Tool) installieren.

Alternativ können Sie versuchen, das mlnet-Tool mit dem folgenden Befehl auszuführen:

~/.dotnet/tools/mlnet

Installieren einer bestimmten Releaseversion

Wenn Sie versuchen, eine Vorabversion oder eine spezifische Version des Tools zu installieren, können Sie Betriebssystem,Prozessorarchitektur und Framework im 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

Verwenden Sie zum Deinstallieren der ML.NET-CLI die Paket-ID, die Sie beim Ausführen des dotnet tool list --global-Befehls abrufen können. Verwenden Sie dann den Befehl dotnet tool uninstall --global.

x64

dotnet tool uninstall --global mlnet-win-x64

ARM

dotnet tool uninstall --global mlnet-win-arm64

Aktualisieren des CLI-Pakets

Verwenden Sie zum Aktualisieren der ML.NET-CLI die Paket-ID, die Sie beim Ausführen des dotnet tool list --global-Befehls abrufen können. Verwenden Sie dann den Befehl dotnet tool update --global.

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 spezifischen Speicherort installiert werden. Die Standardverzeichnisse sind:

Betriebssystem Path
Linux/macOS $HOME/.dotnet/tools
Windows %USERPROFILE%\.dotnet\tools

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

Beachten Sie, dass die globalen Tools benutzerspezifisch gespeichert werden und nicht global auf dem Computer. Deshalb können Sie kein globales Tool installieren, das für alle Benutzer auf dem Computer verfügbar ist. Das Tool ist nur für jedes Benutzerprofil verfügbar, auf denen das Tool installiert wurde.

Globale Tools können auch in einem spezifischen Verzeichnis installiert werden. Wenn sie in einem spezifischen Verzeichnis installiert werden, muss der Benutzer sicherstellen, dass der Befehl verfügbar ist, indem das Verzeichnis in den Pfad eingefügt, der Befehl mit dem angegebenen Verzeichnis aufgerufen oder das Tool aus dem angegebenen Verzeichnis aufgerufen wird. In diesem Fall fügt die .NET-CLI diesen Speicherort nicht automatisch der Umgebungsvariable „PATH“ hinzu.

Siehe auch