【Unity ML-Agents ver.0.5 対応】大幅な仕様変更に対応！ML-Agents のインストール方法

はじめに
※開発環境
１、Unity ML-Agents のインストール
1. GitHub – Unity ML-Agents からダウンロード
２、TensorFlowSharp in Unityをインストール
３、Anaconda のインストール
４、Anaconda Navigatorの設定
５、Pythonパッケージのインストール
６、Unity側のML-Agentsの設定

はじめに

この記事ではUnityで機械学習が行えるライブラリ「Unity ML-Agents」の導入方法を紹介します。

―　YouTubeでも視聴可能です　―

※開発環境

今回の開発環境は Windows 10 (64 bit)、Python 3.7 、ML-Agents ver 0.5を想定しています。

１、Unity ML-Agents のインストール

GitHub – Unity ML-Agents からダウンロード

以下のリンクからGitHubへ行き、「Clone or download」をクリックして「Download ZIP」してください。

GitHub - Unity-Technologies/ml-agents: 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 learning and imitation learning.

The Unity Machine Learning Agents Toolkit (ML-Agents) is an open-source project that enables games and simulations to se...

The Unity Machine Learning Agents Toolkit (ML-Agents) is an open-source project that enables games and simulations to se...

ダウンロードしたZIPを「Lhaplus」などの解凍ソフトを使って解凍してください。

本記事では、解凍したファイルはデスクトップ上に置くものとします。

２、TensorFlowSharp in Unityをインストール

以下リンクからGitHubへ行き、「Requirements」の「Unity TensorFlow Plugin」からTensorFlowのPluginをダウンロードしてください。

TensorFlowとは、Googleが主導して開発している、機械学習のライブラリです。

https://github.com/Unity-Technologies/ml-agents/blob/master/docs/Using-TensorFlow-Sharp-in-Unity.md

https://github.com/Unity-Technologies/ml-agents/blob/master/docs/Using-TensorFlow-Sharp-in-Unity.md

３、Anaconda のインストール

・Anaconda.exeのインストール

以下のリンクから、「Python 3.7 version」をクリックして、『Anaconda』をインストールしてください。

Download Anaconda Distribution | Anaconda

Download Anaconda's open-source Distribution today. Discover the easiest way to perform Python/R data science and machin...

https://github.com/Unity-Technologies/ml-agents/blob/master/docs/Using-TensorFlow-Sharp-in-Unity.md

・Anacondaのセットアップ

Anacondaをダウンロードしたら以下のような画面が現れますが、×で閉じて構いません。

「Next」をクリック。

「I Agree」をクリック。

「Next」をクリック。

好きなフォルダを選択して「Next」をクリック。

ただし、ユーザー名はできればアルファベットの方がいいです。

日本語では何らかのエラーが生じることがあります。

ちなみに、私はいつもユーザー名は「国際標準化機構」の「iso」にしてます笑

みなさんはご利用中のPCのユーザー名をご使用ください。

「Install」をクリック。

ここでポイントですが、Anacondaが上手く実行されない場合、「PATHを通す」ことで改善することがあります。

私の場合は「Add Anaconda to my PATH environment variable」にチェックを入れずにインストールしたら普通に上手くいきましたが、もし上手くいかなかった場合は、これにチェックを付けてインストールしてみてください。

参考になりそうなリンクも貼っておきます。

PythonのPATHの通し方参考リンク

WindowsでPythonがうまく動かないとき(PATHの設定) - Qiita

初めてWindowsでPython使うときに動かない人のためのメモ#WindowsでPythonそもそもWindowsってPythonあんまやりにくいんですってWindowsでPythonで…

Python利用のための環境変数PATHを設定する

Python で提供されているプログラムをコマンドプロンプトから実行する場合、 PATH を設定しておくと便利です。ここでは PATH の設定方法について解説します。(インストール時に自動で PATH を設定するようにチェックしていた場合に...

４、Anaconda Navigatorの設定

Anacondaをインストールしたら、Windowsの「プログラム一覧」をより、「Anaconda Navigator」を起動してください。

Anaconda Navigatorのサイドバーより「Environments」を選択。

「Create」をクリックして、出てきたウィンドウのNameに好きな名前を付けて、Pythonのバージョンを3.7にしてください。完了したら「Create」をクリック

作成した環境（今回はmlagents）の右の「▶ボタン」をクリックし、「Open Terminal」をクリックすると、コマンドプロンプトが起動します。

５、Pythonパッケージのインストール

・Pythonのバージョンの確認

コマンドプロンプトに「python –version」と入力してEnterを押してください。

「Python 3.7.1」と表示されたらオッケーです。

・Python 3.6のインストール

次の手順でPythonのパッケージのインストールを行うのですが、ml-Agents ver0.5では「Python3.6 以上、3.7未満」のバージョンを要求されます。なので、最新のPythonのバージョンである3.7.1ではインストールできません。

そこで、今回はPython 3.6.3をインストールします。「conda create -n ml-agents python=3.6.3」と入力してください。途中の質問には「y(=yes)」で答えてください。

また、コマンドプロンプトの入力行の頭文字が（base）となっている場合は「activate ml-agents」と入力して（ml-agents）と表示させてください。

Unity ゲーム制作日記様より引用

ML-Agents（ver0.5）の環境導入方法まとめ（Windows版）（ver0.6に関するコメント追加）

（2019/1/11 ML-Agents（ver0.6）についてのコメントを追記）こちらのページは、ML-Agents（ver0.5）にて機械学習を行うための開発環境導入方法をまとめたページになります。ML-Agents関連の調査を始めた当

・pip installを使ったパッケージのインストール

GitHubよりダウンロードして解凍した「ml-agentsm-master」フォルダ内に、「ml-agents」フォルダがあるので、コマンドプロンプトのディレクトリをそのフォルダに移動します。

古いバージョンである、ML-Agents ver 0.4 ではこの「ml-agents」フォルダが「python」という名前でした。なので、昔の記事や資料では「cd python」でディレクトリを移動するように指示していますが、最新のver 0.5 では「ml-agents」となっているので注意してください。