https://github.com/harshavinjamuri/personal-budget-tracker
https://github.com/harshavinjamuri/personal-budget-tracker
budget-management budget-tracker coding-raja-technologies internship-task python
Last synced: 7 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/harshavinjamuri/personal-budget-tracker
- Owner: HARSHAVINJAMURI
- Created: 2024-01-24T11:46:50.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-01-30T14:10:16.000Z (9 months ago)
- Last Synced: 2025-02-10T15:19:11.049Z (8 months ago)
- Topics: budget-management, budget-tracker, coding-raja-technologies, internship-task, python
- Language: Python
- Homepage:
- Size: 2.93 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 💰 Personal Budget Tracker
A **command-line budget tracker** to manage income, track expenses, analyze spending, and calculate the remaining budget.
---
## 🚀 Features
- **Add Income**: Record income with amount and category.
- **Add Expense**: Track expenses with amount and category.
- **Calculate Remaining Budget**: View your available balance.
- **Analyze Expenses**: Get a breakdown of spending by category.
- **Persistent Storage**: Transactions are saved in a JSON file.
---
## 🛠️ Installation & Usage
### 📌 Prerequisites
- Python 3.x installed on your system.
### 🔧 Setup
1. **Clone the repository**:
```sh
git clone https://github.com/YOUR_GITHUB_USERNAME/YOUR_REPO_NAME.git
cd YOUR_REPO_NAME
2. **Run the script**:
```
python budget_tracker.py
```
---
## 📜 How to Use
When you run the script, you will see a command menu:
Budget Tracker Menu:
1. Add Income
2. Add Expense
3. Calculate Remaining Budget
4. Analyze Expenses
5. Exit
- 💵 Adding an Income Entry:
- Enter the income amount.
- Provide a category (e.g., Salary, Bonus, Freelance).
- 🛍️ Adding an Expense Entry:
- Enter the expense amount.
- Provide a category (e.g., Rent, Groceries, Entertainment).
- 💰 Calculating Remaining Budget:
- The program will sum total income and total expenses to show the remaining budget.
- 📊 Analyzing Expenses:
- The program will display a category-wise expense breakdown.
# 📂 File Structure
## 📁 Personal-Budget-Tracker
- ┣ 📜 transactions.json # Stores transactions persistently
- ┣ 📜 budget_tracker.py # Main script
- ┗ 📜 README.md # Documentation
## 🤝 Contributing
Feel free to fork the repository and submit pull requests! 🚀
## 📄 License
This project is licensed under the MIT License.
## 💡 Author
- Harshsa
- 📧 vinjamuriharsha123@gmail.com
- 🔗 LinkedIn | GitHub