Skip to content

This repo contains the syllabus of the Hugging Face Deep Reinforcement Learning Course.

License

Notifications You must be signed in to change notification settings

Mxbonn/deep-rl-class

 
 

Repository files navigation

This repository contains the Deep Reinforcement Learning Course mdx files and notebooks. The website is here: https://huggingface.co/deep-rl-course/unit0/introduction?fw=pt





The documentation below is for v1.0 (deprecated)

We're launching a new version (v2.0) of the course starting December the 5th,

The syllabus 📚: https://simoninithomas.github.io/deep-rl-course

Sign up here ➡️➡️➡️ http://eepurl.com/ic5ZUD





The documentation below is for v1.0 (deprecated)

In this free course, you will:

  • 📖 Study Deep Reinforcement Learning in theory and practice.
  • 🧑‍💻 Learn to use famous Deep RL libraries such as Stable Baselines3, RL Baselines3 Zoo, and RLlib.
  • 🤖 Train agents in unique environments such as SnowballFight, Huggy the Doggo 🐶, and classical ones such as Space Invaders and PyBullet.
  • 💾 Publish your trained agents in one line of code to the Hugging Face Hub. But also download powerful agents from the community.
  • 🏆 Participate in challenges where you will evaluate your agents against other teams.
  • 🖌️🎨 Learn to share your own environments made with Unity and Godot.

The best way to keep in touch is to join our discord server to exchange with the community and with us 👉🏻 https://discord.gg/aYka4Yhff9

Are you new to Discord? Check our discord 101 to get the best practices 👉 https://github.com/huggingface/deep-rl-class/blob/main/DISCORD.Md

And don't forget to share with your friends who want to learn 🤗!

The Syllabus 🏗️

This course is self-paced you can start when you want 🥳.

📆 Publishing date 📘 Unit 👩‍💻 Hands-on
Published 🥳 An Introduction to Deep Reinforcement Learning Train a Deep Reinforcement Learning lander agent to land correctly on the Moon 🌕 using Stable-Baselines3
Published 🥳 Bonus
Published 🥳 Q-Learning Train an agent to cross a Frozen lake ⛄ and train an autonomous taxi 🚖.
Published 🥳 Deep Q-Learning Train a Deep Q-Learning agent to play Space Invaders using RL-Baselines3-Zoo
Published 🥳 Bonus: Automatic Hyperparameter Tuning using Optuna
Published 🥳 🎁 Learn to train your first Unity MLAgent Train a curious agent to destroy Pyramids 💥
Published 🥳 Policy Gradient with PyTorch Code a Reinforce agent from scratch using PyTorch and train it to play Pong 🎾, CartPole and Pixelcopter 🚁
Published 🥳 Towards better explorations methods with Curiosity
Published 🥳 Advantage Actor Critic (A2C) Train a bipedal walker and a spider to learn to walk using A2C
Published 🥳 Proximal Policy Optimization (PPO) Code a PPO agent from scratch using PyTorch and bulletproof it with Classical Control Environments
Published 🥳 Decision Transformers and offline Reinforcement Learning Train your first Offline Decision Transformer model from scratch to make a half-cheetah run

The library you'll learn during this course

Version 1.0 (current):

Version 2.0 (in addition to SB3, RL-Baselines3-Zoo and CleanRL):

The Environments you'll use

Custom environments made by the Hugging Face Team using Unity and Godot

Environment Screenshot
Huggy the Doggo 🐶 (Based on Unity's Puppo the Corgi work) lunarlander.gif
SnowballFight ☃️ 👉 Play it here: https://huggingface.co/spaces/ThomasSimonini/SnowballFight snowballfight.gif

Gym classic and controls environments 🕹️

Environment Screenshot
Lunar Lander 🚀🌙 lunarlander.gif
Frozen Lake ⛄ frozenlake.gif
Taxi 🚖 taxi.gif
Cartpole cartpole.jpg
Pong 🎾 pong.jpg
Pixelcopter 🚁 pong.jpg

Gym Atari environments 👾

Environment Screenshot
Space Invaders 👾 spaceinvaders.gif
Breakout breakout.gif
Qbert qbert.gif
Seaquest seaquest.gif

PyBullet 🤖

Environment Screenshot
Ant Bullet antbullet.gif
Walker 2D Bullet walker2d.gif

MLAgents environments 🖌️

  • More to come 🚧

  • More to come 🚧

Prerequisites

  • Good skills in Python 🐍
  • Basics in Deep Learning and Pytorch

If it's not the case yet, you can check these free resources:

FAQ

Is this class free?

Yes, totally free 🥳.

Do I need to have a Hugging Face account to follow the course?

Yes, to push your trained agents during the hands-on, you need an account (it's free) 🤗.

You can create one here 👉 https://huggingface.co/join

What’s the format of the class?

The course consists of 8 Units. In each of the Units, we'll have:

  • A theory explained part: an article and a video (based on Deep Reinforcement Learning Course)
  • A hands-on Google Colab where you'll learn to use famous Deep RL libraries such as Stable Baselines3, RL Baselines3 Zoo, and RLlib to train your agents in unique environments such as SnowballFight, Huggy the Doggo 🐶, and classical ones such as Space Invaders and PyBullet.
  • Some optional challenges: train an agent in another environment, and try to beat the results.

It's not a live course video, so you can watch and read each unit when you want 🤗 You can check the syllabus here 👉 https://github.com/huggingface/deep-rl-class

What I will do during this course?

In this free course, you will:

  • 📖 Study Deep Reinforcement Learning in theory and practice.
  • 🧑‍💻 Learn to use famous Deep RL libraries such as Stable Baselines3, RL Baselines3 Zoo, and RLlib.
  • 🤖 Train agents in unique environments such as SnowballFight, Huggy the Doggo 🐶, and classical ones such as Space Invaders and PyBullet.
  • 💾 Publish your trained agents in one line of code to the Hub. But also download powerful agents from the community.
  • 🏆 Participate in challenges where you will evaluate your agents against other teams.
  • 🖌️🎨 Learn to share your own environments made with Unity and Godot.

Where do I sign up?

Here 👉 http://eepurl.com/h1pElX

Where can I find the course?

On this repository, we'll publish every week the links (chapters, hands-ons, videos).

Where can I exchange with my classmates and with you?

We have a discord server where you can exchange with the community and with us 👉🏻 https://discord.gg/aYka4Yhff9

Don’t forget to introduce yourself when you sign up 🤗

I have some feedback

We want to improve and update the course iteratively with your feedback. If you have some, please fill this form 👉 https://forms.gle/3HgA7bEHwAmmLfwh9

How much background knowledge is needed?

Some prerequisites:

Good skills in Python 🐍 Basics in Deep Learning and Pytorch

If it's not the case yet, you can check these free resources:

Is there a certificate?

Yes 🎉. You'll need to upload the eight models with the eight hands-on.

Citing the project

To cite this repository in publications:

@misc{deep-rl-class,
  author = {Simonini, Thomas and Sanseviero, Omar},
  title = {The Hugging Face Deep Reinforcement Learning Class},
  year = {2022},
  publisher = {GitHub},
  journal = {GitHub repository},
  howpublished = {\url{https://github.com/huggingface/deep-rl-class}},
}

About

This repo contains the syllabus of the Hugging Face Deep Reinforcement Learning Course.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Jupyter Notebook 100.0%