FinLens is a full-stack AI-driven personal finance platform that automates expense tracking, receipt processing, and financial insight generation using Google Gemini AI.
🔗 Live Demo: https://fin-lens-sooty.vercel.app/
Managing personal finances manually is:
- Time-consuming
- Error-prone
- Lacks intelligent insights
FinLens solves this by combining AI, automation, and analytics into one seamless system.
- Auto-generates money-saving tips
- Detects spending patterns & risky habits
- Provides actionable budget suggestions
- Add / edit / delete transactions
- AI Receipt Scanner – Upload bill images and auto-extract data
- Bulk CSV Import & Delete facilities
- Income vs Expense overview
- Category-wise spending analytics
- Monthly trend analysis
All insights rendered via interactive charts.
- Monthly scheduled summaries using Node-Cron
- Dashboard alerts including:
- Total Income
- Total Expenses
- Available Balance
- AI-generated financial improvement tips
- React + TypeScript
- Tailwind CSS + ShadcnUI
- Chart.js
- Redux Toolkit
- Node.js + Express + TypeScript
- JWT Authentication
- MongoDB + Mongoose
- Google Gemini API
- Multer + Cloudinary (Receipt Uploads)
- Node-Cron (Task Scheduling)
- CSV Parser
- Secure JWT based authentication
- Protected API routes
- Cloud-based receipt storage with signed uploads
User
↓
Frontend (React + TS)
↓
Express API Gateway
↓
├─ Auth Service (JWT)
├─ Transaction Engine (CRUD + CSV)
├─ Receipt OCR + Gemini AI
├─ Analytics Engine
└─ Cron Scheduler (Monthly Reports)
↓
MongoDB
git clone https://github.com/yourusername/finlens.git
cd finlenscd backend
npm install
npm run devcd frontend
npm install
npm run devCreate .env in backend:
MONGO_URI=
JWT_SECRET=
GEMINI_API_KEY=
CLOUDINARY_NAME=
CLOUDINARY_API_KEY=
CLOUDINARY_API_SECRET=
- AI-based spending anomaly detection
- Multi-currency support
- Bank API auto-sync
- Voice-based transaction input
Ahana Banerjee
Electronics & Communication Engineering
JNTUH Hyderabad