How traynertunder2047/financeflow works
FinanceFlow is an interactive CLI planner: users choose an AI or job-posting salary search, provide job and country details, review an estimated after-tax salary, enter monthly expenses, and allocate remaining savings to objectives. Tax estimation uses cached brackets or extracts them from the OECD PDF, falling back to AI web research, then converts currencies as needed. Spending and objective calculations are implemented in the main flow and reported through the UI. Source excerpts show the main calls and tax pipeline; README documents capabilities whose internal implementation was not sampled.
Main entry points: main.py Workflow Orchestrator · taxCalculator.py Tax Calculation · scraper.py Salary Search Modes · pdfChapterExtractor.py PDF Chapter Extraction
Components 19
CLI Workflow
- Workflow Orchestrator
main.py - Prompts and Reports
app/ui.py - Spending Profile
main.py - Objective Allocation
main.py
Salary Research
- Salary Search Modes
app/scraper.py - Web Bracket Search
app/scraper.py - Bracket Tax Math
app/scraper.py
Tax Estimation
- Tax Calculation
app/taxCalculator.py - PDF Chapter Extraction
app/pdfChapterExtractor.py - PDF Bracket Extraction
app/pdfParamExtractor.py
Rates and Cache
- Tax Parameter Cache
data/fiscalCacheParams.json - Currency Conversion
app/currencyConverter.py - Exchange Rate Cache
data/exchangeRates.json
Other components
- Planner
- Jobdatalake API
- Gemini Search
- OECD Tax PDF
data/TaxingWages2026.pdf - Country Chapter Map
data/countryChapters.json - Exchange Rate API
Connections 20
- Planner → Workflow Orchestrator: enters workflow
readme.md - Workflow Orchestrator → Prompts and Reports: prompts and reports
main.py - Workflow Orchestrator → Salary Search Modes: requests salary
main.py - Workflow Orchestrator → Tax Calculation: requests tax
main.py - Workflow Orchestrator → Spending Profile: collects expenses
main.py - Spending Profile → Objective Allocation: supplies savings
main.py - Workflow Orchestrator → Objective Allocation: plans goals
main.py - Salary Search Modes → Jobdatalake API: queries postings
app/scraper.py - Salary Search Modes → Gemini Search: searches salary
app/scraper.py - Tax Calculation → Tax Parameter Cache: reads and writes
app/taxCalculator.py - Tax Calculation → PDF Chapter Extraction: extracts chapter
app/taxCalculator.py - PDF Chapter Extraction → OECD Tax PDF: reads pages
app/pdfChapterExtractor.py - PDF Chapter Extraction → Country Chapter Map: loads map
app/pdfChapterExtractor.py - Tax Calculation → PDF Bracket Extraction: extracts brackets
app/taxCalculator.py - Tax Calculation → Web Bracket Search: searches brackets
app/taxCalculator.py - Tax Calculation → Bracket Tax Math: calculates tax
app/taxCalculator.py - Bracket Tax Math → Currency Conversion: converts currency
app/scraper.py - Currency Conversion → Exchange Rate Cache: reads and writes
app/currencyConverter.py - Currency Conversion → Exchange Rate API: fetches rates
app/currencyConverter.py - Web Bracket Search → Gemini Search: searches brackets
app/scraper.py