https://github.com/wdopen-nk/simple-expense-tracker

Built an interactive expense tracker using Python, Streamlit, and Plotly that analyzes uploaded bank statements, performs automatic expense categorization, and provides clear visual insights into user spending behavior.
https://github.com/wdopen-nk/simple-expense-tracker

json pandas plotly pyhton streamlit

Last synced: 2 months ago
JSON representation

Built an interactive expense tracker using Python, Streamlit, and Plotly that analyzes uploaded bank statements, performs automatic expense categorization, and provides clear visual insights into user spending behavior.

• Host: GitHub
• URL: https://github.com/wdopen-nk/simple-expense-tracker
• Owner: wdopen-nk
• License: mit
• Created: 2025-06-23T08:21:33.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2026-03-18T20:07:48.000Z (3 months ago)
• Last Synced: 2026-03-19T08:41:13.851Z (3 months ago)
• Topics: json, pandas, plotly, pyhton, streamlit
• Language: Python
• Homepage:
• Size: 418 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# 💸Expense Tracker App

#### A simple and interactive expense tracker built with Python, Streamlit, Pandas, and Plotly. The app allows users to upload their bank statements, automatically categorize expenses, and visualize spending patterns.

## 🚀 Features

### 📂 Upload Bank Statements

- #### Supports CSV files

- #### Automatically processes transaction data

### 🧠 Smart Expense Categorization

- #### Automatically assigns categories to transactions

- #### Users can add custom categories

### 📊 Interactive Visualizations

- #### Pie charts showing expense distribution

- #### Percentage breakdown using Plotly

### 📈 Payments Summary

- #### Overview of total spending

- #### Category-wise insights

## 📸 Demo

![Dashboard Screenshot](images/Screenshot%20(24).png)

![Dashboard Screenshot](images/Screenshot%202026-03-18%20233406.png)

![Dashboard Screenshot](images/Screenshot%202026-03-18%20233433.png)

![Dashboard Screenshot](images/Screenshot%202026-03-18%20233542.png)

## 📊 How It Works

- ##### The app reads and processes the data using Pandas

- #### Transactions are categorized automatically

- #### You can:

    - #### Edit categories

    - #### Add new ones

- #### Visualizations are generated using Plotly

## ⚙️ Installation

1. #### Clone the repository :

   - ```git clone https://github.com/wdopen-nk/simple-expense-tracker.git```

   

   - ```cd simple-expense-tracker```

2. #### Install dependencies :

    - ```pip install -r requirements.txt```

3. #### Run the app :

    - ```streamlit run main.py```

## 📄 License

- #### This project is licensed under the MIT License.