BillMates is a user-friendly app designed to simplify managing shared expenses among flatmates. Keep track of bills, split costs fairly, and ensure everyone knows what they owe.
- Bill Tracking: Easily add and track shared expenses.
- Expense Splitting: Automatically calculate each flatmate's share of the expenses.
- Payment Reminders: Get notifications for upcoming payments and reminders for due bills.
- Expense History: View past expenses and payment history for transparency.
- User-Friendly Interface: Simple and intuitive design for easy navigation.
To install and run the BillMates app locally, follow these steps:
- Python 3.6+
- pip (Python package installer)
-
Clone the Repository:
git clone https://github.com/akshayjith4/billmates.git cd billmates
-
Create a Virtual Environment:
python -m venv venv source venv/bin/activate # On Windows, use `venv\Scripts\activate`
-
Install Dependencies:
pip install -r requirements.txt
-
Run the Application:
python app.py
- Sign Up/Log In: Create a new account or log in with your existing credentials.
- Add Flatmates: Add your flatmates to the app.
- Add Expenses: Enter details of shared expenses, such as rent, utilities, and groceries.
- Split Costs: The app automatically calculates and splits costs among the flatmates.
- View Balances: Check each flatmate's balance to see who owes what.
- Settle Up: Record payments when flatmates settle their balances.
BillMates is also available online at BillMates. The site will be available for only 3 months because, let's face it, domains are expensive and this is a passion project.