Finance Analysis

Local-only household spending tracker. All data stays on device.

Requirements

• Python 3.11+
• Node.js 18+

Setup

Backend

cd backend
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

Frontend

cd frontend
npm install

Running the app

./dev.sh start

Then open http://localhost:5173.

Dev script

./dev.sh start    # start backend + frontend in the background
./dev.sh stop     # stop both
./dev.sh restart  # restart both
./dev.sh test     # run the full test suite (privacy suite first)

Running tests

./dev.sh test

Two suites:

• tests/privacy/ — account masking, LLM payload sanitization, DB privacy (CI blocker)
• tests/ — parsers, pipeline stages, dedup, idempotency

Project structure

backend/    FastAPI + SQLite backend
frontend/   React + Chart.js frontend
dev.sh      Dev script