# Financial Insights Prototype A Python prototype for detecting life events and financial stress from transaction patterns. ## Features ### 1. Life-Event Detector Detects significant life changes from transaction patterns: - **Job Changes**: New employer deposits, changes in income patterns - **Relocations**: Moving company charges, utility setup fees, address changes - **Travel**: Foreign transactions, airline/hotel charges, travel insurance ### 2. Financial Stress Detector Identifies risky financial patterns: - Late payment fees - Overdraft charges - Multiple small withdrawals (potential cash flow issues) - Declining balance trends - High debt-to-income indicators ## Setup 1. Install dependencies: ```bash pip install -r requirements.txt ``` 2. Run the demo: ```bash python main.py ``` ## How It Works The prototype uses **synthetic transaction data** that simulates realistic banking patterns. This allows you to: - Test the detection algorithms without needing a real API - Understand how the detectors work - Prototype quickly without API setup - `main.py` - Main demo script - `transaction_generator.py` - Synthetic transaction data generator - `life_event_detector.py` - Life event detection logic - `financial_stress_detector.py` - Financial stress detection logic - `requirements.txt` - Python dependencies # prototype_bank