An intelligent AI-powered platform that helps learners discover personalized course recommendations through natural language conversations. Built with Next.js 14 and powered by Google's Gemini AI.
- Natural Language Chat Interface - Ask about courses in plain English
- Intelligent Course Matching - AI analyzes your query to recommend relevant courses
- Sample Prompts - Get started with suggested queries like "I want to learn web development with React"
- Course Cards with detailed information (level, duration, provider)
- Save/Bookmark System - Keep track of courses you're interested in
- Course Details - AI-generated detailed course information including prerequisites and learning outcomes
- Direct Course Links - AI-generated realistic URLs to course providers
- Saved Courses Management - View and organize your bookmarked courses
- Learning Analytics - Track courses by level, provider, and duration
- Advanced Filtering - Search and filter courses by multiple criteria
- Learning Insights - AI-powered analysis of your course selection
- Course Insights - AI analysis of how courses complement each other
- Learning Path Recommendations - Understand course progression and career opportunities
- Provider Integration - Support for major platforms (Coursera, Udemy, edX, LinkedIn Learning, Pluralsight)
- Responsive Design - Optimized for desktop and mobile devices
- Framework: Next.js 15 with App Router
- AI Integration: Google Gemini AI for course recommendations
- Styling: Tailwind CSS with custom gradients
- UI Components: shadcn/ui with Radix UI primitives
- State Management: Zustand with persistence
- Animations: Framer Motion
- Icons: Lucide React
- TypeScript: Full type safety throughout
- Package Manager: pnpm
- Node.js 18+
- pnpm (recommended) or npm/yarn
- Google Gemini API key
- Clone the repository:
git clone https://github.com/yourusername/pathzy-ai-course-recommender.git
cd pathzy-ai-course-recommender- Install dependencies:
pnpm install- Set up environment variables:
cp .env.example .env.localAdd your environment variables:
GEMINI_API_KEY=your_gemini_api_key_here
NEXT_PUBLIC_APP_URL=http://localhost:3000- Run the development server:
pnpm dev- Open your browser: Navigate to http://localhost:3000
src/
├── app/ # Next.js App Router
│ ├── api/ # API routes
│ │ ├── chat/ # Course recommendation endpoint
│ │ ├── course-details/ # Detailed course information
│ │ ├── course-url/ # Course URL generation
│ │ └── insights/ # AI learning path analysis
│ ├── dashboard/ # Dashboard page
│ ├── layout.tsx # Root layout
│ └── page.tsx # Home page
├── components/ # React components
│ ├── ui/ # shadcn/ui base components
│ ├── chat-interface.tsx # Main chat interface
│ ├── course-card.tsx # Individual course display
│ ├── course-list.tsx # Course grid display
│ ├── course-filters.tsx # Filtering functionality
│ ├── course-suggestion.tsx # AI insights dialog
│ ├── dashboard.tsx # Dashboard analytics
│ ├── hero-section.tsx # Landing page hero
│ └── nav-bar.tsx # Navigation component
└── lib/ # Utilities and configuration
├── store/ # Zustand state management
│ └── savedCoursesStore.ts # Course bookmarking
└── gemini.ts # AI integration
- Main conversational interface for course discovery
- Handles user queries and AI responses
- Manages course recommendations and feedback
- Displays individual course information
- Bookmark/save functionality
- AI-generated course details and URLs
- Social sharing capabilities
- Analytics and saved course management
- Advanced filtering and search
- Learning statistics and insights
- AI-powered learning path analysis
- Course relationship insights
- Personalized recommendations
| Endpoint | Description |
|---|---|
/api/chat |
Generate course recommendations from user queries |
/api/course-details |
Get detailed course information using AI |
/api/course-url |
Generate realistic course URLs |
/api/insights |
Analyze course selections and provide learning insights |
The platform uses Google's Gemini AI to:
- Parse natural language queries
- Generate relevant course suggestions
- Create detailed course descriptions
- Provide learning path analysis
- Bookmarking System: Save courses with persistent storage
- Detailed Information: AI-generated course details including prerequisites
- Provider Integration: Support for major learning platforms
- Smart Filtering: Search by level, provider, duration, and more
- Progress Tracking: Monitor saved courses by category
- Provider Statistics: See which platforms you prefer
- Level Distribution: Track learning progression
- Push to GitHub:
git push origin main- Deploy on Vercel:
- Import your repository on Vercel
- Add environment variables
- Deploy automatically
GEMINI_API_KEY=your_production_gemini_api_key
NEXT_PUBLIC_APP_URL=https://your-domain.com- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
pnpm dev # Start development server
pnpm build # Build for production
pnpm start # Start production server
pnpm lint # Run ESLint
pnpm type-check # TypeScript type checking- User authentication and profiles
- Course progress tracking
- Social features and course sharing
- Integration with more learning platforms
- Advanced recommendation algorithms
- Course reviews and ratings
This project is licensed under the MIT License - see the LICENSE file for details.
- Google Gemini AI for powering intelligent recommendations
- Next.js team for the amazing framework
- shadcn for the beautiful UI components
- Vercel for seamless deployment
Pathzy AI Course Recommender - Discover your next learning adventure with the power of AI! 🎓✨
Ask, Discover, Learn - Your personalized course journey starts here.