budget-tracker-mannyyebz 0.1.2

A personal budget tracker CLI

💰 Budget Tracker CLI

A command-line personal finance tracker built with Python and argparse, managed with uv.

---

Setup

1. Install uv

# macOS / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows (PowerShell)
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

2. Install the project

git clone https://github.com/mannyyebz/budget-tracker.git
cd budget-tracker
uv pip install -e .

---

Usage

Run any command with uv run budget <subcommand>.

Add a transaction

uv run budget add --amount 45.50 --category food --desc "Lunch at cafe" --type expense
uv run budget add --amount 3000 --category salary --desc "Monthly salary" --type income
uv run budget add --amount 85.20 --category food --desc "Groceries" --type expense --date 2026-04-10

List transactions

uv run budget list
uv run budget list --month 2026-04
uv run budget list --category food
uv run budget list --type expense

View summary report

uv run budget summary
uv run budget summary --month 2026-04

Set a budget limit

uv run budget set-limit --category food --limit 300
uv run budget set-limit --category rent --limit 1500

Export to CSV

uv run budget export --output report.csv
uv run budget export --month 2026-04 --output april.csv

View expense pie chart (Bonus)

uv run budget chart
uv run budget chart --month 2026-05

---

Project Structure

budget_tracker/ ├── pyproject.toml ├── src/ │ └── budget_tracker/ │ ├── main.py │ ├── storage.py │ └── commands/ │ ├── add.py │ ├── list_transactions.py │ ├── summary.py │ ├── export.py │ ├── set_limit.py │ └── chart.py └── data/ └── transactions.json

Data Storage

All data is persisted in data/transactions.json, auto-created on first run.