Skip to content

README.md

Latest commit

 

History

History
71 lines (49 loc) · 1.61 KB

README.md

File metadata and controls

71 lines (49 loc) · 1.61 KB
Raw

SpendGood 💰

AI-Powered Personal Budgeting & Analytics Platform

A full-stack web application that helps you track expenses, manage budgets, and predict future spending using machine learning and AI.

🚀 Live Demo

✨ Features

  • 🔐 Secure Authentication — JWT-based login and registration
  • 📊 Interactive Dashboard — Real-time spending overview with charts
  • 💸 Expense Management — Add, edit, delete with filters and search
  • 🤖 AI Bank Statement Import — Upload PDF/CSV and AI auto-categorizes transactions using Groq LLaMA 3.3 70B
  • 💰 Budget Management — Set monthly limits per category with visual progress
  • 🔮 ML Predictions — Predict next month's spending using scikit-learn Linear Regression
  • 🌙 Dark Mode — Full dark/light theme support
  • 📅 Month Selector — View any previous month's data
  • 📤 CSV Export — Download all expenses as CSV

🏗️ Architecture

🛠️ Tech Stack

Frontend

  • React 18 + TypeScript
  • Tailwind CSS
  • Redux Toolkit
  • React Hook Form + Zod
  • Axios

Backend

  • Node.js + Express.js
  • JWT + bcryptjs
  • PostgreSQL
  • Multer
  • Groq SDK

ML Microservice

  • Python + FastAPI
  • scikit-learn (Linear Regression)
  • pandas + numpy
  • Pydantic

AI Integration

  • Groq API (LLaMA 3.3 70B) for bank statement parsing

🚀 Local Development

1. Clone the repository

git clone https://github.com/rr-code/SpendGood.git
cd SpendGood

2. Backend Setup

cd spendgood-backend
npm install

Create .env: