Repository navigation
Releases
Releases · nullsec0x/budget-tracker
v0.1.0
Budget Tracker
A terminal-based personal finance manager written in Python.
Track your income and expenses, set budgets, monitor savings goals, and generate financial reports — all from the command line.
Created by Nullsec0x.
Features
- Add income and expense transactions
- Set monthly budgets and savings goals
- Generate monthly and category-based reports
- Export data to CSV format
- Filter transactions by category and type
- Clean terminal interface with Rich formatting
- Support for multiple currency symbols
- Track progress for budgets and savings goals
Installation
Clone the repository:
git clone https://github.com/nullsec0x/budget-tracker.git
cd budget-trackerInstall dependencies:
pip install -r requirements.txt
pip install -e .
pip install "click<8.1.0" "typer==0.4.1"
pip install --upgrade typer clickRun the application:
python -m budget_tracker.main
# or use the shorthand
budgetAlternatively, use the .exe file from the releases.
Windows Usage
- Download the
budget.exefile from the latest release - Open Command Prompt or PowerShell
- Navigate to where you downloaded the file
- Run the application with commands like:
budget.exe --help
budget.exe add expense 25.00 Food "Lunch"
budget.exe list
budget.exe summaryQuick Start (Double-Click Method)
If you double-click the executable, it will open a command window showing the welcome message.
To use the application effectively, run it from an already open command prompt.
Usage
The application provides a full CLI interface. Use budget --help or budget help for the complete command reference.
Examples
# Add transactions
budget add expense 25.00 Food "Lunch at cafe"
budget add income 1200.00 Salary "Monthly salary"
# View transactions
budget list --limit 10
budget list --category Food --type expense
# Manage budgets
budget set-budget 2000
budget summary
# Set savings goal
budget set-goal 5000 --name "New Laptop"
# Reports
budget report monthly
budget report categories
# Export data
budget export --filename my_finances.csvTech Stack
- Python 3.10+
- Typer – CLI framework
- Rich – terminal formatting
- SQLAlchemy – database backend
Author
Developed and maintained by Nullsec0x.