본문 바로가기
강화학습

[유니티] ml-agent 설치

by yongee97 2025. 7. 13.

* 환경

Ubuntu 22.04.5 LTS

Unity Hub 3.11.1

 

 

* 순서

1. 유니티 허브에서 새 프로젝트 생성

 

1.1 유니티 허브 실행 후 우측 상단 New Project 버튼 클릭

- 유니티 허브 실행 시 기존 생성된 프로젝트 리스트 확인 가능

유니티 허브 실행 시 환경

 

1.2 템플릿 선택 및 프로젝트 제목, 경로 설정 후 프로젝트 생성

- 템플릿은 3D (Built-In Render Pipeline) 선택

- 템플릿이 설치되지 않은 경우 설치 후 계속

 

템플릿 선택 및 제목, 경로 설정

 

 

2. ML-Agents 다운로드

2.1 ML-Agent 깃허브 접속

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

 

GitHub - Unity-Technologies/ml-agents: The Unity Machine Learning Agents Toolkit (ML-Agents) is an open-source project that enab

The Unity Machine Learning Agents Toolkit (ML-Agents) is an open-source project that enables games and simulations to serve as environments for training intelligent agents using deep reinforcement ...

github.com

 

2.2 Releases  페이지로 이동하여 Release 22 소스코드 다운로드 후 압축 해제

-  .zip 압축 버전 다운로드

- 압축 해제 시 ml-agents-release_22 폴더 생성

깃허브 페이지 우측 Release 버튼
Release 22

 

3 유니티 프로젝트에 ML-Agents 설치

3.1 패키지 매니저 열기

- 화면 상단 메뉴에서 Window - Pakcage Manager 선택

화면 상단 메뉴에서 Package Manager 열기

 

3.2 로컬에서 패키지 추가하기

- 왼쪽 상단 + 버튼 선택 후 install package from disk 선택

install package from disk 버튼 선택

 

3.3 ML-Agents 패키지 추가

- ml-agents-release_22 폴더 ('2. ML-Agents 다운로드' 에서 다운로드 후 압축 해제한 폴더)로 이동

- com.unity.ml-agents 폴더로 이동

- package.json 선택하면 ML-Agents 설치 완료

com.unity.ml-agents 폴더로 이동
package.json 선택
설치 진행 시 화면

 

설치 완료 시 화면

3.4 ML-Agents Extensions 패키지 추가

- 3.1, 3.2 반복하여 로컬에서 패키지 추가하는 화면으로 이동

- ml-agents-release_22 폴더로 이동

- com.unity.ml-agents.extensions 폴더로 이동

- package.json 선택 후 기다리면 ML-Agents Extensions 설치 완료

 

 

com.unity.ml-agents.extensions 폴더로 이동
package.json 선택

 

ML Agents Extensions 설치 완료

 

 

3.5 ML-Agents 예시 프로젝트 옮기기

- 외부 탐색기에서 ml-agents-release_22 폴더로 이동

- Project/Assets 경로로 이동

- ML-Agents 폴더를 현재 유니티 프로젝트 화면 좌측 하단 Project 뷰 내 Assets 폴더로 드래그 앤 드롭
(Assets 폴더로 정확히 드롭해야 추가 가능)

- 잠시 기다리면 Assets 폴더 내 ML-Agents 추가 완료

 

ml-agents-release_22 폴더 내 Project 폴더로 이동
Project 폴더에서 Assets 폴더로 이동

 

ML-Agents 폴더를 현재 유니티 프로젝트 화면 좌측 하단 Project 뷰로 드래그 앤 드롭
유니티 화면 좌측 하단에 있는 Project 뷰와 내부 Assets 폴더

 

드래그 앤 드롭 후 잠시 대기하면 ML-Agents 추가 완료

4. ML-Agents 파이썬 패키지 설치

- 터미널에 아래 명령어를 입력하여 설치

pip install mlagents