https://github.com/araffin/drqv2

DrQ-v2: Improved Data-Augmented Reinforcement Learning

https://github.com/araffin/drqv2

Science Score: 10.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
  • .zenodo.json file
  • DOI references
  • Academic publication links
    Links to: arxiv.org
  • Academic email domains
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (10.4%) to scientific vocabulary
Last synced: 10 months ago · JSON representation

Repository

DrQ-v2: Improved Data-Augmented Reinforcement Learning

Basic Info
  • Host: GitHub
  • Owner: araffin
  • License: mit
  • Language: Python
  • Default Branch: main
  • Homepage:
  • Size: 624 KB
Statistics
  • Stars: 0
  • Watchers: 0
  • Forks: 0
  • Open Issues: 0
  • Releases: 0
Fork of facebookresearch/drqv2
Created almost 3 years ago · Last pushed almost 3 years ago
Metadata Files
Readme Contributing License Code of conduct

README.md

DrQ-v2: Improved Data-Augmented RL Agent

This is an original PyTorch implementation of DrQ-v2 from

[Mastering Visual Continuous Control: Improved Data-Augmented Reinforcement Learning] by

Denis Yarats, Rob Fergus, Alessandro Lazaric, and Lerrel Pinto.

## Method DrQ-v2 is a model-free off-policy algorithm for image-based continuous control. DrQ-v2 builds on [DrQ](https://github.com/denisyarats/drq), an actor-critic approach that uses data augmentation to learn directly from pixels. We introduce several improvements including: - Switch the base RL learner from SAC to DDPG. - Incorporate n-step returns to estimate TD error. - Introduce a decaying schedule for exploration noise. - Make implementation 3.5 times faster. - Find better hyper-parameters.

These changes allow us to significantly improve sample efficiency and wall-clock training time on a set of challenging tasks from the DeepMind Control Suite compared to prior methods. Furthermore, DrQ-v2 is able to solve complex humanoid locomotion tasks directly from pixel observations, previously unattained by model-free RL.

Citation

If you use this repo in your research, please consider citing the paper as follows: @article{yarats2021drqv2, title={Mastering Visual Continuous Control: Improved Data-Augmented Reinforcement Learning}, author={Denis Yarats and Rob Fergus and Alessandro Lazaric and Lerrel Pinto}, journal={arXiv preprint arXiv:2107.09645}, year={2021} } Please also cite our original paper: @inproceedings{yarats2021image, title={Image Augmentation Is All You Need: Regularizing Deep Reinforcement Learning from Pixels}, author={Denis Yarats and Ilya Kostrikov and Rob Fergus}, booktitle={International Conference on Learning Representations}, year={2021}, url={https://openreview.net/forum?id=GY6-6sTvGaf} }

Instructions

Install MuJoCo if it is not already the case:

  • Obtain a license on the MuJoCo website.
  • Download MuJoCo binaries here.
  • Unzip the downloaded archive into ~/.mujoco/mujoco200 and place your license key file mjkey.txt at ~/.mujoco.
  • Use the env variables MUJOCO_PY_MJKEY_PATH and MUJOCO_PY_MUJOCO_PATH to specify the MuJoCo license key path and the MuJoCo directory path.
  • Append the MuJoCo subdirectory bin path into the env variable LD_LIBRARY_PATH.

Install the following libraries: sh sudo apt update sudo apt install libosmesa6-dev libgl1-mesa-glx libglfw3

Install dependencies: sh conda env create -f conda_env.yml conda activate drqv2

Train the agent: sh python train.py task=quadruped_walk

Monitor results: sh tensorboard --logdir exp_local

License

The majority of DrQ-v2 is licensed under the MIT license, however portions of the project are available under separate license terms: DeepMind is licensed under the Apache 2.0 license.

Owner

  • Name: Antonin RAFFIN
  • Login: araffin
  • Kind: user
  • Location: Munich
  • Company: @DLR-RM

Research Engineer in Robotics and Machine Learning, with a focus on Reinforcement Learning.

GitHub Events

Total
Last Year