Skip to content

Conversation

@awjuliani
Copy link
Contributor

No description provided.

```
python3
```
```
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

add python tag for markdown

# Training on Amazon Web Service

This page contains instructions for setting up an EC2 instance on Amazon Web Service for use in training ML-Agents environments. Current limitations of the Unity Engine require that a screen be available to render to. In order to make this possible when training on a remote server, a virtual screen is required. We can do this by installing Xorg and creating a virtual screen. Once installed and created, we can display the Unity environment in the virtual environment, and train as we would on a local machine.
This page contains instructions for setting up an EC2 instance on Amazon Web Service for use in training ML-Agents environments. You can run "headless" training if none of the agents in the environment use visual observations.
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"use in training ML-Agents environments" --> "training in ML-Agents"

If all steps worked correctly, upload a built Linux environment executable (with `headless` mode selected during build-time) to the instance, and test it from Python using:

```
python3
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not sure we need this.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Which piece isn't needed? The testing section?

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just lines 24 to 26.


## Installing ML-Agents

2. Move `python` sub-folder of this repo to remote instance, and set as working directory.
Copy link
Collaborator

@jo3w4rd jo3w4rd Mar 14, 2018

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Move the python sub-folder of this ml-agents repo to the remote EC2 instance and set it as the working directory.

(Three "the's", an "it", and remove a comma, and add "ml-agents", and adding "EC2" helps as well.)


## Testing

If all steps worked correctly, upload a built Linux environment executable (with `headless` mode selected during build-time) to the instance, and test it from Python using:
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

To verify that all steps worked correctly:

  1. In the Unity Editor, load a project containing an ML-Agents environment (you can use one of the example environments if you have not created your own).
  2. Open the Build Settings window (menu: File > Build Settings).
  3. Select Linux as the Target Platform.

[Editors note: does Architecture matter?]

  1. Check Headless Mode (unless you have enabled a virtual screen following the instructions below).
  2. Click Build to build the Unity environment executable.
  3. Upload the executable to your EC2 instance.
  4. Test the instance setup from Python using:

@awjuliani awjuliani merged commit 4387060 into development-0.3 Mar 14, 2018
@awjuliani awjuliani deleted the docs-ami branch March 14, 2018 21:45
Copy link
Contributor

@eshvk eshvk left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

👍

@github-actions github-actions bot locked as resolved and limited conversation to collaborators May 20, 2021
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants