Skip to content

Soumojitshome2023/nextjs-h4b-hackathon-2025-last-brain-cell-finance-ai-project

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

48 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿ’ธ FinanceAI โ€“ AI-Powered Financial Intelligence Platform

FinanceAI Home

FinanceAI is your smart financial partner โ€“ combining intelligent expense tracking, personalized investment advice, and secure financial planning,view market trends in one sleek platform. Built for young adults and modern investors, it brings AI, and intuitive design together to make finance easy and powerful.


๐ŸŽฏ Problem Weโ€™re Solving

Most people find managing their finances frustrating. Here's why:

  • ๐Ÿ“‰ No personalized advice โ€“ One-size-fits-all doesnโ€™t work
  • ๐Ÿ’ธ Messy expense tracking โ€“ Manual tracking is painful
  • ๐ŸŒ€ Investment confusion โ€“ Too many options, no clear guidance
  • ๐Ÿ” Security worries โ€“ People donโ€™t trust sharing financial info online
  • ๐Ÿ“š Low financial literacy โ€“ Finance terms are often overwhelming

๐Ÿ’ก What Makes FinanceAI Special?

Dashboard

๐Ÿค– Smart Features Youโ€™ll Love:

  • ๐ŸŽฏ AI-Based Financial Advisor
    Personalized advice based on your income, risk, and goals

Dashboard

  • ๐Ÿง  Intelligent Risk Profiling
    Analyzes age, savings, income-to-expense ratio, and risk tolerance
  • ๐Ÿ“Š Real-time Investment Suggestions
    Includes SIPs, FDs, and market trades

Dashboard

  • ๐Ÿ’ฌ Conversational AI Chatbot
    Ask complex financial questions using natural language

Auth

๐Ÿ”’ Security-First Design:

  • ๐Ÿ†” Web3 Civic Auth for decentralized identity verification
  • ๐Ÿ” End-to-end encrypted data storage
  • ๐Ÿ”“ You control your data โ€“ no third-party dependency

Expenses

๐Ÿ’ฐ Expense & Budget Management:

  • ๐Ÿงพ Automatic Expense Categorization
  • ๐Ÿ“‰ Spending Pattern Predictions
  • ๐Ÿ’ก Budgeting Tips & Goal Tracking

๐Ÿ“ฌ More Features:

mail

  • โœ‰๏ธ Email Alerts for budget breaches

Tax

  • ๐Ÿงฎ Tax Optimizer powered by TaxVox
    Calculates your tax & suggests savings strategies

๐Ÿ› ๏ธ Tech Stack

๐Ÿ’ป Frontend

  • React 18 โš›๏ธ
  • Vite โšก
  • Tailwind CSS ๐Ÿ’…
  • shadcn/ui ๐Ÿงฉ
  • React Router & Query ๐Ÿงญ

๐ŸŒ Backend

  • Node.js ๐Ÿš€
  • MongoDB ๐Ÿƒ
  • Nodemailer
  • JWT Authentication ๐Ÿ”
  • CORS + .env configuration

๐Ÿค– AI & Intelligence

  • Google Gemini 2.5 Flash โšก๐Ÿง 
  • Custom Risk Profiling Algorithm
  • Prompt Engineering

๐Ÿ” Authentication

  • Civic Web3-based Identity Verification

๐Ÿง  UX & Design Principles

โœจ Key Features:

  1. ๐Ÿ“ˆ Smart Dashboard โ€“ All your finances in one view
  2. ๐Ÿ“Š Expense Analyzer โ€“ AI categorization & visual trends
  3. ๐Ÿค– AI Investment Advisor โ€“ Personalized tips & predictions
  4. ๐Ÿ‘ค User Profile Management
  5. ๐Ÿ›ก๏ธ Security Center โ€“ Transparent data policies
  6. ๐Ÿ’ฌ Finance Chatbot โ€“ Ask, learn, invest
  7. ๐Ÿ’ธ Tax Optimizer โ€“ Know, plan, save

๐ŸŽจ Design Aesthetics:

  • ๐ŸงŠ Glassmorphism UI โ€“ Sleek and modern
  • ๐ŸŒˆ Green Financial Gradients
  • ๐Ÿ“‰ Interactive Charts & Graphs
  • ๐Ÿฆพ Micro-interactions & animations

๐ŸŒŸ Why This Matters

๐ŸŒ Real-World Impact:

  • ๐Ÿง  Financial Literacy โ€“ Simplified guidance for everyone
  • ๐Ÿ”“ Access to Financial Tools โ€“ Even for first-time users
  • ๐Ÿ˜Œ Reduced Financial Stress โ€“ With proactive AI alerts
  • ๐Ÿ“ˆ Boosted Investment Confidence

๐Ÿ“ˆ Market Opportunity:

  • ๐ŸŒ $179.8B Fintech Market (23.58% CAGR)
  • ๐Ÿค– $9.45B AI in Finance (Expected $26.67B by 2026)
  • ๐Ÿ“ฑ 3.4B Personal Finance App Users Expected by 2026
  • ๐Ÿ‡ฎ๐Ÿ‡ณ Huge potential in Indiaโ€™s rising middle-class (1.4B+ users)

๐Ÿš€ How to Get Started

โœ… Prerequisites

  • Node.js 18+
  • MongoDB instance
  • Gemini API Key (Google AI Studio)
  • Civic Auth credentials

๐Ÿ› ๏ธ Installation Steps

  1. Clone the Repo
git clone https://github.com/Soumojitshome2023/h4b-last-brain-cell.git
cd h4b-last-brain-cell
  1. Backend Setup
cd backend
npm install
cp .example.env .env    # Update your environment variables
npm start
  1. Frontend Setup
cd frontend
npm install
cp .example.env .env    # Add API keys and configs
npm run dev

๐Ÿ” Environment Variables

Backend (.env)

PORT=4000
MONGO_URI=your_mongodb_connection
DBName=
APIEMAILADDRESS=
APIEMAILPASS=

Frontend (.env)

VITE_BaseUrl=http://localhost:8080
VITE_ServerUrl=http://localhost:4000
VITE_GeminiAPI=
VITE_CivicClientID=

๐Ÿ›ก๏ธ Security Highlights

  • ๐Ÿ” End-to-End Encrypted Data Handling
  • ๐Ÿ†” Web3 Authentication (Civic)
  • ๐Ÿ”‘ JWT-Based Secure Sessions
  • ๐ŸŒ CORS Protected API

โš™๏ธ Performance Boosts

  • ๐Ÿš€ Lazy Loading & Code Splitting
  • ๐Ÿ—‚๏ธ Image & Asset Optimization
  • ๐Ÿ“Š Indexed MongoDB Collections

๐Ÿ”ฎ Whatโ€™s Next

๐Ÿ”ง Phase 1:

  • ๐Ÿ“ฑ Native Mobile App (Android/iOS)
  • ๐Ÿ“‰ Credit Score Monitoring AI
  • ๐Ÿ“‚ Financial Health Analysis from Docs
  • ๐Ÿ› ๏ธ Blockchain + IPFS Secure Storage
  • ๐ŸŽฏ Investment & Goal Tracking

๐Ÿข Phase 2:

  • ๐Ÿ‘ฅ Multi-User Family/Team Accounts
  • ๐Ÿ”Œ 3rd-Party API Marketplace
  • ๐Ÿ“ˆ Enterprise-Grade Predictive Analytics

๐Ÿ”— Links


๐Ÿ‘ฅ Team Last Brain Cell