FinQuest

Fin's adventure on FinQuest
Architecture

Inspiration

Managing money as a student often feels like trying to fill a leaky bucket. We've all been there: the daily coffee that's practically an addiction, too much takeout, and forgotten subscriptions that silently drain our accounts. This creates a constant stress of never having a real safety cushion—the persistent feeling that there’s never enough.

We wanted to patch those leaks, not by imposing strict rules, but by creating something that makes saving feel motivating and rewarding.

What it does

FinQuest is a gamified financial companion that transforms how students interact with their money. Instead of just tracking numbers, it helps you:

Unify Your Finances: Securely bring all your card and transaction data into a single, clear dashboard. Finally, you can see your entire financial picture in one place.
Never Miss a Payment: Get smart, timely reminders for upcoming credit card due dates, helping you avoid late fees and protect your credit score.
Get Smart Recommendations: Our app analyzes your unified data to suggest concrete ways to save or spend more wisely.
Set and Crush Personal Goals: Whether it’s a new laptop, a trip to Europe, or an emergency fund, FinQuest helps you create a clear path to get there.
Nurture Your Growth: Every goal is tied to a digital garden. As you save consistently, your plants flourish. It turns budgeting into an act of cultivation, not restriction.

How we built it

Frontend: React for a clean, intuitive, and responsive user interface.
Backend: FastAPI to efficiently handle user data, logic, and AI-driven recommendations.
APIs: We used the Gemini API for intelligent financial insights and the Nessie API (from the Capital One dataset) to generate realistic, synthetic transaction data for our demo.

This stack allowed us to rapidly build a full-featured simulation that showcases the app's core potential.

The Auto-Visualization Agent

A standout feature of FinQuest is the Auto-Visualization Agent. Instead of showing users generic, pre-defined charts, this agent analyzes their unique spending data in real-time. It then dynamically generates the most relevant visualization—whether it's a bar chart showing a spike in takeout spending or a trend line for their savings rate. This means users get personalized, actionable insights at a glance, without needing to be data experts. It directly answers the question, "What does my data mean?"

How Gemini is Used

Gemini is the intelligent engine at the core of FinQuest's user experience. We leverage it in two key ways:

Generating Personalized Recommendations: Gemini analyzes a user's transaction patterns to provide two distinct types of advice:
- Smart Saving: These are immediate, actionable tips tied to daily habits to help accelerate progress towards a goal. For instance, it might notice frequent coffee purchases and suggest reducing them to hit a savings target faster.
- Smart Spending: This involves more strategic advice. Based on spending categories (like frequent gas or grocery purchases), it can recommend specific types of student credit cards that offer personalized cashback or rewards, thereby optimizing the user's spending power.
Powering the Auto-Visualization Agent: Gemini interprets the raw financial data and determines the most effective chart or graph to tell the user's financial story. It transforms complex numbers into clear, easy-to-understand insights.

Challenges we ran into

Our initial plan relied on the Plaid API to pull live bank transactions. When access proved difficult under the hackathon's time constraints, we needed to pivot quickly.

Our solution was to leverage the Nessie API to generate high-quality synthetic data. This allowed us to build and validate our entire feature set without compromising the user experience, proving our concept works in a real-world scenario.

Accomplishments that we're proud of

We successfully implemented our entire planned feature roadmap, from authentication to AI-powered recommendations, within the hackathon timeframe.
We created a fully immersive user experience by combining smart data visualizations with engaging gamification, including custom avatars and progress animations.
Most importantly, we turned a stressful process (budgeting) into an interactive and motivating journey that students would genuinely want to use.

What we learned

Gamification is a powerful tool in finance. When users can see and feel their progress in a tangible way, they are far more likely to stay motivated.
The importance of adaptability—integrating a new API on the fly taught us valuable lessons in agile problem-solving.
Visualizing the cumulative impact of small, consistent savings is key to building lasting financial habits.

What's next for FinQuest

Our vision is to take FinQuest from a successful prototype to an indispensable tool for students everywhere. Our roadmap includes:

Live Data Integration: Transition to production by integrating with financial APIs like Plaid or Capital One’s to provide real-time transaction tracking.
Building a Social Finance Ecosystem: Enhance the system with collaborative features. We plan to introduce group goals (like saving for a house or a trip together) and group leaderboards to foster friendly competition and shared accountability.
Campus and Community Rollout: Partner with student organizations and universities to introduce FinQuest as the go-to budgeting companion for students.