Skip to content
A Universal Deep Reinforcement Learning Framework
Python Other
  1. Python 99.7%
  2. Other 0.3%
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
fruit
LICENSE
README.md
__init__.py
release_notes.txt
requirements.txt
setup.py

README.md

Logo

Introduction

Fruit API (http://fruitlab.org/) is a universal deep reinforcement learning framework, which is designed meticulously to provide a friendly user interface, a fast algorithm prototyping tool, and a multi-purpose framework for RL research community. Specifically, Fruit API has the following noticeable contributions:

  • Friendly API: Fruit API follows a modular design combined with the OOP in Python to provide a solid foundation and an easy-to-use user interface via a simplified API. Based on the design, our ultimate goal is to provide researchers a means to develop reinforcement learning (RL) algorithms with little effort. In particular, it is possible to develop a new RL algorithm under 100 lines of code. What users need to do is to create a Config, a Learner, and plug them into the framework. We also provides a lot of sample Configs and Learners in a hierarchical structure so that users can inherit a suitable one.

Figure 1

  • Portability: The framework can work properly in different operating systems including Windows, Linux, and Mac OS.

  • Interoperability: We keep in mind that Fruit API should work with any deep learning libraries such as PyTorch, Tensorflow, Keras, etc. Researchers would define the neural network architecture in the config file by using their favourite libraries. Instead of implementing a lot of deep RL algorithms, we provide a flexible way to integrate existing deep RL libraries by introducing plugins. Plugins extract learners from other deep RL libraries and plug into FruitAPI.

  • Generality: The framework supports different disciplines in reinforement learning such as multiple objectives, multiple agents, and human-agent interaction.

We also implemented a set of deep RL baselines in different RL disciplines as follows.

RL baselines

  • Monte-Carlo
  • Q-Learning

Value-based deep RL baselines:

  • Deep Q-Network (DQN)
  • Double DQN
  • Dueling network with DQN
  • Prioritized Experience Replay (proportional approach)
  • DQN variants (asynchronous/synchronous method)

Policy-based deep RL baselines:

  • A3C

Multi-agent deep RL:

  • Multi-agent A3C
  • Multi-agent A3C with communication map

Human-agent interaction

  • A3C with map
  • Divide and conquer strategy with DQN

Plugins

  • TensorForce plugin (still experimenting). By using TensorForce plugin, it is possible to use all deep RL algorithms implemented in TensorForce library via FruitAPI such as: PPO, TRPO, VPG, DDPG/DPG.
  • Other plugins (OpenAI Baselines, RLLab) are coming soon.

Built-in environments

  • Arcade learning environment (Atari games)
  • OpenAI Gym
  • DeepMind Lab
  • Carla (self-driving car)
  • TensorForce's environments:
    • OpenAI Retro
    • DeepMind Pycolab
    • Unreal Engine
    • Maze Explorer
    • Robotics - OpenSim
    • Pygame Learning environment
    • ViZDoom

External environments can be integrated into the framework easily by plugging into FruitEnvironment. Finally, we developed 5 extra environments as a testbed to examine different disciplines in deep RL:

  • Mountain car (multi-objective environment/graphical support)
  • Deep sea treasure (multi-objective environment/graphical support)
  • Tank battle (multi-agent/multi-objective/human-agent cooperation environment)
  • Food collector (multi-objective environment)
  • Milk factory (multi-agent/heterogeneous environment)

Video demonstrations can be found here (click on the images):

Documentation

  1. Installation guide

  2. Quick start

  3. API reference

Please visit our official website here for more updates, tutorials, sample codes, etc.

References

ReinforcePy is a great repository that we referenced during the development of Fruit API.

Credit

Please cite our work in your papers or projects as follows. All contributions to the work are welcome.

@misc{nguyen2019fruitapi,
    author = {{Nguyen}, N.~D. and {Nguyen}, T.~T.},
    title = {Fruit API - A Universal Deep Reinforcement Learning Framework},
    year = {2019},
    publisher = {GitHub},
    journal = {GitHub repository},
    howpublished = {\url{https://github.com/garlicdevs/Fruit-API}},
}
You can’t perform that action at this time.