Installieren des ML.NET-Befehlszeilenschnittstellen-Tools (CLI)
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
(Optional) Visual Studio 2022
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.
