Adaptive Code Debugging Game

Project Objectives

This project aims to develop an adaptive educational platform focused on improving Python code debugging skills. Key objectives include:

• Adaptive Learning: Implement a dynamic difficulty adjustment system using the Upper Confidence Bound (UCB) reinforcement learning algorithm to tailor debugging challenges to individual learner performance.
• Gamification: Integrate game mechanics (points, badges, streaks, avatars, themed maps) to enhance learner engagement, motivation, and persistence.
• Personalized Feedback: Provide immediate feedback on debugging attempts and offer hints to guide learners.
• Skill Development: Create an engaging environment to improve the efficiency and effectiveness of debugging skill development in computer science education.
• Research: Investigate how reinforcement learning and personalization algorithms in a gamified system can improve engagement and optimize learning outcomes during adaptive debugging tasks.

How to Run the Project

Prerequisites

• Python 3.x
• Node.js and npm

Intructions to run the web application

1. Navigate to the frontend directory:

   cd sp25-adaptive-code-debugging-game/adaptive-code-debugging

2. Environment Variables: Create a .env file in the root directory of the frontend and add the following variables:

   REACT_APP_BACKEND_URL=http://localhost:5000/api

3. Install dependencies:

   npm install

4. Environment Variables: Create a .env file in the root directory of the frontend and add the following variables:

   VITE_API_BASE_URL="https://adaptivebackend.onrender.com/api"

5. Run the frontend:

   npm start

   The frontend application should now be accessible in your browser, typically at http://localhost:3000.

Deployed Versions

• Frontend: link
• Backend API: link