Skip to content
Branch: master
Find file History
sunil19m and saurabh3949 Downloading the latest simapp from s3 (#992)
Notebook now supports the new simapp. Changing the location of s3 to download the latest simapp

Locally tested
Latest commit 0ff291b Jan 18, 2020

DeepRacer notebook using Amazon SageMaker RL and AWS RoboMaker services

This folder contains examples of how to use RL to train an autonomous deepracer. This is a jailbreaker for the AWS DeepRacer. This gives a glimse of architecture used to get the DeepRacer working.


  • deepracer_rl.ipynb: notebook for training autonomous race car.

  • Dockerfile: Custom docker instead of using SageMaker default docker

  • src/

    • Main entrypoint for starting distributed training job
    • markov/: Helper files for S3 upload/download
    • presets/ Preset (configuration) for DeepRacer
    • rewards/ Custom reward function
    • environments/ Gym environment file for DeepRacer
    • actions/model_metadata_10_state.json: JSON file to customize your action space & the speed
    • lib/: redis configuration file and customized tensorflow file copied to sagemaker container.
  • common/: helper function to build docker files.

How to use the notebook

  1. Login to your AWS account - SageMaker service (SageMaker Link)
  2. On the left tab select Notebook instances
  3. Select Create notebook instance
  4. Fill up the notebook instance name. In the Additional configuration select atleast 25GB. This is because docker gets installed and takes up space.
  5. Create a new IAM role. Give root permission
  6. Select the git repository and clone this repository.
  7. Then click create notebook instance button at the button
  8. This takes like 2 min to create your notebook instance. Then click on the newly created instance and click on the juypter notebook.
  9. You will see all the github files and now run deepracer_rl.ipynb
  10. Run clean robomaker & sagemaker commands in the script only when you are done with training.

DeepRacer Paper

A techncial paper for AWS DeepRacer is available at Below is a BibTeX entry for citations:

	title={DeepRacer: Educational Autonomous Racing Platform for Experimentation with Sim2Real Reinforcement Learning},
	author={Bharathan Balaji and Sunil Mallya and Sahika Genc and Saurabh Gupta and Leo Dirac and Vineet Khare and Gourav Roy and Tao Sun and Yunzhe Tao and Brian Townsend and Eddie Calleja and Sunil Muralidhara and Dhanasekar Karuppasamy},
You can’t perform that action at this time.