Skip to content

limenutt/offworld-gym

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

OffWorld Gym

The challenge that the community sets as a benchmark is usually the challenge that the community eventually solves. The ultimate challenge of reinforcement learning research is to train real agents to operate in the real environment, but until now there has not been a common real-world RL benchmark.

OffWorld Gym is free to use, try it out at gym.offworld.ai

Real-world Robotics Environment for Reinforcement Learning Research

We have created OffWorld Gym - a collection of real-world environments for reinforcement learning in robotics with free public remote access. Close integration into the existing ecosystem allows you to start using OffWorld Gym without any prior experience in robotics and removes the burden of managing a physical robotics system, abstracting it under a familiar API.

When testing your next RL algorithm on Atari, why not also gauge its applicability to the real world!

Install the library, change your gym.make('CartPole-v0') to gym.make('OffWorldMonolith-v0', ...) and you are all set to run your RL algorithm on a real robot, for free!

OffWorld Monolith environment
Environment 1: OffWorld Monolith

Evironments

Real Description
OffWorldMonolithDiscreteReal-v0 OffWorldMonolithDiscreteReal-v0 Wheeled robot on an uneven terrain. Four discrete actions: left, right, forward, back. State space is RGB and/or Depth camera image. Sim version is available as OffWorldMonolithDiscreteSim-v0.
OffWorldMonolithContinousReal-v0 OffWorldMonolithContinousReal-v0 Wheeled robot on an uneven terrain. Two continuous actions: angular velocity, linear velocity. State space is RGB and/or Depth camera image. Sim version is available as OffWorldMonolithContinousSim-v0.
OffWorldMonolithObstacleDiscreteReal-v0 OffWorldMonolithObstacleDiscreteReal-v0 Wheeled robot on an uneven terrain with obstacles. Four discrete actions: left, right, forward, back. State space is RGB and/or Depth camera image. Sim version is available already now as OffWorldMonolithObstacleDiscreteSim-v0.
OffWorldMonolithObstacleContinousReal-v0 OffWorldMonolithObstacleContinousReal-v0 Wheeled robot on an uneven terrain with obstacles. Two continuous actions: angular velocity, linear velocity. State space is RGB and/or Depth camera image. Sim version is available already now as OffWorldMonolithObstacleContinousSim-v0.

Getting access to OffWorld Gym

The main purpose of OffWorld Gym is to provide you with easy access to a physical robotic environment and allow you to train and test your algorithms on a real robotic system. To get access to the real robot, head to our web portal gym.offworld.ai and do the following:

  • Register as a user at gym.offworld.ai.
  • Book your experiment using the OffWorld Gym resource management system.
  • Once you install the offworld_gym library, copy "OffWorld Gym Access Token" from your Profile page into OFFWORLD_GYM_ACCESS_TOKEN variable in your offworld-gym/scripts/gymshell.sh script.

The setup is complete! Now you can:

You can now install the offworld_gym library. Please follow the instructions in the Installation section of this documentation. Then proceed to the Examples.

Installation

Please check the Installation section of the documentation for the instructions.

Examples

For a short example of how to connect to the real robot and interact with it please have a look at the Minimal example in the Real environment.

We also provide examples where and agent achieves learning in both the real and the simulated environment. We use a slightly modified version of Keras-RL library that allows us to make the training process resumable after an interruption. This is something that happens quite often when training in real. A set of utils allows you to visualize additional information on a TensorBoard. The offworld_gym library itself does not depend on these tools - you can ignore them, build on top of them or use them for inspiration. Keras-RL was our choice but you can use any other framework when developing your RL agents.

See the Examples section of the Docs for more details.

About

OffWorld Gym client library

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 85.3%
  • Shell 8.2%
  • CMake 4.3%
  • Dockerfile 2.2%