Cómo instalar la herramienta de la interfaz de la línea de comandos (CLI) de ML.NET
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
Este tema hace referencia a la CLI de ML.NET y AutoML de ML.NET, que se encuentran actualmente en versión preliminar, por lo que el material está sujeto a cambios.
Requisitos previos
(Opcional) Visual Studio 2019
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 de la CLI de .NET.
En el ejemplo siguiente se muestra cómo instalar la CLI de ML.NET en la ubicación de la fuente de NuGet predeterminada:
dotnet tool install -g mlnet
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' (version 'X.X.X') was successfully installed.
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, tenga en cuenta que si 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. Las instrucciones sobre cómo hacerlo deben aparecer 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 marco con el formato siguiente:
dotnet tool install -g mlnet --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
Escriba el siguiente comando para desinstalar el paquete de la máquina local:
dotnet tool uninstall mlnet -g
Actualizar el paquete de la CLI
Escriba el siguiente comando para actualizar l paquete de la máquina local:
dotnet tool update -g mlnet
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 | Ruta de acceso |
|---|---|
| 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.