BudgetBuddy

BudgetBuddy is a Python command-line tool for analyzing personal spending from a CSV file.

It helps a user answer three practical questions:

• Where is most of my money going this month?
• Which payments look recurring?
• If I keep spending at this pace, what might my month-end total be?

Current Features

• Load transactions from a CSV file
• Summarize spending by category
• Detect monthly recurring expenses
• Estimate month-end spending from the current daily average

CSV Format

The input file must contain these columns:

date,description,category,amount

Example:

2026-03-02,Rent,Housing,950.00
2026-03-03,Supermarket,Groceries,54.60

Installation

uv pip install -e .

Usage

uv run -m budgetbuddy data/sample_transactions.csv

You can also analyze a specific month:

uv run -m budgetbuddy data/sample_transactions.csv --month 2026-02

Example Output

BudgetBuddy report for 2026-03
Transactions analyzed: 8
Total spending: 1205.09 EUR

Run Tests

python3 -m unittest discover -s tests

Why This Project Fits The Course

BudgetBuddy uses Python data structures, control flow, functions, classes, file handling, and packaging in one small but useful command-line application.