Inspiration
- Team members saw friends stress-scroll through banking apps without knowing what to do next; we wanted an AI mentor that explains numbers in plain English and addresses bias directly.
- Hackathon theme focused on FinTech & Financial Literacy, which aligned with our goal to meet Gen Z where they are and reduce anxiety around money decisions.
What it does
- Ingests persona financial snapshots and produces Gemini daily digests with actionable tips and recommended lessons.
- Offers a scenario sandbox (rent vs. buy today, more calculators coming) with Gemini narratives that translate numbers into trade-offs.
- Generates custom micro-lessons + quizzes on the fly, stores them in the curriculum, and surfaces them in the Learning Hub.
- Provides live financial controls so updating income/expenses instantly re-runs insights and shows new surplus metrics.
How we built it
- Backend: FastAPI + Python handles persona storage, calculators, and Gemini prompt orchestration (Gemini 2.5 Flash for insights, custom prompt for lesson generation).
- Frontend: React + Vite SPA with Zustand for state, Tailwind styles; dashboard consumes APIs, renders Markdown (React Markdown + custom normalizer).
- Added resilience layers: fallback mocks, text cleaners, and Markdown normalization to tame Gemini output.
- Tests: Pytest for backend flows, ESLint/TypeScript checks for UI.
Challenges we ran into
- Gemini sometimes returned partial or malformed JSON; we had to sanitize outputs, enforce schema defaults, and synthesize quizzes when missing.
- Markdown formatting arrived with broken headings (“Overvie\nw”); required regex normalization to fix sections without losing content.
- Keeping persona recommendations in sync after generating new lessons, which was solved with store updates and caching.
Accomplishments that we're proud of
- End-to-end flow: enter direction → Gemini generates on-topic lesson + quiz → instantly appears in Learning Hub.
- Daily digest now surfaces both actionable next steps and lesson recommendations, making insights immediately usable.
- Scenario narratives are cleanly formatted Markdown with consistent headings and bullets after heavy post-processing.
- Runbook and pitch assets document the full journey for judges, including validation and fairness logs.
What we learned
- Structured prompts + deterministic post-processing are essential when relying on LLM output for production-like flows.
- Providing Gemini with explicit resolved context (persona summary, track hints) drastically improves topical accuracy.
- Small UX touches, spinner states, financial controls, and Markdown cleanup make AI insights feel trustworthy.
- Continuous testing (pytest, lint, build) prevents regressions as we iterate quickly.
What's next for MentorMoney – AI Financial Wellness Coach
- Add more calculators (debt snowball, emergency runway) and expose them via the scenario sandbox.
- Integrate real banking APIs (Plaid/Teller) for live data and expand persona creation (custom financial inputs + goal tagging).
- Enhance fairness auditing and multilingual support; deliver bilingual insights consistently.
- Package the web client into a mobile-friendly PWA and prepare for pilot deployments with university/employer partners.
Built With
- fastapi
- gemini
- pydantic
- python
- react
- typescript
- uvicorn
Log in or sign up for Devpost to join the conversation.