README.md

metadata

title: Math Problem Solver
emoji: 🧮
colorFrom: blue
colorTo: indigo
sdk: streamlit
sdk_version: 1.32.2
app_file: app.py
pinned: false

🧮 Math Problem Solver

Overview

Math Problem Solver is an AI-powered Streamlit application that helps users solve mathematical problems with step-by-step explanations. The application uses Groq's AI models (including Google Gemma 2) to provide detailed solutions to a wide range of mathematical topics.

Getting Started

Prerequisites

• Python 3.8+
• Groq API key (get one at console.groq.com)

Installation

1. Clone this repository:

   git clone https://github.com/yourusername/math-problem-solver.git
   cd math-problem-solver
   

2. Install dependencies:

   pip install -r requirements.txt
   

3. Create a .env file in the project root and add your Groq API key:

   GROQ_API_KEY=your_api_key_here
   

4. Run the application:

   streamlit run app.py
   

5. Open your browser and navigate to http://localhost:8501

Usage

1. Enter your Groq API key in the sidebar (if not already set in .env)
2. Select your preferred AI model
3. Type your math problem in the text area or choose from the example problems
4. Click "Solve Problem" to get a detailed solution
5. Review the step-by-step explanation

Example Problems

• Solve for x: 2x + 5 = 15
• Find the area of a circle with radius 4 cm
• If a train travels at 60 mph and takes 3 hours to reach its destination, how far did it travel?
• Word problems involving multiple operations and conversions

Technical Details

This application uses:

• Streamlit: For the web interface
• LangChain: For agent orchestration and tool integration
• Groq API: For AI model inference
• Google Gemma 2: Primary AI model for solving math problems
• Wikipedia API: For foundational knowledge
• arXiv API: For academic mathematical concepts
• DuckDuckGo Search: For web search capabilities

The application uses a zero-shot agent that strategically chooses which tool to use based on the problem type.

Advanced Configuration

In the "Advanced Options" section of the sidebar, you can:

• Adjust the temperature (creativity) of the AI responses
• Toggle the visibility of AI reasoning steps
• Select different models for different types of problems

Development

Project Structure

math-problem-solver/
├── app.py                  # Main application file
├── .env                    # Environment variables (git-ignored)
├── requirements.txt        # Dependencies
├── README.md               # Project documentation
├── LICENSE                 # MIT License
├── screenshots/            # App screenshots
│   └── app_screenshot.png  # Main app screenshot
└── .gitignore              # Git ignore configuration