An open API service indexing awesome lists of open source software.

https://github.com/rickysoo/learn3

Learn Anything in 3 Videos - Skip the clutter. Get 3 videos. Perfect for learning.
https://github.com/rickysoo/learn3

education learning recommender video youtube

Last synced: 7 months ago
JSON representation

Learn Anything in 3 Videos - Skip the clutter. Get 3 videos. Perfect for learning.

Awesome Lists containing this project

README

          

# Learn3 🎯

**Your personal video curator for learning anything, fast âš¡**

Learn3 is an AI-powered educational platform that transforms any topic into a structured 3-video learning path. Whether you want to master quantum physics, improve your public speaking, or learn digital marketing, Learn3 curates the perfect video progression to take you from zero to hero.

## 🌟 What Makes Learn3 Special

- **AI-Curated Learning Paths**: Advanced AI analyzes thousands of YouTube videos to select the perfect 3-video progression
- **Smart Difficulty Progression**: Videos are intelligently ordered from beginner to advanced using OpenAI analysis
- **Bookmark & Save**: Sign in to save your favorite learning paths and access them anytime
- **Instant Video Restoration**: Bookmarked searches restore the exact same videos you saved
- **Instant Topic Suggestions**: Get fresh learning ideas powered by AI across diverse fields
- **Progressive Web App**: Install on any device for offline access and native app experience
- **Google Authentication**: Secure sign-in with your Google account

## 🎯 Who Is This For?

### Students & Learners
- Quickly grasp new concepts with structured video sequences
- Get expert-curated content without spending hours searching
- Perfect for visual learners who prefer video-based education

### Professionals
- Upskill efficiently during lunch breaks or commutes
- Learn industry-specific skills with vetted, high-quality content
- Stay current with emerging technologies and methodologies

### Educators & Trainers
- Discover quality educational videos for course development
- Find supplementary materials for classroom instruction
- Create structured learning modules for students

### Curious Minds
- Explore new interests with confidence in content quality
- Learn diverse topics from economics to art to programming
- Turn random curiosity into structured knowledge acquisition

## 🚀 How to Use Learn3

### 1. **Enter Your Topic**
Type anything you want to learn in the search box. Examples:
- "Machine Learning"
- "Public Speaking"
- "Italian Cooking"
- "Personal Finance"
- "Web Design"

### 2. **Get Your Video Trio**
Learn3's AI instantly analyzes thousands of videos and selects 3 perfect ones:
- **Level 1**: Foundation concepts to get you started
- **Level 2**: Hands-on applications to level up
- **Level 3**: Advanced insights to master the topic

### 3. **Save Your Learning Path**
Sign in with Google to bookmark your video searches. Saved bookmarks restore the exact same videos you originally found.

### 4. **Follow the Path**
Watch the videos in order for optimal learning progression. Each video builds on the previous one, ensuring you develop solid understanding.

### 5. **Access Your Saved Content**
Visit your bookmarks page to view all saved learning paths. Click "View Videos" to instantly restore your saved video collections.

### 6. **Explore More**
Use the AI-generated topic suggestions to discover new learning opportunities, or search for related topics to deepen your knowledge.

## 📱 Installation as a Mobile App

Learn3 works as a Progressive Web App (PWA), meaning you can install it on your device:

### On Mobile (iOS/Android):
1. Open Learn3 in your browser
2. Look for the "Install App" prompt or
3. Tap the share button and select "Add to Home Screen"
4. Enjoy native app experience with offline capabilities

### On Desktop:
1. Open Learn3 in Chrome, Edge, or Firefox
2. Look for the install icon in the address bar
3. Click "Install" when prompted
4. Access Learn3 from your desktop or start menu

## 🔧 Technical Overview

Learn3 is built with modern web technologies for performance, scalability, and user experience.

### Architecture
- **Frontend**: React with TypeScript, responsive design with Tailwind CSS
- **Backend**: Node.js with Express, RESTful API architecture
- **Database**: PostgreSQL with Drizzle ORM for type-safe database operations
- **Authentication**: Firebase OAuth with Google sign-in integration
- **AI Integration**: OpenAI GPT-4o for content analysis and topic generation
- **Video Source**: YouTube Data API with intelligent quota management

### Key Features

#### User Authentication & Bookmarks
- **Google Sign-In**: Secure authentication via Firebase OAuth
- **Personal Bookmarks**: Save and restore exact video learning paths
- **Instant Access**: Bookmarked searches load saved videos without new API calls
- **User Session Management**: Seamless authentication state handling

#### AI-Powered Video Analysis
- **Relevance Scoring**: OpenAI analyzes video content for topic relevance (0-100 scale)
- **Difficulty Assessment**: AI determines complexity level (1-3 scale) for proper progression
- **Content Quality**: Filters ensure educational value and appropriate duration (2-60 minutes)

