🚀 MammoMate

Team Name: FantomForce
Hackathon: FantomCode 2025
Date: 12/04/2025

---

📖 Table of Contents

1. Introduction
2. Problem Statement
3. Solution Overview
4. Tech Stack
5. Architecture / Diagram (if any)
6. Installation & Usage
7. Team Members

---

🧠 Introduction

MammoMate is an AI-powered breast cancer awareness and support app designed especially for women in India. It offers tools to self-examine, track symptoms, access curated health content in regional languages, and engage with a supportive community — all in one place. MammoMate strives to empower early detection, informed decision-making, and emotional resilience through multilingual GenAI.

---

❗ Problem Statement

Breast cancer awareness in India remains alarmingly low — especially in rural and regional populations. Early detection can significantly reduce fatality rates, yet cultural stigma, language barriers, and lack of access to verified health resources delay diagnosis. There’s a pressing need for a private, accessible, tech-assisted companion to raise awareness and assist users in taking early action.

---

✅ Solution Overview

MammoMate addresses these issues with an all-in-one platform offering:

• 🤖 GenAI-powered multilingual chatbot (English, Hindi, Kannada, Malayalam)
• 🩺 ML-based self-exam and symptom checker
• 🗺️ Nearby hospital locator using GIS
• 🗣️ Community discussion forum for peer support
• 📄 Auto-summarized educational articles with TTS
• 🔔 Reminders for regular breast self-examinations

All features are available even in guest mode, ensuring accessibility without the friction of sign-ups.

---

🛠️ Tech Stack

• Frontend: Streamlit
• Backend: Python (Streamlit server)
• Database: Supabase (PostgreSQL-based)
• APIs / Libraries:
  • Groq API (LLM for chatbot and summarization)
  • Google Maps API (hospital locator)
  • PyMuPDF (PDF text extraction)
  • Tesseract OCR (image-based text extraction)
  • Matplotlib & Seaborn (data visualization)
  • Pandas (data manipulation)
• Tools: GitHub, Figma, Python-dotenv

---

🧩 Architecture / Diagram (if any)

Modular structure with language translation, AI chat, symptom checker, and community forum, all routed via Streamlit.

---

🧪 Installation & Usage

Prerequisites

• Python 3.9+
• A .env file and '.toml' file with keys for:
  • GROQ_API_KEY
  • SUPABASE_URL
  • SUPABASE_KEY
  • GOOGLE_MAPS_API_KEY

Steps

# Clone the repository
git clone https://github.com/your-repo-url.git

# Navigate into the project directory
cd MammoMate

# Create virtual environment
python3 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies
pip install -r [requirements.txt](http://_vscodecontentref_/0)

# Run the app
streamlit run [dashboard.py](http://_vscodecontentref_/1)