Skip to content

Repository files navigation

💰 FinFlow — AI-Powered Personal Finance Tracker for Gig Workers

🔗 Live Demo: https://project-root-wx8n.onrender.com/


🚀 Project Vision

FinFlow is a personal finance web application designed to help gig workers manage and optimize their irregular incomes and expenses.

Key Goals

  1. Baseline Expense Prediction
    Predict a smart baseline of essential monthly expenses using machine learning to guide users on ideal spending based on their income.

  2. Expense vs Baseline Comparison
    Show if actual expenses exceed the predicted baseline, highlight inefficient spending, and suggest savings.

  3. Savings Insights & Recommendations
    Provide actionable insights for better financial decisions using ML-powered recommendations.

  4. Comprehensive Dashboard
    Display real-time income, expenses, predicted baseline, and savings summary.


💡 Key Features

  • Predict baseline expenses from income and categorized expenses
  • Visual dashboard showing income, expenses, predicted baseline, and savings
  • Status message indicating financial health
  • Actionable recommendations for efficient spending
  • Data persistence with MongoDB
  • Integration with Python ML microservice

⚡ Tech Stack

  • Frontend: Node.js, Express.js, EJS, Bootstrap 5
  • Backend: MongoDB, Mongoose, Axios
  • ML Service: Python, FastAPI, scikit-learn, pandas, numpy
  • Deployment: Render.com

🔧 Quick Start

1️⃣ MoneyGoals Setup

cd moneygoals npm install npm run dev

text

2️⃣ Hackodisha ML Model Setup

cd Hackodisha python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate pip install -r requirements.txt python generate_all_pickles.py python app.py

text


🌟 Live Deployment


🎯 Future Vision

FinFlow aims to offer:

  • AI-powered personalized financial advice
  • Smart recommendations to turn unstable income into consistent savings
  • Clear visual insights for optimized financial habits

📞 Contact

For support, contact:
✉️ pitrodayash1412007@gmail.com

About

MoneyGoals is a full-stack personal finance tracker that helps users manage income and expenses while leveraging machine learning predictions to optimize budgeting and savings. Built with Node.js, Express, MongoDB, and a Python ML API, it offers an intuitive dashboard and expense management.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages