Spaces:
Build error
Build error
| 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](https://console.groq.com/keys)) | |
| ### Installation | |
| 1. Clone this repository: | |
| ```bash | |
| git clone https://github.com/yourusername/math-problem-solver.git | |
| cd math-problem-solver | |
| ``` | |
| 2. Install dependencies: | |
| ```bash | |
| 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: | |
| ```bash | |
| 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 | |
| ``` |