An AI-powered financial education platform built with Next.js 15 and Google Gemini AI. Learn personal finance through interactive conversations, visualizations, and structured learning modules.
- Interactive Chat: AI tutor powered by Google Gemini 2.5 Pro
- Context-Aware Responses: Personalized guidance based on current learning module
- Educational Focus: Financial concepts explained in simple terms
- Budgeting Basics: 50/30/20 rule, expense tracking, emergency funds
- Investing 101: Stocks, bonds, index funds, compound interest
- Smart Saving: High-yield accounts, goal-based strategies
- Debt Management: Debt snowball/avalanche methods
- Retirement Planning: 401(k), IRA, Social Security
- Financial Goals: SMART goals and achievement tracking
- Compound Interest Calculator: Investment growth visualizations
- Budget Dashboard: Expense tracking and insights
- Loan Calculator: Payment comparisons and amortization
- Retirement Calculator: Savings trajectory planning
- Responsive Design: Works on all devices
- Dark Mode: Automatic theme detection
- Progress Tracking: Learning analytics and achievements
- Smooth Animations: Powered by Framer Motion
- Next.js 15.4.1 - React framework with App Router and edge runtime
- React 19.1.0 - Modern React with concurrent features
- TypeScript 5.8.3 - Full type safety
- Tailwind CSS 4.1.11 - Utility-first CSS framework
- Google Gemini 2.5 Pro - AI language model for financial guidance
- Framer Motion 12.23.6 - Animation library
- Recharts 3.1.0 - Data visualization
- Lucide React - Icon library
- Node.js 18.0 or later
- npm, yarn, or bun package manager
- Google Gemini API Key
-
Clone the repository
git clone https://github.com/Divyesh-5981/financeGPT.git cd financeGPT -
Install dependencies
npm install
-
Set up environment variables Create a
.env.localfile:GEMINI_API_KEY=your_gemini_api_key_here
-
Start development server
npm run dev
-
Open your browser Navigate to http://localhost:3000
npm run dev # Start development server with Turbopack
npm run build # Build for production
npm run start # Start production server
npm run lint # Run ESLint
npm run type-check # TypeScript type checkingapp/
├── api/ # API routes (Edge Runtime)
│ ├── chat/ # AI chat endpoints
│ └── alpha-vantage/ # Financial data API
├── chat/ # AI chat interface
├── learn/ # Learning modules
│ └── [module]/ # Dynamic module pages
├── visualizations/ # Interactive financial tools
└── page.tsx # Homepage
components/
├── chat/ # Chat interface
├── ui/ # Reusable UI components
└── visualizations/ # Financial calculators
lib/
├── gemini/ # AI integration
│ ├── client.ts # Gemini API client
│ ├── systemPrompt.ts # AI system prompt
│ └── modulePrompts.ts # Module-specific prompts
└── services/ # Business logic
├── progressService.ts # Learning progress
└── budgetService.ts # Budget calculations
- Ask questions about personal finance
- Get context-aware responses based on current module
- Educational content with simple explanations
- Navigate to
/learnto see all modules - Select a module (budgeting, investing, etc.)
- Use the integrated chat for topic-specific guidance
- Progress is tracked locally in your browser
/visualizations- Access all financial calculators- Compound interest calculator with dynamic charts
- Budget dashboard for expense tracking
- Loan calculator for payment comparisons
- Retirement planning tools
# Required for AI chat functionality
GEMINI_API_KEY=your_gemini_api_key_here
# Optional for market data features
ALPHA_VANTAGE_API_KEY=your_alpha_vantage_key_hereGet your Gemini API key from Google AI Studio
ISC License - see LICENSE file for details.
- Fork the repository
- Create a feature branch
- Make your changes
- Submit a pull request
For major changes, please open an issue first to discuss your ideas.
Built with Next.js 15 • TypeScript • Google Gemini AI • Tailwind CSS
⭐ Star this repo if you find it helpful!