ML.NET CLI(명령줄 인터페이스) 도구를 설치하는 방법

  • 아티클

Windows, Mac 또는 Linux에 ML.NET CLI(명령줄 인터페이스)를 설치하는 방법에 대해 알아봅니다.

ML.NET CLI는 AutoML(자동화된 Machine Learning) 및 학습 데이터 세트를 사용하여 우수한 품질의 ML.NET 모델과 소스 코드를 생성합니다.

참고 항목

이 문서에서는 현재 미리 보기 상태인 ML.NET CLI 및 ML.NET AutoML을 참조하며 자료는 변경될 수 있습니다.

필수 구성 요소

F5 키를 누르거나 dotnet run(.NET CLI)을 사용하여 Visual Studio에서 생성된 C# 코드 프로젝트를 실행할 수 있습니다.

참고: .NET SDK 설치 후 dotnet tool 명령이 작동하지 않는 경우 Windows에서 로그아웃했다가 다시 로그인합니다.

설치

ML.NET CLI는 다른 DotNet Global Tool처럼 설치됩니다. dotnet tool install --global .NET CLI 명령을 사용합니다.

ML.NET CLI는 Windows, macOS, Linux에서 사용할 수 있습니다. 프로세서 아키텍처에 따라 x64 또는 ARM 버전을 선택합니다.

참고 항목

ARM 기반 버전의 ML.NET CLI는 이미지 분류 시나리오를 지원하지 않습니다.

X64

dotnet tool install --global mlnet-win-x64

ARM

dotnet tool install --global mlnet-win-arm64

도구를 설치할 수 없는 경우(즉 기본 NuGet 피드에서 사용할 수 없는 경우) 오류 메시지가 표시됩니다. 예상한 피드가 확인되고 있는지 검사합니다.

설치에 성공하면 다음 예와 같이 도구와 설치된 버전을 호출하는 데 사용되는 명령을 보여 주는 메시지가 표시됩니다.

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

이 경우 OS 및 ARCH는 ML.NET CLI를 설치할 때 선택한 운영 체제 및 프로세서 아키텍처의 값과 일치해야 합니다.

다음 명령을 입력하여 설치가 완료되었는지 확인할 수 있습니다.

mlnet

‘classification’ 명령처럼 mlnet 도구에 대해 사용 가능한 명령의 도움말을 참조해야 합니다.

Important

Linux 또는 macOS를 실행 중이고 Bash 이외의 콘솔(예: macOS의 새로운 기본값인 zsh)을 사용 중인 경우 mlnet에 실행 파일 권한을 부여하고 시스템 경로에 mlnet을 포함해야 합니다. 일반적으로 다음 명령을 사용하여 수행할 수 있습니다.

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

이 작업을 수행하는 방법에 대한 자세한 지침은 mlnet(또는 임의 전역 도구)을 설치할 때 터미널에 나타납니다.

또는 다음 명령을 사용하여 mlnet 도구를 실행해 볼 수 있습니다.

~/.dotnet/tools/mlnet

특정 릴리스 버전 설치

이전 릴리스 버전 또는 특정 버전의 도구를 설치하려는 경우 다음 형식을 사용하여 OS, 프로세서 아키텍처, 프레임워크를 지정할 수 있습니다.

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

다음 명령을 입력하여 패키지가 올바르게 설치되었는지 확인할 수도 있습니다.

dotnet tool list -g

CLI 패키지 제거

ML.NET CLI를 제거하려면 dotnet tool list --global 명령 실행에서 가져올 수 있는 패키지 ID를 사용합니다. 그런 다음, dotnet tool uninstall --global 명령을 사용합니다.

X64

dotnet tool uninstall --global mlnet-win-x64

ARM

dotnet tool uninstall --global mlnet-win-arm64

CLI 패키지 업데이트

ML.NET CLI를 업데이트하려면 dotnet tool list --global 명령 실행에서 가져올 수 있는 패키지 ID를 사용합니다. 그런 다음, dotnet tool update --global 명령을 사용합니다.

X64

dotnet tool update --global mlnet-win-x64

ARM

dotnet tool update --global mlnet-win-arm64

설치 디렉터리

ML.NET CLI는 기본 디렉터리 또는 특정 위치에 설치할 수 있습니다. 기본 디렉터리는 다음과 같습니다.

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

이러한 위치는 SDK를 처음 실행할 때 사용자 경로에 추가되므로 설치된 Global Tool을 직접 호출할 수 있습니다.

참고: Global Tool은 컴퓨터 전체가 아닌 사용자 특정입니다. 사용자별 도구라는 것은 컴퓨터의 모든 사용자가 사용할 수 있는 Global Tool을 설치할 수 없음을 의미합니다. 이 도구는 도구가 설치된 각 사용자 프로필에서만 사용할 수 있습니다.

Global Tool을 특정 디렉터리에 설치할 수도 있습니다. 특정 디렉터리에 설치된 경우 사용자는 경로에 해당 디렉터리를 포함하거나, 지정된 디렉터리로 명령을 호출하거나, 지정된 디렉터리 내에서 도구를 호출하여 명령을 사용할 수 있는지 확인해야 합니다. 이 경우 .NET CLI는 이 위치를 PATH 환경 변수에 자동으로 추가하지 않습니다.

참고 항목