Het hulpprogramma ML.NET Opdrachtregelinterface (CLI) installeren

  • Artikel

Meer informatie over het installeren van de ML.NET CLI (opdrachtregelinterface) op Windows, Mac of Linux.

De ML.NET CLI genereert goede kwaliteit ML.NET modellen en broncode met behulp van geautomatiseerde machine learning (AutoML) en een trainingsgegevensset.

Notitie

Dit artikel verwijst naar ML.NET CLI en ML.NET AutoML, die momenteel in preview zijn en materiaal kan worden gewijzigd.

Vereisten

U kunt de gegenereerde C#-codeprojecten uitvoeren met Visual Studio door op de F5-toets of met dotnet run (.NET CLI) te drukken.

Opmerking: Als de opdracht niet werkt nadat u dotnet tool .NET SDK hebt geïnstalleerd, meldt u zich af bij Windows en meldt u zich opnieuw aan.

Installeren

De ML.NET CLI is geïnstalleerd zoals elk ander dotnet Global Tool. U gebruikt de dotnet tool install --global .NET CLI-opdracht.

De ML.NET CLI is beschikbaar voor Windows, macOS en Linux. Afhankelijk van uw processorarchitectuur kiest u de x64- of ARM-versie.

Notitie

Op ARM gebaseerde versies van de ML.NET CLI bieden geen ondersteuning voor scenario's voor afbeeldingsclassificatie.

x64

dotnet tool install --global mlnet-win-x64

ARM

dotnet tool install --global mlnet-win-arm64

Als het hulpprogramma niet kan worden geïnstalleerd (dat wil gezegd, als het niet beschikbaar is in de standaard NuGet-feed), worden foutberichten weergegeven. Controleer of de feeds die u verwacht, worden gecontroleerd.

Als de installatie is geslaagd, wordt er een bericht weergegeven met de opdracht die wordt gebruikt om het hulpprogramma aan te roepen en de geïnstalleerde versie, vergelijkbaar met het volgende voorbeeld:

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

De OS en ARCH in dit geval moeten overeenkomen met de waarden voor het besturingssysteem en de processorarchitectuur die u hebt geselecteerd bij het installeren van de ML.NET CLI.

U kunt bevestigen dat de installatie is geslaagd door de volgende opdracht te typen:

mlnet

U ziet nu de Help voor beschikbare opdrachten voor het mlnet-hulpprogramma, zoals de opdracht Classificatie.

Belangrijk

Als u Linux of macOS gebruikt en een andere console dan Bash gebruikt (bijvoorbeeld zsh, de nieuwe standaardinstelling voor macOS), moet u uitvoerbare machtigingen verlenen mlnet en opnemen mlnet in het systeempad. Over het algemeen kunt u dit doen met de volgende opdracht:

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

Meer gedetailleerde instructies over hoe u dit kunt doen, moet worden weergegeven in de terminal wanneer u installeert mlnet (of een algemeen hulpprogramma).

U kunt ook de volgende opdracht gebruiken om het mlnet-hulpprogramma uit te voeren:

~/.dotnet/tools/mlnet

Een specifieke releaseversie installeren

Als u een voorlopige versie of een specifieke versie van het hulpprogramma probeert te installeren, kunt u het besturingssysteem, de processorarchitectuur en het framework opgeven met behulp van de volgende indeling:

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

U kunt ook controleren of het pakket juist is geïnstalleerd door de volgende opdracht te typen:

dotnet tool list -g

Het CLI-pakket verwijderen

Als u de ML.NET CLI wilt verwijderen, gebruikt u de pakket-id die u kunt ophalen door de opdracht uit te dotnet tool list --global voeren. Gebruik vervolgens de dotnet tool uninstall --global opdracht.

x64

dotnet tool uninstall --global mlnet-win-x64

ARM

dotnet tool uninstall --global mlnet-win-arm64

Het CLI-pakket bijwerken

Als u de ML.NET CLI wilt bijwerken, gebruikt u de pakket-id die u kunt ophalen bij het uitvoeren van de dotnet tool list --global opdracht. Gebruik vervolgens de dotnet tool update --global opdracht.

x64

dotnet tool update --global mlnet-win-x64

ARM

dotnet tool update --global mlnet-win-arm64

Installatiemap

De ML.NET CLI kan worden geïnstalleerd in de standaardmap of op een specifieke locatie. De standaardmappen zijn:

Besturingssysteem Pad
Linux/macOS $HOME/.dotnet/tools
Windows %USERPROFILE%\.dotnet\tools

Deze locaties worden toegevoegd aan het pad van de gebruiker wanneer de SDK voor het eerst wordt uitgevoerd, zodat Global Tools die daar zijn geïnstalleerd, rechtstreeks kunnen worden aangeroepen.

Opmerking: de globale hulpprogramma's zijn gebruikersspecifiek en niet algemeen. Als u gebruikersspecifiek bent, kunt u geen algemeen hulpprogramma installeren dat beschikbaar is voor alle gebruikers van de computer. Het hulpprogramma is alleen beschikbaar voor elk gebruikersprofiel waarop het hulpprogramma is geïnstalleerd.

Globale hulpprogramma's kunnen ook worden geïnstalleerd in een specifieke map. Wanneer deze is geïnstalleerd in een specifieke map, moet de gebruiker ervoor zorgen dat de opdracht beschikbaar is, door die map op te geven in het pad, door de opdracht aan te roepen met de opgegeven map of het hulpprogramma aan te roepen vanuit de opgegeven map. In dit geval voegt de .NET CLI deze locatie niet automatisch toe aan de omgevingsvariabele PATH.

Zie ook