ReLearn: AI Game Platform

ReLearn is a project aimed at exploring and understanding how reinforcement learning models work by implementing them in basic games. The platform currently features games like Snake, Tic Tac Toe, and Flappy Bird, allowing users to engage with AI-driven gameplay.

Getting Started

Prerequisites

• Python 3.10

Setting Up the Virtual Environment

1. Create a new virtual environment:

   python -m venv rl_env

2. Activate the virtual environment:
   • On macOS and Linux:

     source rl_env/bin/activate

   • On Windows:

     .\rl_env\Scripts\activate

Installing Dependencies

Once the virtual environment is activated, install the required packages using the requirements.txt file:

pip install -r requirements.txt

Project Structure

• relearn.py: Main entry point for the ReLearn app.
• SnakeGame/: Contains the implementation of the Snake game and related AI.
• TicTacToeGame/: Contains the implementation of the Tic Tac Toe game and related AI.
• FlappyBirdGame/: Contains the implementation of the Flappy Bird game and related AI.
• Icons/: Contains icons used in the game interface.
• Models/: Contains the pretrained models for the given games.

Running the Project

To start the ReLearn platform, run the following command in your terminal:

python relearn.py

Games Available

1. Snake Game: Play against an AI agent that learns how to play through reinforcement learning.
2. Tic Tac Toe: Challenge an AI agent in this classic game.
3. Flappy Bird: Experience the popular Flappy Bird game with a Dueling DQN agent.

Download Executables

If you prefer not to run the code manually, you can download the pre-compiled executables for Windows and MacOS from the Releases Section of this repository.

Head over to the Releases section and download the version 0.1 files for your operating system.