Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

Edasgh/moneymind

Repository files navigation

๐Ÿง  MoneyMind AI

An AI-powered autonomous financial agent that analyzes spending behavior, predicts financial outcomes, and helps users make smarter money decisions.

๐ŸŒ Live Demo: https://moneymind-nomics.vercel.app/

๐ŸŽฅ Demo Video 1 : https://youtu.be/ZsrgbS3F9k8?si=vMbSXouS-KrZZmHR

๐ŸŽฅ Demo Video 2 (version 1.1.0) : https://youtu.be/b62I6GMT8fU?si=E3xUKIk6c08Kk0mP


๐Ÿš€ What is MoneyMind?

MoneyMind AI is a next-generation personal finance platform designed to act like an intelligent financial advisor.

Instead of only tracking expenses, MoneyMind understands financial behavior, predicts future risks, simulates decisions, and continuously guides users toward better financial outcomes.

It combines:

  • AI-driven analysis
  • Predictive finance
  • Behavioral insights
  • Autonomous monitoring
  • Real-time financial simulations

๐ŸŽฏ The Problem

Managing money is becoming increasingly complex.

Most people:

  • Donโ€™t know where their money actually goes
  • Cannot predict future financial problems
  • Make emotional spending decisions
  • Struggle to balance savings, goals, and lifestyle
  • Lack personalized financial guidance

Traditional finance apps only show numbers. They donโ€™t explain behavior or help users make decisions.


๐Ÿ’ก Solution

MoneyMind AI acts as an autonomous financial intelligence system.

It:

  • Tracks spending patterns
  • Detects risky financial behavior
  • Predicts future expenses
  • Simulates financial decisions
  • Generates personalized AI insights
  • Continuously monitors financial health

The platform adapts to:

  • User spending habits
  • Income patterns
  • Financial goals
  • Country-specific financial realities

๐Ÿง  Core Features

๐Ÿ“Š AI Financial Dashboard

  • Income, spending & savings overview
  • Financial Stability Score
  • Smart AI-generated insights
  • Savings health tracking
  • Risk detection

๐Ÿง  Behavioral Finance Analysis

MoneyMind analyzes user behavior patterns and generates:

  • Financial personality detection
  • Habit analysis
  • Spending psychology insights
  • Actionable improvement plans
  • Estimated savings impact

Example:

"Frequent late-night impulse purchases are slowing your emergency fund growth."


โš–๏ธ AI Decision Engine

Users can ask:

"Can I afford a โ‚น8L car?" "Should I start a โ‚น5000 SIP?" "Can I move to a more expensive apartment?"

MoneyMind evaluates:

  • Income
  • Savings
  • Risk
  • Goals
  • Emergency runway
  • Predicted future expenses

Then returns:

  • Recommendation
  • Risk level
  • Trade-offs
  • Long-term impact

๐Ÿ”ฎ Predictive Intelligence

MoneyMind predicts future financial conditions using:

  • Spending history
  • Weighted trend analysis
  • Behavioral patterns
  • Essential vs lifestyle spending
  • Seasonal & weekend trends

Outputs include:

  • Next month expense prediction
  • Spending trajectory
  • Financial stress indicators

๐ŸŽฎ Scenario Simulation Engine

Users can simulate "what-if" decisions in real time.

Examples:

  • Buy a new laptop
  • Start investing monthly
  • Reduce food delivery spending
  • Increase savings rate

MoneyMind instantly shows:

  • Goal delays
  • Risk increase
  • Savings impact
  • Financial survival months

๐ŸŽฏ Smart Goal System

Users can:

  • Create financial goals
  • Track progress
  • Predict completion timelines
  • Receive AI-generated recommendations

AI adapts recommendations based on:

  • User income
  • Spending behavior
  • Country economy
  • Current savings rate

๐Ÿค– Autonomous AI Agent

MoneyMind continuously monitors finances in the background.

The autonomous worker system:

  • Detects financial risks
  • Generates insights
  • Sends reminders
  • Tracks progress
  • Updates predictions automatically

Triggers include:

  • ๐Ÿšจ Overspending alerts
  • ๐ŸŽฏ Goal milestones
  • ๐Ÿ“ˆ Savings improvements
  • โš ๏ธ Financial risk warnings

๐Ÿ“ง AI Weekly Reports

Automated reports delivered via email:

  • Spending summaries
  • Financial score updates
  • Personalized recommendations
  • Goal progress tracking

๐Ÿงช Demo Mode

Users can instantly explore MoneyMind without uploading personal financial data.

Demo personas include:

  • ๐Ÿ‘จโ€๐ŸŽ“ Student
  • ๐Ÿ‘ฉโ€๐Ÿ’ป Young Professional
  • ๐Ÿ‘จโ€๐Ÿ‘ฉโ€๐Ÿ‘ง Family Budget
  • ๐Ÿง‘โ€๐ŸŽจ Freelancer

Each profile contains:

  • Realistic financial transactions
  • AI insights
  • Predictions
  • Goals
  • Spending behaviors

๐Ÿ”„ High-Level Flow

User โ†’ Frontend โ†’ API Layer
โ†’ MongoDB Storage
โ†’ AI Engine (Gemini)
โ†’ Background Workers
โ†’ Predictions & Notifications


โšก Architecture Highlights

๐Ÿ”น Modular AI Pipeline

MoneyMind separates:

  • Lightweight ingestion jobs
  • Heavy AI analysis workers

This improves:

  • Scalability
  • Performance
  • Cost optimization

๐Ÿ”น Background Worker System

Scheduled workers handle:

  • AI analysis
  • Predictions
  • Weekly reports
  • Goal monitoring

