https://github.com/fahadelahikhan/smartbudget-tracker
A Python-based app for tracking expenses, managing budgets, and maintaining financial balance.
https://github.com/fahadelahikhan/smartbudget-tracker
budget-planner budget-tracking expense-manager expense-tracking finance-tracker financial-app financial-planning money-management open-source personal-finance python-app saving-tracker
Last synced: about 1 month ago
JSON representation
A Python-based app for tracking expenses, managing budgets, and maintaining financial balance.
- Host: GitHub
- URL: https://github.com/fahadelahikhan/smartbudget-tracker
- Owner: fahadelahikhan
- License: mit
- Created: 2024-08-23T16:44:25.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2025-03-13T09:47:39.000Z (about 2 months ago)
- Last Synced: 2025-03-13T10:35:00.632Z (about 2 months ago)
- Topics: budget-planner, budget-tracking, expense-manager, expense-tracking, finance-tracker, financial-app, financial-planning, money-management, open-source, personal-finance, python-app, saving-tracker
- Language: Python
- Homepage:
- Size: 1000 Bytes
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# SmartBudget Tracker 💰
A command-line budget tracking application that helps users manage their expenses and monitor their budget.
## 📜 About
This project implements a simple budget tracking system that allows users to add expenses, view their budget details, and track their remaining balance. It's an excellent example of basic financial management principles and data persistence using JSON files.
## ✨ Features
- Add expenses with descriptions and amounts
- Track total spending and remaining budget
- Persistent data storage using JSON
- Simple command-line interface
- Budget details display with expense breakdown
## 🚀 Quick Start
### Installation
1. Clone the repository:
```bash
git clone https://github.com/fahadelahikhan/SmartBudget-Tracker.git
cd SmartBudget-Tracker
```
2. Run the application:
```bash
python main.py
```
### Basic Usage
```python
# Initialize budget and expenses
initial_budget = 1000.0
expenses = []
# Add an expense
add_expense(expenses, "Groceries", 150.0)
# Calculate remaining budget
remaining = get_balance(initial_budget, expenses)
print(f"Remaining budget: {remaining}") # Output: Remaining budget: 850.0
# Display all budget details
show_budget_details(initial_budget, expenses)
```
### Example Budget Management
```python
# Load existing budget data
initial_budget, expenses = load_budget_data('budget_data.json')
# Add multiple expenses
add_expense(expenses, "Rent", 500.0)
add_expense(expenses, "Utilities", 100.0)
add_expense(expenses, "Dining", 75.0)
# Calculate and display remaining budget
remaining = get_balance(initial_budget, expenses)
print(f"Remaining budget after expenses: {remaining}")
# Save updated budget data
save_budget_details('budget_data.json', initial_budget, expenses)
```
## 📖 How It Works
The budget tracker works by:
1. Loading existing budget data from a JSON file
2. Allowing users to add expenses with descriptions and amounts
3. Calculating total expenses and remaining budget
4. Displaying budget details including all expenses
5. Saving updated budget data back to the JSON file
The application uses simple arithmetic operations to track expenses and calculate remaining budget:
```
remaining_budget = initial_budget - sum_of_all_expenses
```
## ⚖️ License
Distributed under the MIT License. See [LICENSE](LICENSE) for details.
---
> **Note**: This implementation is for educational and personal finance management purposes. For more complex financial tracking needs, consider using established accounting software with robust security and backup features.