#### Smart Search System
- **Intelligent Caching**: 30-minute cache for frequently searched topics
- **Recency Weighting**: Balances content quality with publication date
- **Multi-source Integration**: Comprehensive video discovery and analysis

#### Progressive Web App
- **Service Worker**: Offline functionality and improved performance
- **Manifest**: Native app installation and experience
- **Responsive Design**: Optimized for mobile, tablet, and desktop

#### Analytics & Insights
- **User Behavior Tracking**: Search patterns and video engagement analytics
- **Learning Path Analytics**: Popular topics and content effectiveness tracking

### Technology Stack

#### Frontend
```
React 18 + TypeScript
Tailwind CSS + shadcn/ui components
Progressive Web App (PWA)
Responsive design
```

#### Backend
```
Node.js + Express
PostgreSQL database
AI integration for content analysis
External video source integration
```

#### Infrastructure
```
Firebase Authentication
Modern web standards
Cross-platform compatibility
Analytics integration
```

### Data Management

#### User Content
- Personal bookmark collections
- Saved learning path histories
- User authentication sessions
- Search preference tracking

#### Video Content
- Curated video metadata and descriptions
- AI-generated relevance and difficulty scores
- Learning path associations and progression tracking
- Content quality assessments and filtering

#### Analytics Data
- Learning pattern analysis
- Popular topic identification
- User engagement metrics
- Platform usage insights

## 🎨 Key Features in Detail

### Intelligent Video Curation
Learn3's AI doesn't just find random videos - it carefully analyzes content to ensure each video in your learning path serves a specific purpose. The system evaluates factors like:
- Educational value and content depth
- Appropriate difficulty progression
- Video quality and production value
- Recent publication for current information

### Personalized Learning Experience
- **Custom Learning Paths**: Every search creates a unique 3-video journey tailored to the topic
- **Smart Bookmarking**: Save your discoveries and return to the exact same curated content
- **Progress Tracking**: See your learning history and favorite topics
- **Instant Access**: One-click restoration of saved learning paths

### Cross-Platform Accessibility
- **Mobile Optimized**: Perfect learning experience on phones and tablets
- **Desktop Ready**: Full-featured experience on larger screens
- **Offline Capable**: Progressive Web App technology for offline access
- **Universal Compatibility**: Works on any modern browser

## 🎯 Use Cases & Examples

### For Students
- **Research Projects**: "Climate Change Effects" → Get foundation videos, case studies, and advanced analysis
- **Exam Preparation**: "Organic Chemistry" → Basic concepts, problem-solving, and advanced mechanisms
- **New Subjects**: "Introduction to Psychology" → Theory overview, practical applications, research methods

### For Professionals
- **Skill Development**: "Data Visualization" → Tools introduction, best practices, advanced techniques
- **Industry Updates**: "Machine Learning 2024" → Current trends, new frameworks, implementation guides
- **Leadership Growth**: "Team Management" → Basic principles, conflict resolution, strategic leadership

### For Hobbyists
- **Creative Skills**: "Digital Photography" → Camera basics, composition rules, advanced editing
- **Home Improvement**: "Kitchen Renovation" → Planning basics, installation techniques, professional tips
- **Fitness Goals**: "Marathon Training" → Beginner running, training plans, advanced strategies

## 💡 Learning Tips

### Maximize Your Learning
1. **Watch in Order**: Each video builds on the previous one for optimal comprehension
2. **Take Notes**: Pause and write down key concepts from each level
3. **Practice Active Learning**: Try to apply concepts between videos
4. **Save Quality Paths**: Bookmark exceptional learning sequences for future reference
5. **Explore Related Topics**: Use topic suggestions to deepen your knowledge

### Getting the Best Results
- **Be Specific**: "JavaScript Array Methods" works better than just "JavaScript"
- **Try Different Angles**: Search "Public Speaking Tips" and "Presentation Skills" for varied perspectives
- **Use Your Bookmarks**: Return to saved paths when you need to refresh your knowledge
- **Follow the Progression**: Trust the AI's difficulty assessment for optimal learning flow

## 🌟 Why Learn3 Works

Learn3 transforms the overwhelming task of finding quality educational content into a streamlined, personalized experience. Instead of spending hours searching through countless videos, you get a carefully curated learning path in seconds.

**The Problem**: YouTube has millions of educational videos, but finding the right sequence for learning is time-consuming and often results in random, disconnected content.

**The Solution**: Learn3's AI analyzes content quality, difficulty levels, and educational value to create coherent learning progressions that actually build knowledge systematically.

---

**Ready to start learning?** 🚀