MathResearchIA / README.md
AdelMessaoudi-13's picture
πŸš€ Math Research AI
1ba1ba2
---
title: MathResearchIA
emoji: πŸ’¬
colorFrom: yellow
colorTo: purple
sdk: gradio
sdk_version: 5.23.3
app_file: app.py
pinned: false
license: mit
---
# πŸ“š MathResearchIA
**MathResearchIA** makes learning mathematics easier by making key concepts accessible to everyone through clear and simplified explanations.
This project provides a user-friendly interface to explore **mathematical concepts** (e.g., *Fourier transform*, *Lie group*, *Lebesgue integral*, etc.) using summaries generated from Wikipedia articles.
---
## ✨ Key Features
- πŸ” **Smart filtering**: detects whether the topic is mathematical (via an autonomous AI agent).
- πŸ“– **Wikipedia search**: retrieves the full article related to the concept.
- 🧠 **AI-generated summary**: provides a clear and simplified explanation (powered by Gemini Flash).
- 🌐 **Source included**: each response includes a link to the corresponding Wikipedia article.
- ❌ **Explicit rejection**: if the topic is not mathematical, the query is rejected with a helpful message.
---
## πŸš€ How It Works
1. Enter a **mathematical concept** (e.g., "Fourier transform").
2. The autonomous AI agent checks whether it's a math-related topic.
3. If valid:
- The Wikipedia article is retrieved.
- A simplified summary is generated.
- The source is displayed.
4. Otherwise, the query is rejected with a message inviting you to correct or rephrase.
---
## πŸ§ͺ Tech Stack
- Python
- Gradio (web interface)
- `wikipedia-api` (for article retrieval)
- Gemini Flash (AI summarization)
- Autonomous agent (intelligent filtering)
---
## πŸ“Œ Project Purpose
This project explores the use of **autonomous agents** in focused AI applications, while also democratizing mathematics through clear, pedagogical, and reliable explanations.
---
## πŸ™Œ Contributions
Suggestions, ideas, and feedback are welcome! Feel free to fork the project, open a pull request, or contact me by [email](mailto:amessaoudi.am@gmail.com).
---
## πŸ”’ Note
**MathResearchIA** handles **mathematical concepts only**. If your input is rejected, check for typos or try rephrasing it for better detection.
---
✨ *A personal project by Adel Messaoudi – at the intersection of mathematics, pedagogy, and artificial intelligence.*