# 📱 MPESA Finance Tracker
> 🚧 **Work in Progress**: This project is actively being developed. New features and improvements are regularly added. Contributions and feedback are welcome.
## 📊 Overview
The **MPESA Finance Tracker** is a web-based personal finance tool built to help users:
- Parse and analyze MPESA statements (PDF to CSV)
- Categorize transactions (e.g., food, bills, rent)
- Track monthly spending and income
- Visualize financial trends with clean dashboards
The goal is to bring intuitive financial insights to Kenyans using MPESA for everyday transactions.
---
## ⚙️ Features (Planned & In Progress)
- ✅ PDF-to-CSV parser for MPESA statements
- ✅ Basic spending summary
- ✅ Category-based tagging and filtering
- 🔄 Monthly budgeting module (in progress)
- 🔄 Streamlit web interface with Apple-style design (in progress)
- 🔄 AI assistant integration for financial queries (planned)
---
## 🛠️ Tech Stack
- **Python**
- **pandas** & **regex** for data parsing
- **Streamlit** for web interface
- **Plotly** / **Altair** / **Matplotlib** for data visualization
- **Git** + **GitHub** for version control
---
Built for ease of use and financial self-tracking.