Without blocking user interactions.


โš™๏ธ Tech Stack

๐Ÿ–ฅ๏ธ Frontend

  • Next.js App Router
  • React
  • Tailwind CSS
  • Framer Motion

๐Ÿงฉ Backend

  • Next.js API Routes
  • Node.js

๐Ÿ—„๏ธ Database

  • MongoDB
  • Mongoose

๐Ÿค– AI Layer

  • Google Gemini API
  • Custom financial reasoning engine

๐Ÿ”„ Background Jobs

  • Cron workers
  • Autonomous processing system

๐Ÿ“ง Notifications & Email

  • Nodemailer

๐Ÿ“Š Dataset & AI Training

๐Ÿงช Demo Data

Synthetic financial datasets used for onboarding and testing.

๐ŸŒ Realistic Financial Datasets

Kaggle datasets are used here, inspired by real-world banking behavior:

Used for:

  • Spending pattern analysis
  • Prediction modeling
  • Behavioral simulations

โš ๏ธ All datasets are anonymized.


๐Ÿ“ธ Screenshots

๐Ÿ  Dashboard (Analyze Page)

Dashboard_1 Dashboard_2 Dashboard_3 Dashboard_4


Add Goal

Add Goal

Ask AI about Goal

Ask Goal

Add Transaction

Add Transaction


๐Ÿง  AI Analysis

Analysis


๐Ÿค– Ask AI

Chat_1 Chat_2


๐Ÿ”ฎ Spending BreakDown & Prediction

Prediction

Scenario Comparison

Scenario_1 Scenario_2 Scenario_3

Savings Impact Simulation

๐Ÿ“„ Statement Upload

Upload

๐Ÿ“„ Profile

Profile


๐ŸŽฅ Demo Flow

  1. Launch demo mode
  2. Explore AI insights
  3. Ask financial questions
  4. Run simulations
  5. View predictions
  6. Track goals
  7. Receive autonomous recommendations

Set up environment variables

GEMINI_API_KEY=
NEXTAUTH_URL="http://localhost:3000"
BASE_URL="http://localhost:3000"
NEXTAUTH_SECRET=
MONGODB_URI=
WORKER_SECRET=
GOOGLE_ACCOUNT_USER=
GOOGLE_ACCOUNT_PASS=
GOOGLE_ACCOUNT_APP_NAME=
GITHUB_OWNER=
GITHUB_REPO=
GITHUB_TOKEN=
# local variables
# Deployment used by `npx convex dev`
CONVEX_DEPLOYMENT=
NEXT_PUBLIC_CONVEX_URL=
NEXT_PUBLIC_CONVEX_SITE_URL=

Local setup

git clone https://github.com/Edasgh/moneymind.git
cd moneymind
npm install
npm run dev
# for convex setup
npx convex dev

๐Ÿ“ Project Structure

/app
 /chat
 /analyze
 /profile
 layout.tsx
 not-found.tsx
 error.tsx
 page.tsx
 favicon.ico
/api
 /register
 /auth
 /profile
 /uploadFile
 /internal/trigger_workers
 /internal/trigger_analysis
 /worker/process-statements
 /worker/analyze-finances
 /chat
 /follow-up
 /statements
 /transaction
 /goals
 /loadDemo
 /scenario
 /simulate
 /notifications
/models
 Finance.ts
 Notification.ts
 Statement.ts
 User.ts
/lib
 /ai
 /demoData
 canAfford.ts
 convertToPdf.ts
 convex.ts
 createNotification.ts
 currencyMap.ts
 db.ts
 sectionColors.ts
 simulateSavings.ts
 statementParseHelpers.ts
 triggerWorker.ts
 utils.ts
/components
 AddGoalModal
 AddTransactionModal
 AIAnalysis
 DemoAnalysis
 DemoChat
 DemoDataModal
 EditGoalModal
 EditProfileModal
 EditTransactionModal
 ExitDemoBanner
 Footer
 GamificationCard
 GoalsSection
 HowItWorks
 LifeImpactCard
 NotificationToaster
 Providers
 ScenarioEngine
 ScoreCard
 ScoreMeter
 SignInModal
 SignUpModal
 SpendingChart
 StatementsCard
 TransactionTable
 UploadStatement
/convex
 /_generated
 fileControls.ts
/hooks
 useFinance.ts
/types
 next-auth-d.ts
/screenshots
/public/favicon.svg
.env
.env.local
.gitignore

Planning to expand MoneyMind with:

  • ๐Ÿฆ Bank API integrations & Secure password protected statement upload
  • ๐Ÿ“ฑ Mobile applications
  • ๐Ÿ“ˆ Advanced ML-based forecasting
  • ๐Ÿงพ Tax planning assistance
  • ๐Ÿง  Deeper personalized coaching
  • ๐ŸŒ Multi-country financial adaptation
  • ๐Ÿ’ฌ Voice-based financial assistant
  • ๐Ÿ“Š Advanced analytics & investment insights
  • ๐Ÿ’ฌ Adding User feedback form in the app itself

๐Ÿ™Œ Author

Built with โค๏ธ for real-world impact

About

MoneyMind is an AI-powered behavioral finance app that helps users understand why they spend, not just where they spend. Instead of traditional budgeting tools, MoneyMind focuses on habit change, emotional triggers, and real-life decision patterns.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

Contributors

AltStyle ใซใ‚ˆใฃใฆๅค‰ๆ›ใ•ใ‚ŒใŸใƒšใƒผใ‚ธ (->ใ‚ชใƒชใ‚ธใƒŠใƒซ) /