Jak zainstalować narzędzie interfejsu wiersza polecenia (CLI) ML.NET

  • Artykuł

Dowiedz się, jak zainstalować interfejs wiersza polecenia ML.NET (interfejs wiersza polecenia) w systemach Windows, Mac lub Linux.

Interfejs wiersza polecenia ML.NET generuje dobrą jakość modeli ML.NET i kodu źródłowego przy użyciu zautomatyzowanego uczenia maszynowego (AutoML) i zestawu danych szkoleniowych.

Uwaga

W tym artykule opisano interfejs wiersza polecenia ML.NET i ML.NET AutoML, które są obecnie dostępne w wersji zapoznawczej, a materiały mogą ulec zmianie.

Wymagania wstępne

Wygenerowane projekty kodu języka C# można uruchamiać w programie Visual Studio, naciskając klawisz F5 lub za dotnet run pomocą interfejsu wiersza polecenia (.NET CLI).

Uwaga: Jeśli po zainstalowaniu zestawu .NET SDK dotnet tool polecenie nie działa, wyloguj się z systemu Windows i zaloguj się ponownie.

Instalowanie

Interfejs wiersza polecenia ML.NET jest instalowany jak każde inne narzędzie dotnet Global Tool. Użyj polecenia interfejsu wiersza polecenia platformy dotnet tool install --global .NET.

Interfejs wiersza polecenia ML.NET jest dostępny dla systemów Windows, macOS i Linux. W zależności od architektury procesora wybierz wersję x64 lub ARM.

Uwaga

Wersje interfejsu wiersza polecenia ML.NET oparte na usłudze ARM nie obsługują scenariuszy klasyfikacji obrazów.

x64

dotnet tool install --global mlnet-win-x64

ARM

dotnet tool install --global mlnet-win-arm64

Jeśli nie można zainstalować narzędzia (czyli jeśli nie jest on dostępny w domyślnym kanale informacyjnym NuGet), są wyświetlane komunikaty o błędach. Sprawdź, czy oczekiwane kanały informacyjne są sprawdzane.

Jeśli instalacja zakończy się pomyślnie, zostanie wyświetlony komunikat z poleceniem używanym do wywołania narzędzia i zainstalowanej wersji, podobnie jak w poniższym przykładzie:

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

Element OS i ARCH w tym przypadku powinien być zgodny z wartościami architektury systemu operacyjnego i procesora wybranej podczas instalowania interfejsu wiersza polecenia ML.NET.

Możesz potwierdzić, że instalacja zakończyła się pomyślnie, wpisując następujące polecenie:

mlnet

Powinna zostać wyświetlona pomoc dotycząca dostępnych poleceń dla narzędzia mlnet, takiego jak polecenie "classification".

Ważne

Jeśli korzystasz z systemu Linux lub macOS i używasz konsoli innej niż powłoka Bash (na przykład zsh, która jest nową wartością domyślną dla systemu macOS), musisz przyznać mlnet uprawnienia wykonywalne i dołączyć mlnet ją do ścieżki systemowej. Ogólnie rzecz biorąc, można to zrobić za pomocą następującego polecenia:

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

Bardziej szczegółowe instrukcje dotyczące tego, jak to zrobić, powinny pojawić się w terminalu podczas instalacji mlnet (lub dowolnego narzędzia globalnego).

Alternatywnie możesz spróbować użyć następującego polecenia, aby uruchomić narzędzie mlnet:

~/.dotnet/tools/mlnet

Instalowanie określonej wersji

Jeśli próbujesz zainstalować wersję wstępną lub określoną wersję narzędzia, możesz określić system operacyjny, architekturę procesora i strukturę przy użyciu następującego formatu:

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

Możesz również sprawdzić, czy pakiet jest poprawnie zainstalowany, wpisując następujące polecenie:

dotnet tool list -g

Odinstalowywanie pakietu interfejsu wiersza polecenia

Aby odinstalować interfejs wiersza polecenia ML.NET, użyj identyfikatora pakietu, który można pobrać z uruchomienia dotnet tool list --global polecenia . Następnie użyj dotnet tool uninstall --global polecenia .

x64

dotnet tool uninstall --global mlnet-win-x64

ARM

dotnet tool uninstall --global mlnet-win-arm64

Aktualizowanie pakietu interfejsu wiersza polecenia

Aby zaktualizować interfejs wiersza polecenia ML.NET, użyj identyfikatora pakietu, który można pobrać z uruchomienia dotnet tool list --global polecenia . Następnie użyj dotnet tool update --global polecenia .

x64

dotnet tool update --global mlnet-win-x64

ARM

dotnet tool update --global mlnet-win-arm64

Katalog instalacyjny

Interfejs wiersza polecenia ML.NET można zainstalować w katalogu domyślnym lub w określonej lokalizacji. Katalogi domyślne to:

System operacyjny Ścieżka
Linux/macOS $HOME/.dotnet/tools
Windows %USERPROFILE%\.dotnet\tools

Te lokalizacje są dodawane do ścieżki użytkownika po pierwszym uruchomieniu zestawu SDK, dlatego zainstalowane narzędzia globalne mogą być wywoływane bezpośrednio.

Uwaga: narzędzia globalne są specyficzne dla użytkownika, a nie globalne maszyny. Bycie specyficznym dla użytkownika oznacza, że nie można zainstalować narzędzia globalnego dostępnego dla wszystkich użytkowników maszyny. Narzędzie jest dostępne tylko dla każdego profilu użytkownika, w którym zainstalowano narzędzie.

Narzędzia globalne można również zainstalować w określonym katalogu. Po zainstalowaniu w określonym katalogu użytkownik musi upewnić się, że polecenie jest dostępne, uwzględniając ten katalog w ścieżce, wywołując polecenie z określonym katalogiem lub wywołując narzędzie z określonego katalogu. W takim przypadku interfejs wiersza polecenia platformy .NET nie dodaje tej lokalizacji automatycznie do zmiennej środowiskowej PATH.

Zobacz też