_{🤖 Built with Claude. This project was developed heavily with Claude (Anthropic's AI assistant) using Claude Code.}

Financial Planner

A private, local household budget and long-term planner. Point it at the CSV exports from your bank and credit cards, describe your household (in the app or in YAML), and explore your monthly budget, college savings, retirement and how spending changes over time.

Full documentation: the wiki.

Contents

• Features
• Privacy first
• Quick start
• Your own plan
• Commands
• Development
• License

Features

• Monthly planner: every category at its average; change any number and see what's left over.
• Explore spending: monthly charts, top merchants and every transaction.
• College 529s: a projection for each child against the cost of college.
• Retirement: income at each retirement age from pensions, accounts, investments and Social Security.
• Spending over time: how costs change as children leave home and after retiring.
• Scenarios: save, compare and share what-ifs, or share the whole plan as one file.
• Settings and categorizing in the app: no YAML editing required (but it's there if you want it).

Privacy first

Everything runs on your computer and nothing is uploaded. Your plan folder holds real financial data: keep it out of public repositories and off the internet, and use generic names (Partner A, Child 1). See Privacy and Safety.

Quick start

Install pixi, then:

git clone https://github.com/brookisme/financial_planner.git
cd financial_planner
pixi run demo

Your browser opens at http://127.0.0.1:8765 with a fictional demo household.

Your own plan

pixi run financial_plan init ~/MyFinancialPlan    # create a plan folder
pixi run financial_plan start ~/MyFinancialPlan   # open it

Put your bank and card CSV exports in ~/MyFinancialPlan/data/, then click the gear (Settings) at the top right to add your household, connect the CSVs and categorize. On a Mac, pixi run financial_plan launcher adds a Financial Planner app to Applications (menu-bar icon, opens in the browser). A no-code download is described in the Desktop App page.

Step-by-step guide: Quick Start. Want an AI assistant to set it up with you? See LLM_SETUP.md.

Commands

Details: Command Line.

Development

pixi run -e dev test-all     # Python + forecast-math tests
pixi run -e dev web-build    # rebuild the web app

See Development.

License

BSD 3-Clause. Not financial advice: projections are rough and depend on the assumptions you enter.