---

💡 Why AI Money Mentor?

95% of people have no financial plan.
Financial advisors cost $200–$400/hour.
AI Money Mentor costs nothing and is always available.

A 24/7 AI-powered personal CFO for everyone — students, professionals, and families alike. It thinks, plans, and advises so you don't have to guess with your money.

---

✨ Features

🧠 AI Chat Ask anything in plain English. Get expert financial answers instantly.	📊 Expense Tracker Log daily transactions with smart auto-categorization.	💡 Smart Budget AI-generated monthly plans tailored to your goals.	📈 Investments SIP, stocks & savings recs based on your risk profile.
🧾 Reports Weekly & monthly analysis with visual spending trends.	🔔 Smart Alerts Bill reminders & overspending notifications.	🔐 Privacy First Encrypted, local-first. Your data stays yours.	🌍 Always On No appointments. No closing hours. Ever.

---

🏗️ Architecture

┌─────────────────────────────────────────────────────────┐
│                    AI MONEY MENTOR                      │
└─────────────────────────────────────────────────────────┘
         │
         ▼
  ┌──────────────┐    HTTP     ┌─────────────────┐
  │  Frontend    │ ──────────► │  Flask Backend  │
  │  HTML/CSS/JS │ ◄────────── │  Python Server  │
  └──────────────┘             └────────┬────────┘
                                        │
                          ┌─────────────┼────────────┐
                          ▼             ▼             ▼
                   ┌────────────┐ ┌──────────┐ ┌──────────┐
                   │  Groq AI   │ │  OpenAI  │ │ Database │
                   │    LLM     │ │   API    │ │  SQLite  │
                   └────────────┘ └──────────┘ └──────────┘

---

⚙️ Tech Stack

Layer	Technology
Frontend
Backend
AI Engine
Database

---

🚀 Quick Start

# Clone
git clone https://github.com/omroy07/AI-Money-Mentor.git
cd AI-Money-Mentor

# Virtual environment
python -m venv venv
source venv/bin/activate          # Linux/macOS
# venv\Scripts\activate           # Windows

# Install production dependencies
pip install -r requirements.txt

# Install development dependencies (for contributors / running tests)
pip install -r requirements.txt -r requirements-dev.txt

# Configure environment
cp .env.example .env
# Add your GROQ_API_KEY to .env

# Run
python app.py
# → http://localhost:5000

---

🧪 Testing

Make sure you've installed dev dependencies: pip install -r requirements.txt -r requirements-dev.txt

pytest                        # Full suite
pytest -v                     # Verbose
pytest tests/test_tax.py -v   # Specific file
pytest --cov=app tests/       # With coverage

---

📁 Project Structure

AI-Money-Mentor/
├── static/
│   ├── css/           ← Stylesheets
│   ├── js/            ← JavaScript
│   └── assets/        ← Images & icons
├── templates/         ← Jinja2 HTML
├── tests/
│   └── test_tax.py    ← Pytest suite
├── app.py             ← Flask entry point
├── requirements.txt
├── .env.example
└── README.md

---

🗺️ Roadmap

Status	Feature
✅	AI Chat Assistant
✅	Expense Tracker + Auto-Categorization
✅	Smart Budget Planner
✅	Investment Suggestions
✅	Financial Reports (Weekly/Monthly)
✅	Smart Alerts & Bill Reminders
🚧	Mobile App (Android & iOS)
🚧	Voice-Based AI Assistant
🔜	Multi-Language Support
🔜	Bank API Integration
🔜	Advanced Portfolio Tracker
💡	Multi-Agent AI System
💡	Tax Optimization Module
💡	Crypto & DeFi Dashboard

---

🐛 Issues & Feedback

Found a bug or have a feature request? Open an issue — contributions and feedback are always welcome!

 

---

🤝 Contributing

# Fork → Branch → Commit → PR

git checkout -b feature/amazing-feature
git commit -m "✨ Add amazing feature"
git push origin feature/amazing-feature
# Open a Pull Request on GitHub

---

📊 Impact

📉 Reduces Financial Illiteracy	💰 Builds Saving Habits	📈 Smarter Investments	🧠 Accessible to All

---

🏆 ELUSOC 2026

---

📜 License

MIT License © 2025 Om Roy — free to use, modify, and distribute.

---

Made with ❤️ to democratize financial intelligence for everyone.