README.md

---
title: Math Tools
emoji: 🧮
colorFrom: blue
colorTo: indigo
sdk: gradio
sdk_version: "5.32.1"
app_file: app.py
pinned: false
---

[![Python](https://img.shields.io/badge/python-3.8%2B-blue.svg)](https://www.python.org/downloads/) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)

## Overview

Math Tools is a suite of interactive mathematical calculators and solvers, organized by topic (Algebra, Calculus, Differential Equations, etc.) and built with Python and Gradio. It is designed for students, educators, and anyone needing quick, visual math solutions.

---

## Features

- **Arithmetic**: Addition, Subtraction, Multiplication, Division, Array Calculations (with visualization)
- **Number Theory**: GCD, LCM, Prime Checker
- **Algebra**: Expression Evaluation, Radical Simplification, Polynomial Operations
- **Equations**: Solvers for Linear, Quadratic, Trigonometric, and Linear Systems
- **Geometry**: Trigonometric Functions, Inverse Trigonometry, Identities
- **Calculus**: Derivatives, Integrals, Limits, Taylor & Fourier Series, Partial Derivatives, Multiple Integrals
- **Differential Equations**: First- and Second-Order ODE Solvers
- **Matrices**: Addition, Subtraction, Multiplication, Determinant, Inverse
- **Vectors**: Addition, Subtraction, Dot Product, Cross Product
- **Operations Research**: Branch & Bound, Dual Simplex, Simplex Solver Steps

---

## Getting Started

### Installation

1. **Clone the repository:**

   ```bash
   git clone https://github.com/yourusername/math-tools.git
   cd math-tools
   ```

2. **Install dependencies:**

   ```bash
   pip install -r requirements.txt
   ```

3. **Run the app:**

   ```bash
   python app.py
   ```

### Usage

- Open the app in your browser (Gradio will provide a local URL).
- Select a topic tab and use the calculators or solvers interactively.

---

## Project Structure

```text
counting/
├── app.py                              # Main Gradio application with topic-based tabs
├── requirements.txt                    # Python dependencies
├── README.md                           # Project documentation (this file)
└── maths/                              # Mathematical modules organized by topic
    ├── arithmetic/                     # Arithmetic logic & interfaces
    ├── number_theory/                  # Number theory logic & interfaces
    ├── algebra/                        # Algebra logic & interfaces
    ├── equations/                      # Equation solvers & interfaces
    ├── geometry/                       # Trigonometry & geometry logic & interfaces
    ├── calculus/                       # Calculus logic & interfaces
    ├── differential_equations/         # ODE solvers & interfaces
    ├── matrices/                       # Matrix operations logic & interfaces
    ├── vectors/                        # Vector operations logic & interfaces
    └── operations_research/            # Operations research solvers & interfaces
```

---

## Example

![Math Tools Screenshot](docs/screenshot.png)

---

## Contributing

Contributions are welcome! To contribute:

1. Fork this repository
2. Create a new branch (`git checkout -b feature/your-feature`)
3. Commit your changes
4. Open a pull request

---

## License

This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.