Sdílet prostřednictvím

Postup instalace nástroje ML.NET Command-Line Interface (CLI)

  • Č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í (.NET CLI).

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

Nainstalovat

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

PAŽE

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.

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

Ú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ým oprávněním a zahrnout mlnet systémové cestě. 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 zobrazit v terminálu při instalaci mlnet (nebo jakéhokoli globálního nástroje).

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 následujícím formátem:

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

Odinstalujte balíček rozhraní příkazového řádku

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

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 spuštěním příkazu dotnet tool list --global. Pak použijte příkaz dotnet tool update --global.

x64

dotnet tool update --global mlnet-win-x64

PAŽE

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 tam nainstalované mohou být volány přímo.

Poznámka: Globální nástroje jsou specifické pro uživatele, nikoli pro celosystémové použití. Být uživatelsky 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é