https://github.com/sam-a-d/budgetbuddyai

A full-stack web application for tracking personal finances, powered by Spring Boot, Django, React, and Docker. Features AI/ML-driven expense categorization and financial insights.
https://github.com/sam-a-d/budgetbuddyai

django docker microservice reactjs spring-boot

Last synced: about 1 month ago
JSON representation

A full-stack web application for tracking personal finances, powered by Spring Boot, Django, React, and Docker. Features AI/ML-driven expense categorization and financial insights.

• Host: GitHub
• URL: https://github.com/sam-a-d/budgetbuddyai
• Owner: sam-a-d
• License: gpl-3.0
• Created: 2025-02-15T13:10:47.000Z (about 1 year ago)
• Default Branch: master
• Last Pushed: 2025-03-04T23:28:50.000Z (about 1 year ago)
• Last Synced: 2025-05-18T06:40:57.979Z (10 months ago)
• Topics: django, docker, microservice, reactjs, spring-boot
• Language: CSS
• Homepage:
• Size: 614 KB
• Stars: 2
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Budget Buddy - A Personal Budget Tracker

A full-stack web application for tracking personal finances, powered by **Spring Boot**, **Django**, **React**, and **Docker**. Features AI/ML-driven expense categorization and financial insights.

## Features

### Core Features

- **Transaction Management**: Add, edit, or delete income and expenses.

- **Budget Planning**: Set monthly budgets for categories (e.g., groceries, rent).

- **User Authentication**: Secure signup/login using JWT.

- **Dashboard**: Visualize spending trends with charts and tables.

### AI/ML Integrations

- **Smart Expense Categorization**: Auto-categorize transactions using OpenAI or Hugging Face NLP models.

- **Financial Insights**: Forecast future spending/savings using Prophet time-series analysis.

- **Personalized Recommendations**: AI-generated budget tips based on spending habits.

## Tech Stack

### Backend (Spring Boot)

- **Java 23**

- **Spring Boot 3**

- **Spring Security** (JWT Authentication)

- **PostgreSQL** (Database)

- **Docker**

### AI/ML Microservice (Django)

- **Python 3.10**

- **Django REST Framework**

- **OpenAI API** / **Hugging Face Transformers**

- **Prophet** (Time-Series Forecasting)

- **Pandas** (Data Analysis)

### Frontend (React)

- **React 19**

- **Axios** (API Calls)

- **Chart.js** (Data Visualization)

- **React Router** (Navigation)

- **Material-UI** (UI Components)

### Infrastructure

- **Docker Compose** (Multi-container orchestration)

- **NGINX** (Reverse Proxy - Optional for production)

## Installation

### Prerequisites

- Docker and Docker Compose installed.

- OpenAI API key (for expense categorization).

### Steps

1. **Clone the repository**:

   ```bash

   git clone https://github.com/sam-a-d/BuggetBuddyAI

   cd BuggetBuddyAI

## The Dashboard

![image](https://github.com/user-attachments/assets/c5cd4762-b1f2-4a1b-9d26-198d29fc64f8)

** This project is under development