An open API service indexing awesome lists of open source software.

https://github.com/marcuwynu23/budget-buddy

A command-line application that helps you calculate and manage your monthly budget. It provides a breakdown of your income and expenses, allowing you to allocate funds efficiently and track your spending.
https://github.com/marcuwynu23/budget-buddy

budgeting cmd cmdline commandline expenses tool

Last synced: about 1 month ago
JSON representation

A command-line application that helps you calculate and manage your monthly budget. It provides a breakdown of your income and expenses, allowing you to allocate funds efficiently and track your spending.

Awesome Lists containing this project

README

        

# budget-buddy

Budget Buddy is a command-line application that helps you calculate and manage your monthly budget. It provides a breakdown of your income and expenses, allowing you to allocate funds efficiently and track your spending.

## Features

- Income Allocation: Calculate the allocation of your income based on predetermined percentages for tithes, love offering, savings, housing rent, and electricity and water bills.
- Weekly Budget Calculation: Determine the amount available for your weekly expenses based on your remaining income after allocations.
- Budget Breakdown: View a detailed breakdown of your income allocations, including the allocated amounts and percentages for each category.
- Total Amount Calculation: Obtain the total amount allocated to tithes, love offering, savings, and remaining funds.
- Personalization: Customize the allocation percentages and expenses to match your financial situation.

## Installation

1. Clone the repository: `git clone https://github.com/marcuwynu23/budget-buddy.git`
2. Navigate to the project directory: `cd budget-buddy`
3. Install the required dependencies: `pip install tabulate`
4. Run the application: `python app.py`

## Usage

1. Enter your monthly salary when prompted.
2. Provide the amount of your housing rent and electricity and water bills.
3. Specify the percentage of your salary that you want to allocate for savings.
4. View the budget breakdown table, displaying the allocation percentages and amounts for tithes, love offering, savings, housing rent, electricity and water bills, remaining funds, and the weekly budget.
5. Note the total amount allocated to tithes, love offering, savings, and remaining funds.
6. Use the information to make informed decisions about your budgeting and expenses.

## Contributing

Contributions are welcome! If you find any issues or have suggestions for improvements, please open an issue or submit a pull request. For major changes, please discuss them with the project maintainers.