Cara menginstal alat ML.NET Command-Line Interface (CLI)

  • Artikel

Pelajari cara menginstal CLI ML.NET (antarmuka baris perintah) di Windows, Mac, atau Linux.

CLI ML.NET menghasilkan model ML.NET berkualitas baik dan kode sumber menggunakan pembelajaran mesin otomatis (AutoML) dan himpunan data pelatihan.

Catatan

Artikel ini mengacu pada ML.NET CLI dan ML.NET AutoML, yang saat ini dalam Pratinjau, dan materi dapat berubah.

Prasyarat

Anda dapat menjalankan proyek kode C# yang dihasilkan dengan Visual Studio dengan menekan tombol F5 atau dengan dotnet run (.NET CLI).

Catatan: Jika setelah menginstal .NET SDK dotnet tool , perintah tidak berfungsi, keluar dari Windows dan masuk lagi.

Instal

CLI ML.NET diinstal seperti Alat Global dotnet lainnya. Anda menggunakan dotnet tool install --global perintah .NET CLI.

CLI ML.NET tersedia untuk Windows, macOS, dan Linux. Bergantung pada arsitektur prosesor Anda, pilih versi x64 atau ARM.

Catatan

Versi berbasis ARM dari CLI ML.NET tidak mendukung skenario klasifikasi gambar.

x64

dotnet tool install --global mlnet-win-x64

ARM

dotnet tool install --global mlnet-win-arm64

Jika alat tidak dapat diinstal (yaitu, jika tidak tersedia di umpan NuGet default), pesan kesalahan ditampilkan. Periksa apakah umpan yang Anda harapkan sedang diperiksa.

Jika penginstalan berhasil, pesan ditampilkan yang menunjukkan perintah yang digunakan untuk memanggil alat dan versi yang diinstal, mirip dengan contoh berikut:

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

OS dan ARCH dalam hal ini harus cocok dengan nilai untuk sistem operasi dan arsitektur prosesor yang Anda pilih saat menginstal CLI ML.NET.

Anda dapat mengonfirmasi bahwa penginstalan berhasil dengan mengetik perintah berikut:

mlnet

Anda akan melihat bantuan untuk perintah yang tersedia untuk alat mlnet seperti perintah 'klasifikasi'.

Penting

Jika Anda menjalankan Linux atau macOS dan menggunakan konsol selain Bash (misalnya, zsh, yang merupakan default baru untuk macOS), Maka Anda harus memberikan mlnet izin yang dapat dieksekusi dan menyertakan mlnet ke jalur sistem. Secara umum, Anda dapat melakukannya dengan perintah berikut:

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

Instruksi lebih rinci tentang cara melakukan ini akan muncul di terminal saat Anda menginstal mlnet (atau alat global apa pun).

Atau, Anda dapat mencoba menggunakan perintah berikut untuk menjalankan alat mlnet:

~/.dotnet/tools/mlnet

Menginstal versi rilis tertentu

Jika Anda mencoba menginstal versi pra-rilis atau versi alat tertentu, Anda dapat menentukan OS, arsitektur prosesor, dan kerangka kerja menggunakan format berikut:

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

Anda juga dapat memeriksa apakah paket diinstal dengan benar dengan mengetik perintah berikut:

dotnet tool list -g

Menghapus instalan paket CLI

Untuk menghapus instalan ML.NET CLI, gunakan ID paket yang bisa Anda dapatkan dari menjalankan dotnet tool list --global perintah. Kemudian, gunakan dotnet tool uninstall --global perintah .

x64

dotnet tool uninstall --global mlnet-win-x64

ARM

dotnet tool uninstall --global mlnet-win-arm64

Memperbarui paket CLI

Untuk memperbarui CLI ML.NET, gunakan ID paket yang bisa Anda dapatkan dari menjalankan dotnet tool list --global perintah. Kemudian, gunakan dotnet tool update --global perintah .

x64

dotnet tool update --global mlnet-win-x64

ARM

dotnet tool update --global mlnet-win-arm64

Direktori penginstalan

CLI ML.NET dapat diinstal di direktori default atau di lokasi tertentu. Direktori defaultnya adalah:

OS Jalur
Linux/macOS $HOME/.dotnet/tools
Windows %USERPROFILE%\.dotnet\tools

Lokasi ini ditambahkan ke jalur pengguna saat SDK pertama kali dijalankan, sehingga Alat Global yang diinstal di sana dapat dipanggil secara langsung.

Catatan: Alat Global khusus pengguna, bukan mesin global. Menjadi spesifik pengguna berarti Anda tidak dapat menginstal Alat Global yang tersedia untuk semua pengguna komputer. Alat ini hanya tersedia untuk setiap profil pengguna tempat alat diinstal.

Alat Global juga dapat diinstal di direktori tertentu. Saat diinstal di direktori tertentu, pengguna harus memastikan perintah tersedia, dengan menyertakan direktori tersebut di jalur, dengan memanggil perintah dengan direktori yang ditentukan, atau memanggil alat dari dalam direktori yang ditentukan. Dalam hal ini, .NET CLI tidak menambahkan lokasi ini secara otomatis ke variabel lingkungan PATH.

Lihat juga