bigjosh112/billguard

BillGuard: AI Finance Agent for African Professionals — Google Cloud Rapid Agent Hackathon 2026 # BillGuard 🛡️ ### AI Finance Agent for African Professionals > **Built for the Google Cloud Rapid Agent Hackathon 2026 — MongoDB Track** BillGuard is an AI agent that helps working professionals in Nigeria and Africa take control of their finances. It ingests your bank statement, stores all transactions in MongoDB Atlas, and then uses Gemini to reason over your real data — prioritising bills, forecasting your cash flow, and identifying hidden spending. --- ## The Problem Every month, millions of African professionals face the same mental load: - Salary arrives. Bills pile up simultaneously. - Rent, loan repayments, utilities, subscriptions, food — all due within the same window. - No clear picture of what to pay first, what can wait, and whether you'll make it to the next payday. Most finance apps are built for the US. BillGuard is built for Lagos. --- ## What BillGuard Does | Step | Action | |------|--------| | **1. Ingest** | Upload your bank CSV (GTBank, Access, Zenith, UBA, First Bank) | | **2. Store** | Agent normalises and stores every transaction in MongoDB Atlas via MCP | | **3. Categorise** | Gemini automatically categorises spending — rent, transport, food, subscriptions, loans | | **4. Prioritise** | Given your current balance, the agent tells you exactly which bills to pay first | | **5. Forecast** | Projects your cash flow to your next salary date — will you make it? | | **6. Recommend** | Identifies forgotten subscriptions and specific things you can cut | --- ## Tech Stack - **AI Agent**: Gemini 2.0 Flash via Google Cloud Agent Builder - **Database**: MongoDB Atlas (via MCP — central to the agent's memory) - **Backend**: Python + FastAPI deployed on Google Cloud Run - **Frontend**: Next.js with real-time streaming agent responses - **MCP Integration**: MongoDB MCP server — every agent tool call reads/writes MongoDB --- ## Architecture ``` User → Next.js Chat UI ↓ FastAPI Backend ↓ BillGuard Gemini Agent ↓ ↓ ↓ get_summar …