DeepRacer Gym

A Gymnasium wrapper for the AWS DeepRacer simulator. Each deepracer-v0 environment automatically launches its own containerized simulator (Docker/Podman/Apptainer), then exposes it through the standard gymnasium API.

Install

Requirements:

• Python 3.12+
• Linux (tested on Ubuntu 20.04+), macOS, or Windows (via WSL2)
• A container runtime: Docker, Podman, or Apptainer (e.g. for rootless runs on HPC)
• Sufficient hardware resources (recommended ~3 CPUs, ~6 GB RAM per environment)

pip install deepracer

Quick Start

import gymnasium as gym
import deepracer

env = gym.make("deepracer-v0")      # starts a simulator service on demand

observation, info = env.reset()

observation, reward, terminated, truncated, info = env.step(
    env.action_space.sample()
)

env.close()                         # stops + removes the simulator service

See the full documentation for details.