Skip to content
Snippets Groups Projects
user avatar
Marius Altmaier authored
379c9885
History

🤖 MATH (Math AI Tutoring Helper)

🛠️ Description

MATH is an interactive web application designed to support mathematics learning by allowing users to draw, annotate, and submit tasks. It combines a visual workspace with AI-powered feedback through image, canvas, text and audio input, enabling students to engage with mathematical problems more intuitively and interactively.

🌐 Key Features

  • Drawing & Erasing: Interactive canvas with multiple color options (black, red, blue, yellow) and an eraser tool with a visual cursor indicator.
  • Text Input: Users can type math-related questions or prompts directly into the input field to interact with the AI assistant.
  • Audio Input: Upload spoken math questions to receive hints from the AI system.
  • Camera Input: Take photos of handwritten tasks or visual problem representations and send them to the AI for analysis.
  • Contextual Feedback: The system retains previous inputs to support follow-up questions with contextual understanding.

🔨 Architecture Overview

  • Frontend: Built with HTML and JavaScript, providing drawing tools, input buttons, and media handling.
  • Backend (Flask): Handles incoming image/audio data, communicates with the OpenAI API, and returns relevant feedback.

▶️ How to Use

1. Installation

Clone the repository and install dependencies:

git clone <https://github.com/altmaier/math-ai-tutoring-helper.git>
cd math-ai-tutoring-helper
pip install -r requirements.txt

2. Add Your OpenAI API Key

Create a .env file in the root directory and insert your OpenAI API key like this:

OPENAI_API_KEY=your-api-key-here

3. Start the Application

flask run

4. Access in Browser

Open your browser and go to:

http://127.0.0.1:4000