Skip to content

Edasgh/moneymind

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

73 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

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

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