Postup instalace nástroje rozhraní příkazového řádku (CLI) ML.NET

  • Článek

Zjistěte, jak nainstalovat rozhraní příkazového řádku ML.NET (rozhraní příkazového řádku) ve Windows, Macu nebo Linuxu.

Rozhraní příkazového řádku ML.NET generuje kvalitní modely ML.NET a zdrojový kód pomocí automatizovaného strojového učení (AutoML) a trénovací datové sady.

Poznámka:

Tento článek se týká ML.NET rozhraní příkazového řádku a ML.NET AutoML, které jsou aktuálně ve verzi Preview, a materiál se může změnit.

Požadavky

Vygenerované projekty kódu jazyka C# můžete spustit pomocí sady Visual Studio stisknutím klávesy F5 nebo pomocí dotnet run rozhraní příkazového řádku (.NET CLI).

Poznámka: Pokud po instalaci sady .NET SDK dotnet tool příkaz nefunguje, odhlaste se z Windows a znovu se přihlaste.

Instalace

Rozhraní příkazového řádku ML.NET je nainstalované stejně jako jakýkoli jiný globální nástroj dotnet. Použijete dotnet tool install --global příkaz .NET CLI.

Rozhraní příkazového řádku ML.NET je k dispozici pro Windows, macOS a Linux. V závislosti na architektuře procesoru zvolte verzi x64 nebo ARM.

Poznámka:

Verze rozhraní příkazového řádku založené na ARM ML.NET nepodporují scénáře klasifikace obrázků.

x64

dotnet tool install --global mlnet-win-x64

ARM

dotnet tool install --global mlnet-win-arm64

Pokud nástroj nejde nainstalovat (to znamená, že pokud není dostupný ve výchozím informačním kanálu NuGet), zobrazí se chybové zprávy. Zkontrolujte, jestli se kontrolují očekávané informační kanály.

Pokud instalace proběhne úspěšně, zobrazí se zpráva s příkazem použitým k volání nástroje a nainstalované verze, podobně jako v následujícím příkladu:

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

ARCH V OS tomto případě by se měly shodovat s hodnotami pro architekturu operačního systému a procesoru, kterou jste vybrali při instalaci ML.NET rozhraní příkazového řádku.

Úspěšné instalace můžete ověřit zadáním následujícího příkazu:

mlnet

Měli byste vidět nápovědu k dostupným příkazům pro nástroj mlnet, jako je například příkaz "classification".

Důležité

Pokud používáte Linux nebo macOS a používáte jinou konzolu než Bash (například zsh, což je nové výchozí nastavení pro macOS), budete muset udělit mlnet spustitelná oprávnění a zahrnout mlnet do systémové cesty. Obecně to můžete provést pomocí následujícího příkazu:

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

Podrobnější pokyny k tomu, jak to udělat, by se měly v terminálu objevit při instalaci mlnet (nebo v jakémkoli globálním nástroji).

Případně můžete zkusit spustit nástroj mlnet pomocí následujícího příkazu:

~/.dotnet/tools/mlnet

Instalace konkrétní verze

Pokud se pokoušíte nainstalovat předběžnou verzi nebo konkrétní verzi nástroje, můžete zadat operační systém, architekturu procesoru a architekturu pomocí následujícího formátu:

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

Pokud chcete zkontrolovat, jestli je balíček správně nainstalovaný, zadejte následující příkaz:

dotnet tool list -g

Odinstalace balíčku rozhraní příkazového řádku

K odinstalaci ML.NET ROZHRANÍ příkazového řádku použijte ID balíčku, které můžete získat ze spuštění dotnet tool list --global příkazu. Pak použijte dotnet tool uninstall --global příkaz.

x64

dotnet tool uninstall --global mlnet-win-x64

ARM

dotnet tool uninstall --global mlnet-win-arm64

Aktualizace balíčku rozhraní příkazového řádku

Pokud chcete aktualizovat ML.NET rozhraní příkazového řádku, použijte ID balíčku, které můžete získat ze spuštění dotnet tool list --global příkazu. Pak použijte dotnet tool update --global příkaz.

x64

dotnet tool update --global mlnet-win-x64

ARM

dotnet tool update --global mlnet-win-arm64

Instalační adresář

Rozhraní příkazového řádku ML.NET lze nainstalovat ve výchozím adresáři nebo v určitém umístění. Výchozí adresáře jsou:

Operační systém Cesta
Linux/macOS $HOME/.dotnet/tools
Windows %USERPROFILE%\.dotnet\tools

Tato umístění se při prvním spuštění sady SDK přidají do cesty uživatele, takže globální nástroje nainstalované tam mohou být volána přímo.

Poznámka: Globální nástroje jsou specifické pro uživatele, nikoli globální počítače. Uživatel-specifická znamená, že nemůžete nainstalovat globální nástroj, který je k dispozici pro všechny uživatele počítače. Nástroj je k dispozici pouze pro každý profil uživatele, ve kterém byl nástroj nainstalován.

Globální nástroje je možné nainstalovat také do konkrétního adresáře. Při instalaci do konkrétního adresáře musí uživatel zajistit, aby byl příkaz k dispozici, zahrnutím daného adresáře do cesty, voláním příkazu se zadaným adresářem nebo voláním nástroje z zadaného adresáře. V takovém případě rozhraní příkazového řádku .NET nepřidá toto umístění automaticky do proměnné prostředí PATH.

Viz také