Unity ML-Agents 2.0 환경설정 및 설치 - 1 [ Unity ]

Unity ML-Agnets 2.0

유니티에서 제공하는 머신러닝을 사용하기위한 환경설정을 진행해보도록 하겠다.

---

https://github.com/Unity-Technologies/ml-agents

GitHub - Unity-Technologies/ml-agents: Unity Machine Learning Agents Toolkit

 

- ML-Agents Clone

현 시점 기준 최신버전인 Release 19의 source로 들어가서 다운로드를 진행해준다. 

git으로 clone 또는 Github Desktop, ZIP 중 편한 방법으로 진행하면 된다.

---

이후 다운받은 폴더의 압축을 풀게 되면 아래와 같은 구성이 나오며, 각 폴더별 내용을 간단히 정리하자면, 

com.unity.ml-agents , com.unity.ml-agents.extensions	유니티 패키지
config	다양한 환경에 대한 강화학습 알고리즘 파라미터 설정
ml-agents, ml-agents-envs, ml-agents-plugin-examples	파이썬 패키지
Project	머신러닝을 수행할 예제 프로젝트 폴더

정도로 정리할수있다. 

---

- ML-Agents 유니티 패키지 설치 방법 

1. 유니티 패키지에서 기본적으로 제공하는 ML-Agents 패키지 설치

2. 직접 ML-Agents 패키지 설치하기 

3. ML-Agents의 예제 프로젝트 이용하기

- ML-Agents 파이썬 라이브러리 설치 방법

1. pip를 이용한 설치

2. 로컬에서 설치

---

방법 1

1. Unity Hub를 열고 새 프로젝트를 생성해준다. 

 

2. 이후 프로젝트가 열리면 아래와 같이 Windows -> Package Manager 에서 Unity Registry 를 통해 유니티에서 기본적으로 제공하는 다양한 패키지들을 확인할수있다. 

 

3. 그중 ML Agents를 선택후 Install 해준다 .

하지만 위 방식으로 설치할 경우 ML-Agents 1.0.8로 검증은 되어있지만, 최신이 아니다. 

---

방법 2 (직접 버전에 맞게 설치)

위의 방법으로 수행했다면, 다시 Package에 들어가서 ML-Agents 를 remove한 후 아래 과정을 진행하면 된다. 

위와 같이 Package Manager에 들어간 후, Select package on disk (직접 설치) 를 누르고 좀전에 받아두었던 unity ml-agents-realease 파일에서 아래 두파일에서의 package.json 파일을 선택해서 직접 설치해주면된다.

 

여기까지 Package를 설치하였다면, 현재 유니티에서 제공하는 가장 최신버전의 ml-agents package 및 환경을 모두 설치한것이다. 

---

이번에는 Unity에서 제공하는 머신러닝 예제학습을 위해 아래경로의 폴더를 유니티 프로젝트에 넣어보겠다.

위 과정을 수행하였다면 프로젝트에 아래와 같이 에러가 발생하는것을 확인할수있는데, 이는 현재 유니티 프로젝트와 ML-Agents 폴더 내의 버전이 다르기 떄문이다.

위 에러는 특정 예제폴더를 삭제해주면 버전을 임의로 맞추는 방법이있다.  하지만 아래 방법으로 가장 깔끔하게 수행해보도록하겠다.

---

방법 3. ( Unity에서 제공하는 폴더내에서 프로젝트를 직접 설치하는 방식 )

기본적으로 유니티 프로젝트를 새로 만들 필요없이 아래의 과정을 따라 진행해보겠다. 

github에서 내려받은 아래 폴더의 Project폴더(예제 폴더)를 복사하여 저장할 경로에 붙여넣는다. 

이후 프로젝트명을 사용할것으로 변경하고 Unity hub에서 해당 폴더를 추가해주면 된다.

이때, 버전 상이에 따른 경고메세지가 발생하는데, 이는 굳이 맞추지않고 최신버전으로 진행하겠다.

 

이후 현재 ML-Agent Releases_19 버전 기준으로 Open할 유니티를 2021버전으로 업데이트해준후 UnityHub에서 해당 Project경로를 Open하여 열어보면, 이전 단계에서와 같이 특정 예제소스에서의 에러가 발생한다고 뜰것이다.

이떄 그냥 Ignore을 눌러 프로젝트를 열어준 후, 이전에 수행하였던것과 같이 삭제해주면 된다.

 

아래와 같이 에러가 나는이유는, 기존의 프로젝트에서 복사를 하였기 때문에, 패키지의 경로가 바뀐 문제이다. 

그렇다면 위에서 수행하였던 것처럼 Package 파일을 수동으로 추가해주면 아래와 같이 에러가 없어진다.

---

 

 

다음 포스팅에서는 ML-Agents의 Python 관련 환경을 설정하는 방법을 이어서 작성하도록하겠습니다.