AI Math Tutor

An interactive AI-powered math tutor that uses the Socratic method to guide students through solving math problems step-by-step.

Features

• Socratic Teaching Method: The AI guides students with questions rather than giving direct answers
• Step-by-step Problem Solving: Breaks down complex problems into manageable steps
• Multiple Support Options:
  • "Show Solution" button for complete step-by-step solutions
  • "Propose Simpler Problem" for easier practice problems
• Reasoning Question Database: Uses a comprehensive set of reasoning questions to help students think through problems

Setup

1. Install Dependencies:

   pip install -r requirements.txt

2. Get API Key:

   • Go to Google AI Studio
   • Create a new API key for Google Generative AI

3. Configure API Key:

   Option A: Environment Variable

   export GOOGLE_API_KEY='your-api-key-here'

   Option B: .env File Create a .env file in the project directory:

   GOOGLE_API_KEY=your-api-key-here
   

4. Run the App:

   streamlit run app_ver3.py

Usage

1. Enter your math problem in the chat input
2. The AI will guide you through solving it with questions
3. If you get stuck, use the "Show Solution" button for a complete walkthrough
4. Use "Propose Simpler Problem" to practice with easier versions
5. Click "Start a New Problem" to begin fresh

Files

• app_ver3.py: Main application file
• reasoning_questions.csv: Database of reasoning questions used by the AI
• requirements.txt: Python dependencies
• README.md: This file

Security Note

Never commit your API key to version control. Always use environment variables or .env files (which should be added to .gitignore).