Banner

ReAgent: Applied Reinforcement Learning Platform

https://circleci.com/gh/facebookresearch/ReAgent/tree/main.svg?style=svg

Overview

ReAgent is an open source end-to-end platform for applied reinforcement learning (RL) developed and used at Facebook. ReAgent is built in Python and uses PyTorch for modeling and training and TorchScript for model serving. The platform contains workflows to train popular deep RL algorithms and includes data preprocessing, feature transformation, distributed training, counterfactual policy evaluation, and optimized serving. For more detailed information about ReAgent, please read releases post and white paper.

The source code is available here: Source code.

The platform was once named “Horizon” but we have adopted the name “ReAgent” recently to emphasize its broader scope in decision making and reasoning.

Algorithms Supported

Classic Off-Policy algorithms:

RL for recommender systems:

Counterfactual Evaluation:

Multi-Arm and Contextual Bandits:

Others:

Installation

ReAgent can be installed via. Docker or manually. Detailed instructions on how to install ReAgent can be found here: Installation.

Tutorial

ReAgent is designed for large-scale, distributed recommendation/optimization tasks where we don’t have access to a simulator. In this environment, it is typically better to train offline on batches of data, and release new policies slowly over time. Because the policy updates slowly and in batches, we use off-policy algorithms. To test a new policy without deploying it, we rely on counter-factual policy evaluation (CPE), a set of techniques for estimating a policy based on the actions of another policy.

We also have a set of tools to facilitate applying RL in real-world applications:

  • Domain Analysis Tool, which analyzes state/action feature importance and identifies whether the problem is a suitable for applying batch RL

  • Behavior Cloning, which clones from the logging policy to bootstrap the learning policy safely

Detailed instructions on how to use ReAgent can be found here: Usage.

License

ReAgent is released under a BSD license. Find out more about it here: License.
Terms of Use - https://opensource.facebook.com/legal/terms
Privacy Policy - https://opensource.facebook.com/legal/privacy
Copyright © 2022 Meta Platforms, Inc

Citing

Cite our work by:

@article{gauci2018horizon,
  title={Horizon: Facebook's Open Source Applied Reinforcement Learning Platform},
  author={Gauci, Jason and Conti, Edoardo and Liang, Yitao and Virochsiri, Kittipat and Chen, Zhengxing and He, Yuchen and Kaden, Zachary and Narayanan, Vivek and Ye, Xiaohui},
  journal={arXiv preprint arXiv:1811.00260},
  year={2018}
}

Table of Contents

Getting Started

Advanced Topics

Package Reference

Others