KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#typescript #ai-agents #cli #open-source #ai #claude-code #codex #deepseek-harness #dsh-plugin #react #windows #developer-tools

Expense-Tracker

★ 43 Open GitHub ↗

Family Expense Tracker - a simple Python project designed to help you keep track of your family members' earnings and expenses.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<h1 align="center">FAMILY EXPENSE TRACKER 🏦</h1>
<p align="center">
    <a href="https://github.com/SVijayB/PyHub"><img src="assets/logo-hacktober.svg" alt="Logo" border="0"></a><br>
    <a href="https://github.com/SVijayB/PyHub"><img src="assets/pyLogo.png" alt="Logo" border="0"></a>
</p>

![https://github.com/sree-hari-s/Expense-Tracker/network/members](https://img.shields.io/github/forks/sree-hari-s/Expense-Tracker?color=green) &nbsp;
![https://github.com/sree-hari-s/Expense-Tracker/graphs/issues](https://img.shields.io/github/issues/sree-hari-s/Expense-Tracker)  &nbsp;
![https://github.com/sree-hari-s/Expense-Tracker/graphs/contributors](https://img.shields.io/github/contributors/sree-hari-s/Expense-Tracker) &nbsp;
![https://github.com/sree-hari-s/Expense-Tracker/stargazers](https://img.shields.io/github/stars/sree-hari-s/Expense-Tracker?color=red) &nbsp;
![https://github.com/sree-hari-s/Expense-Tracker/watchers](https://img.shields.io/github/watchers/sree-hari-s/Expense-Tracker?color=yellow) &nbsp;
![https://github.com/sree-hari-s/Expense-Tracker/license](https://img.shields.io/github/license/sree-hari-s/Expense-Tracker) &nbsp;
[![code style: black](https://img.shields.io/badge/code%20style-black-000.svg)](https://github.com/psf/black) &nbsp;
</p>

<center>
Welcome to the Family Expense Tracker - a simple Python project designed to help you keep track of your family members' earnings and expenses. This tool allows you to effortlessly manage family finances by adding members, recording their earnings, and calculating the remaining balance after deducting expenses.
</center>

## Table of Contents

- 📑[Table of Contents](#table-of-contents)
- 🧾[Introduction](#introduction)
- ✨[Features](#features)
- 🛠️[How to Use](#how-to-use)
- ⚙️[Installation](#installation)
- 🙌[How to Contribute](#how-to-contribute)
- 📝[License](#license)

## Introduction

Managing a family's finances can be challenging, especially when dealing with multiple sources of income and various expenses. The Family Expense Tracker simplifies this task by providing a user-friendly interface to:

- 💼 Add Family Members
- 💵 Record Earnings for Each Family Member
- 📉 Track Expenses
- 💰 Calculate Remaining Balance

With this tool, you can easily monitor and manage your family's financial situation.

## Features

- **Add Family Members:** Start by adding the names of family members whose earnings and expenses you want to track.
- **Record Earnings:** Record the earnings for each family member. The tracker calculates the total earnings for the family.
- **Track Expenses:** Log various expenses, and the tracker deducts these from the total earnings, showing the remaining balance.
- **User-Friendly Interface:**

The Expense Tracker features a simple and easy-to-navigate interface, ensuring a seamless user experience, allowing you to effortlessly manage your family's financial data.

## How to Use

### 1️⃣ **Add Family Members:**

- Run the [application](https://expense-tracker-alpha.streamlit.app/) and choose the option to add family members.
- Enter the names of the family members you want to track.

### 2️⃣ **Record Earnings:**

- Select the option to record earnings.
- Specify the earnings for each family member.

### 3️⃣ **Track Expenses:**

- Log expenses for various categories (e.g., groceries, bills).
- The application automatically calculates the remaining balance after deducting expenses.

## Installation

### 1️⃣ Clone the Repository

```bash
git clone https://github.com/sree-hari-s/Expense-Tracker.git
cd Expense-Tracker
```

---

### 2️⃣ (Recommended) Create a Virtual Environment

Create a virtual environment to isolate project dependencies:

```bash
py -m venv .venv
```

Activate the virtual environment:

```bash
.\.venv\Scripts\activate
```

---

### 3️⃣ Use Python 3.11 (Required)

If you don't have Python 3.11 installed, install it using:

```bash
winget install python.python.3.11
```

Install dependencies using Python 3.11:

```bash
py -3.11 -m pip install -r requirements.txt
```

---

### 4️⃣ Run the Application

Start the Streamlit application using Python 3.11:

```bash
py -3.11 -m streamlit run app.py
```

The application will start and open in your browser at:

```
http://localhost:8501
```

## How to Contribute

- If you wish to [contribute](CONTRIBUTING.md) in any way, feel free to get involved. You can suggest improvements or provide support and encouragement by [opening an issue](https://github.com/sree-hari-s/Expense-Tracker/issues).

## Contributors

Thank you all for, your contributions. Your contributions hold immense value for our project, and we are genuinely thankful for your valuable support. Your unwavering commitment and hard work are truly commendable.

## License

This project is licensed under the terms of the [MIT License](LICENSE).

Expense-Tracker

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README