Cómo instalar la herramienta de la interfaz de la línea de comandos (CLI) de ML.NET

  • Artículo

Obtenga información sobre cómo instalar la CLI (interfaz de la línea de comandos) de ML.NET en Windows, Mac o Linux.

La CLI de ML.NET genera código fuente y modelos de ML.NET de buena calidad mediante el aprendizaje automático automatizado (AutoML) y un conjunto de datos de entrenamiento.

Nota:

En este artículo se hace referencia a ML.NET CLI y ML.NET AutoML, que se encuentran actualmente en versión preliminar, y el material puede estar sujeto a cambios.

Requisitos previos

Puede ejecutar los proyectos del código de C# generado con Visual Studio presionando la tecla F5 o con dotnet run (CLI de .NET).

Nota: Si después de instalar el SDK de .NET el comando dotnet tool no funciona, cierre la sesión de Windows y vuelva a iniciarla.

Instalar

La CLI de ML.NET se instala como cualquier otra herramienta global de dotnet. Debe usar el comando dotnet tool install --global de la CLI de .NET.

La CLI de ML.NET está disponible para Windows, macOS y Linux. En función de la arquitectura del procesador, elija la versión x64 o ARM.

Nota

Las versiones basadas en ARM de la CLI de ML.NET no admiten escenarios de clasificación de imágenes.

x64

dotnet tool install --global mlnet-win-x64

ARM

dotnet tool install --global mlnet-win-arm64

Si la herramienta no se puede instalar (es decir, si no está disponible con la fuente de NuGet predeterminada), se muestran mensajes de error. Verifique que se comprueban las fuentes que esperaba.

Si la instalación es correcta, se muestra un mensaje similar al siguiente con el comando que se usa para llamar a la herramienta y la versión instalada:

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

En este caso, OS y ARCH deben coincidir con los valores del sistema operativo y la arquitectura del procesador que seleccionó al instalar la CLI de ML.NET.

Para confirmar que la instalación se realizó correctamente, escriba el comando siguiente:

mlnet

Debería ver la Ayuda correspondiente a los comandos disponibles para la herramienta de mlnet, como el comando "classification".

Importante

Si ejecuta Linux o macOS y usa una consola que no sea Bash (por ejemplo, zsh, que es el nuevo valor predeterminado para macOS), tendrá que conceder permisos ejecutables mlnet e incluir mlnet en la ruta del sistema. En general, puede hacerlo con los siguientes comandos:

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

Deben aparecer instrucciones más detalladas sobre cómo hacerlo en el terminal al instalar mlnet (o cualquier herramienta global).

Como alternativa, puede intentar usar el comando siguiente para ejecutar la herramienta mlnet:

~/.dotnet/tools/mlnet

Instalar una versión de lanzamiento específica

Si está intentando instalar una versión preliminar o una versión específica de la herramienta, puede especificar el sistema operativo, la arquitectura del procesador y el marco con el formato siguiente:

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

También puede comprobar si el paquete está instalado correctamente. Para ello, escriba el comando siguiente:

dotnet tool list -g

Desinstalar el paquete de la CLI

Para desinstalar la CLI de ML.NET, use el identificador de paquete que obtendrá al ejecutar el comando dotnet tool list --global. Después, use el comando dotnet tool uninstall --global.

x64

dotnet tool uninstall --global mlnet-win-x64

ARM

dotnet tool uninstall --global mlnet-win-arm64

Actualizar el paquete de la CLI

Para actualizar la CLI de ML.NET, use el identificador de paquete que obtendrá al ejecutar el comando dotnet tool list --global. Después, use el comando dotnet tool update --global.

x64

dotnet tool update --global mlnet-win-x64

ARM

dotnet tool update --global mlnet-win-arm64

Directorio de instalación

La CLI de ML.NET puede instalarse en el directorio predeterminado o en una ubicación específica. Los directorios predeterminados son:

SO Path
Linux/macOS $HOME/.dotnet/tools
Windows %USERPROFILE%\.dotnet\tools

Estas ubicaciones se agregan a la ruta de acceso del usuario cuando se ejecuta el SDK por primera vez, permitiendo así llamar directamente a las herramientas globales allí instaladas.

Nota: Las herramientas globales son específicas del usuario, no de la máquina. Específica del usuario significa que no se puede instalar una herramienta global que está disponible para todos los usuarios de la máquina. La herramienta solo está disponible para cada perfil de usuario en el que se instaló la herramienta.

Las herramientas globales también pueden instalarse en un directorio específico. Cuando se instalan en un directorio específico, el usuario debe incluir el directorio en la ruta de acceso a fin de asegurarse de que el comando está disponible. Hay dos maneras de hacerlo: llamar al comando con el directorio especificado, o llamar a la herramienta desde el directorio especificado. En este caso, la CLI de .NET no agrega esta ubicación automáticamente a la variable de entorno PATH.

Vea también