piyushgd21/codecatcher

AI assisted Debugging

โ˜… 0Forks 0PythonGitHub โ†—Compare

README

CodeCatcher Debug Game (Gemini Edition)

This is a Python-based GUI game that helps students debug C++ code with the help of AI-powered hints using Google's Gemini API. It's designed for educational use, where users learn by asking questions rather than being shown direct solutions.

image

๐Ÿ”ง Requirements

Install dependencies from the included requirements.txt file:

pip install -r requirements.txt

Ensure your Python version is 3.8+. tkinter should come pre-installed with standard Python distributions.


๐Ÿš€ How to Run

python codecatcher.py

The game will open as a window where:

  • You'll be shown buggy C++ code
  • You can ask questions or submit answers
  • Gemini will guide you without giving direct fixes
  • Score is tracked based on attempts

๐ŸŒ Internet Required

This app uses Gemini API, so an internet connection is required.

Make sure to insert your API key in the script:

GEMINI_API_KEY = 'your-api-key-here'

๐Ÿ“ Files

  • codecatcher_gui.py โ€“ Main application
  • requirements.txt โ€“ Python dependencies
  • README.md โ€“ This file

๐Ÿง  Author

Piyush Deshpande
AI-Powered Debugging Platform | Purdue University

Happy debugging! ๐Ÿ”๐Ÿง‘โ€๐Ÿ’ป

Contributors

piyushgd21

Issues