Nevvyboi/SentiVest

🤖🏦 AI Private Banking Agent powered by a Personal Financial Knowledge Graph 🕸️🧠 -> 🎙️ voice-first, 🛡️ real-time fraud detection, 💡 proactive financial intelligence, and 🎮 life simulation for South Africa 🇿🇦 # 🏦 SentiVest **🤖 AI Private Banking Agent with a Personal Financial Knowledge Graph** SentiVest is an autonomous AI banking agent built for the South African market. It goes beyond traditional banking dashboards by combining a personal financial knowledge graph with real-time transaction classification, voice-first interaction, and proactive financial intelligence. > 💡 Banks give you data. SentiVest gives you understanding. --- ## 🎬 A Look Around **🧬 The knowledge graph and life simulator.** Ninety one nodes and ninety four edges linking accounts, merchants, loans, budgets, insurance and anomalies around a central **You**. The simulator on the left compresses months into seconds, firing salary, debit orders, fraud attempts and life events straight into the graph over a WebSocket. **📝 The audit log.** Every decision the agent takes is written out as it happens, so nothing the classifier or the graph does is hidden behind a spinner. --- ## ⚡ What Makes This Different | Traditional Banking | SentiVest | |---|---| | 📊 Shows balance | 🔮 Predicts when you'll run out | | 📋 Lists transactions | 🛡️ Classifies and scores every one | | 🖥️ Static dashboard | 🧬 Living knowledge graph | | 🚫 No memory | 🧠 Remembers your goals and habits | | 👤 You drive | 🤖 The agent drives | | ⏳ Reactive | ⚡ **Proactive** | --- ## 🏗️ Architecture ``` 🎙️ Voice / Chat Interface 35+ handlers, multi-turn flows, persistent memory | 🧠 AI Model Layer Qwen 2.5-3B (Ollama) + rule-based fallback | 🕸️ Knowledge Graph Accounts, merchants, loans, investments, insurance, tax | 🛡️ Transaction Classifier 100+ merchants, 6 fraud indicators, SAFE/FLAG/ALERT/BLOCK | ⚙️ Infrastructure FastAPI (async) + WebSocket + Investec API (OAuth2) ``` --- ## ✨ Features ### 🤖 Core Agent Capabilities - 🛡️ **Transaction Classification** - Real-time fraud detection with weighted scoring across 100+ known merchants and 6 fraud indicators - 🕸️ **Knowledge Graph** …