https://github.com/atharvbyadav/expensemate
A simple, lightweight personal finance tracker built with Streamlit and SQLite. Log expenses, visualize spending habits, manage budgets, and download reports – all through an interactive web interface.
https://github.com/atharvbyadav/expensemate
budgeting data-analysis data-visualization expense-tracker finance-app open-source pandas personal-finance plotly python sqlite streamlit streamlit-webapp
Last synced: about 1 month ago
JSON representation
A simple, lightweight personal finance tracker built with Streamlit and SQLite. Log expenses, visualize spending habits, manage budgets, and download reports – all through an interactive web interface.
- Host: GitHub
- URL: https://github.com/atharvbyadav/expensemate
- Owner: atharvbyadav
- License: mit
- Created: 2025-03-30T05:54:23.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-06-25T18:24:44.000Z (3 months ago)
- Last Synced: 2025-07-30T04:36:29.330Z (2 months ago)
- Topics: budgeting, data-analysis, data-visualization, expense-tracker, finance-app, open-source, pandas, personal-finance, plotly, python, sqlite, streamlit, streamlit-webapp
- Language: Python
- Homepage: https://expensemate.streamlit.app/
- Size: 27.3 KB
- Stars: 1
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ExpenseMate
## Overview
ExpenseMate is a user-friendly personal finance tracker built using **Streamlit** and **SQLite**. It helps users monitor expenses, analyze spending habits and manage their monthly budget with interactive visualizations.
🚀 **Live Demo**: [ExpenseMate](https://expensemate.streamlit.app/)
🔗 **GitHub Repository**: [ExpenseMate GitHub](https://github.com/atharvbyadav/ExpenseMate)
🌟 If you find this project useful, **please star the repository!** 🌟
---
## Features
### ✅ Add Expenses
- Select the **date** and **time** (12-hour format with AM/PM option).
- Choose an expense **category** (Food, Rent, Transport, etc.).
- Enter **description** and **amount**.
- Store entries in an **SQLite database**.
### ❌ Delete Expenses
- Select any **recorded expense** to delete from the database.
### 📊 View Expense Report
- **View all expenses** in a table format.
- **Pie chart visualization** of expenses by category.
- **Line chart tracking** spending over time.
- **Budget Summary** with total spent and remaining balance.
- **Download expenses report** as a CSV file.
---
## Installation & Usage 🛠️
### 🔹 Prerequisites
Ensure you have **Python 3.x** installed on your system.
### Step 1️⃣ - Clone the Repository
```sh
git clone https://github.com/atharvbyadav/ExpenseMate.git
cd ExpenseMate
```
### Step 2️⃣ - Set Up a Virtual Environment (Recommended)
To prevent package conflicts, create and activate a virtual environment:
```sh
python3 -m venv venv
source venv/bin/activate # On Windows, use: venv\Scripts\activate
```
### Step 3️⃣ - Install Dependencies
Install required dependencies using the provided **requirements.txt** file:
```sh
pip install -r requirements.txt
```
### Step 4️⃣ - Run the Application
```sh
streamlit run ExpenseMate.py
```
The application will open in your default web browser.
---
## Usage Guide
### 🏠 Home Page
- The **sidebar** provides navigation to different sections:
- **Add Expense**
- **View Report**
- **Delete Expense**
- Set your **monthly budget** in the sidebar.
### ➕ Adding an Expense
1. Click **"Add Expense"**.
2. Select **Date** and **Time (12-hour format)**.
3. Choose an **expense category**.
4. Enter **description** and **amount**.
5. Click **"Add Expense"** to save.
### ❌ Deleting an Expense
1. Click **"Delete Expense"**.
2. Select an expense from the dropdown.
3. Click **"Delete"** to remove it.
### 📊 Viewing Reports
- Click **"View Report"**.
- View **expense details, category breakdown and spending trends**.
- **Download** the report as CSV.
---
## Technologies Used
- **Streamlit** - Frontend UI framework
- **SQLite** - Local database for storing expenses
- **Pandas** - Data handling and processing
- **Plotly** - Data visualization (Pie charts, Line graphs)
---
## License
This project is licensed under the **MIT License** - feel free to use and modify it!
---
## Future Enhancements
🚀 **Planned Features**:
- ✅ Advanced filtering and search for expenses
- 📅 Generate monthly & yearly reports
- 📱 Improve UI for mobile users
- 🔔 Add notifications for budget alerts
---
## Contributing
Want to improve ExpenseMate? Contributions are welcome! 🎉
Fork the repo, create a branch and submit a pull request.
---
## Contact
💬 Feel free to reach out on GitHub or open an issue for suggestions and feedback!