README.md

---
library_name: rl-algo-impls
tags:
- CarRacing-v0
- a2c
- deep-reinforcement-learning
- reinforcement-learning
model-index:
- name: a2c
  results:
  - metrics:
    - type: mean_reward
      value: 623.75 +/- 208.23
      name: mean_reward
    task:
      type: reinforcement-learning
      name: reinforcement-learning
    dataset:
      name: CarRacing-v0
      type: CarRacing-v0
---
# **A2C** Agent playing **CarRacing-v0**

This is a trained model of a **A2C** agent playing **CarRacing-v0** using the [/sgoodfriend/rl-algo-impls](https://github.com/sgoodfriend/rl-algo-impls) repo.

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

## Training Results

This model was trained from 3 trainings of **A2C** agents using different initial seeds. These agents were trained by checking out [983cb75](https://github.com/sgoodfriend/rl-algo-impls/tree/983cb75e43e51cf4ef57f177194ab9a4a1a8808b). 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                                                                    |
|:-------|:-------------|-------:|--------------:|-------------:|----------------:|:-------|:-----------------------------------------------------------------------------|
| a2c    | CarRacing-v0 |      1 |       368.77  |      125.926 |              12 |        | [wandb](https://wandb.ai/sgoodfriend/rl-algo-impls-benchmarks/runs/yy6vl74f) |
| a2c    | CarRacing-v0 |      2 |       363.779 |      166.663 |              12 |        | [wandb](https://wandb.ai/sgoodfriend/rl-algo-impls-benchmarks/runs/rft2z5w4) |
| a2c    | CarRacing-v0 |      3 |       623.749 |      208.23  |              12 | *      | [wandb](https://wandb.ai/sgoodfriend/rl-algo-impls-benchmarks/runs/0l78rzpf) |


### 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:
[983cb75](https://github.com/sgoodfriend/rl-algo-impls/tree/983cb75e43e51cf4ef57f177194ab9a4a1a8808b).
```
# Downloads the model, sets hyperparameters, and runs agent for 3 episodes
python enjoy.py --wandb-run-path=sgoodfriend/rl-algo-impls-benchmarks/0l78rzpf
```

Setup hasn't been completely worked out yet, so you might be best served by using Google
Colab starting from the
[colab_enjoy.ipynb](https://github.com/sgoodfriend/rl-algo-impls/blob/main/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: [983cb75](https://github.com/sgoodfriend/rl-algo-impls/tree/983cb75e43e51cf4ef57f177194ab9a4a1a8808b). While
training is deterministic, different hardware will give different results.

```
python train.py --algo a2c --env CarRacing-v0 --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](https://github.com/sgoodfriend/rl-algo-impls/blob/main/colab_train.ipynb)
notebook.



## Benchmarking (with Lambda Labs instance)
This and other models from https://api.wandb.ai/links/sgoodfriend/ysd5gj7p 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 [-a {"ppo a2c dqn vpg"}] [-e ENVS] [-j {6}] [-p {rl-algo-impls-benchmarks}] [-s {"1 2 3"}]
```

### Alternative: Google Colab Pro+
As an alternative,
[colab_benchmark.ipynb](https://github.com/sgoodfriend/rl-algo-impls/tree/main/benchmarks#:~:text=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/a2c.yml, but instead the Wandb Run Config. However, it's very
close and has some additional data:
```
additional_keys_to_log: []
algo: a2c
algo_hyperparams:
  ent_coef: 1.5666550584860516e-06
  ent_coef_decay: linear
  gae_lambda: 0.9549244758833236
  gamma: 0.9942776405534832
  learning_rate: 1.8971962220405576e-05
  max_grad_norm: 2.2574480552177127
  n_steps: 64
  normalize_advantage: false
  sde_sample_freq: 16
  use_rms_prop: false
  vf_coef: 0.12164696385898476
device: auto
env: CarRacing-v0
env_hyperparams:
  frame_stack: 4
  n_envs: 4
  normalize: true
  normalize_kwargs:
    norm_obs: false
    norm_reward: true
env_id: null
eval_hyperparams: {}
microrts_reward_decay_callback: false
n_timesteps: 4000000
policy_hyperparams:
  activation_fn: tanh
  cnn_flatten_dim: 256
  hidden_sizes:
  - 256
  init_layers_orthogonal: true
  log_std_init: -4.839609092563
  share_features_extractor: false
  use_sde: true
seed: 3
use_deterministic_algorithms: true
wandb_entity: null
wandb_group: null
wandb_project_name: rl-algo-impls-benchmarks
wandb_tags:
- benchmark_983cb75
- host_129-159-43-75
- branch_main
- v0.0.9

```