starpilot ppo deep-reinforcement-learning reinforcement-learning

PPO Agent playing starpilot

This is a trained model of a PPO agent playing starpilot using the /sgoodfriend/rl-algo-impls repo.

All models trained at this commit can be found at https://api.wandb.ai/links/sgoodfriend/v1p4976e.

Training Results

This model was trained from 3 trainings of PPO agents using different initial seeds. These agents were trained by checking out 6394df4. The best and last models were kept from each training. This submission has loaded the best models from each training, reevaluates them, and selects the best model from these latest evaluations (mean - std).

algo env seed reward_mean reward_std eval_episodes best wandb_url
ppo starpilot 1 26.6367 15.2893 256 wandb
ppo starpilot 2 26.1719 14.3367 256 wandb
ppo starpilot 3 27.8945 14.2028 256 * wandb

Prerequisites: Weights & Biases (WandB)

Training and benchmarking assumes you have a Weights & Biases project to upload runs to. By default training goes to a rl-algo-impls project while benchmarks go to rl-algo-impls-benchmarks. During training and benchmarking runs, videos of the best models and the model weights are uploaded to WandB.

Before doing anything below, you'll need to create a wandb account and run wandb login.

Usage

/sgoodfriend/rl-algo-impls: https://github.com/sgoodfriend/rl-algo-impls

Note: While the model state dictionary and hyperaparameters are saved, the latest implementation could be sufficiently different to not be able to reproduce similar results. You might need to checkout the commit the agent was trained on: 6394df4.

# Downloads the model, sets hyperparameters, and runs agent for 3 episodes
python enjoy.py --wandb-run-path=sgoodfriend/rl-algo-impls-benchmarks/d9ab27yv

Setup hasn't been completely worked out yet, so you might be best served by using Google Colab starting from the colab_enjoy.ipynb notebook.

Training

If you want the highest chance to reproduce these results, you'll want to checkout the commit the agent was trained on: 6394df4. While training is deterministic, different hardware will give different results.

python train.py --algo ppo --env starpilot --seed 3

Setup hasn't been completely worked out yet, so you might be best served by using Google Colab starting from the colab_train.ipynb notebook.

Benchmarking (with Lambda Labs instance)

This and other models from https://api.wandb.ai/links/sgoodfriend/v1p4976e were generated by running a script on a Lambda Labs instance. In a Lambda Labs instance terminal:

git clone git@github.com:sgoodfriend/rl-algo-impls.git
cd rl-algo-impls
bash ./lambda_labs/setup.sh
wandb login
bash ./lambda_labs/benchmark.sh

Alternative: Google Colab Pro+

As an alternative, colab_benchmark.ipynb, can be used. However, this requires a Google Colab Pro+ subscription and running across 4 separate instances because otherwise running all jobs will exceed the 24-hour limit.

Hyperparameters

This isn't exactly the format of hyperparams in hyperparams/ppo.yml, but instead the Wandb Run Config. However, it's very close and has some additional data:

algo: ppo
algo_hyperparams:
  batch_size: 8192
  clip_range: 0.2
  clip_range_vf: 0.2
  ent_coef: 0.01
  gae_lambda: 0.95
  gamma: 0.999
  learning_rate: 0.0005
  n_epochs: 3
  n_steps: 256
  vf_coef: 0.5
env: procgen-starpilot-hard
env_hyperparams:
  is_procgen: true
  make_kwargs:
    distribution_mode: hard
  n_envs: 256
  normalize: true
env_id: starpilot
eval_params:
  ignore_first_episode: true
  step_freq: 500000
n_timesteps: 200000000
policy_hyperparams:
  activation_fn: relu
  cnn_feature_dim: 256
  cnn_layers_init_orthogonal: false
  cnn_style: impala
  init_layers_orthogonal: true
seed: 3
use_deterministic_algorithms: true
wandb_entity: null
wandb_project_name: rl-algo-impls-benchmarks
wandb_tags:
- benchmark_6394df4
- host_129-146-101-245