# Eddy AI English Tutor - LLM Context

## Project Overview

Eddy AI English Tutor is an advanced AI-powered educational platform that provides personalized, interactive English language learning experiences. The application features Eddy, a friendly 40-year-old bear teacher character who engages students through natural voice conversations, interactive activities, and visual learning elements.

### Core Mission
- Provide personalized English language learning through AI-powered conversations
- Create engaging, interactive educational experiences for ESL learners
- Support various age groups and proficiency levels (beginners to intermediate)
- Goal: Contribute to eradicating illiteracy by 2030

## Core Features

### AI Tutor Personality
- **Character**: Eddy - a warm, playful 40-year-old bear teacher
- **Voice**: Upbeat, patient, and encouraging (similar to Yogi Bear)
- **Teaching Style**: Combines educational value with engaging interactions
- **Adaptability**: Adjusts tone and complexity based on student age and level

### Interactive Learning Activities
1. **Word Presentation**
   - Visual aids and image representations
   - New vocabulary introduction

2. **Quiz Activities**
   - Multiple choice questions (3-4 options)
   - Immediate feedback system

3. **Photo Quiz**
   - Visual-based learning with image choices
   - Clear, unambiguous visual elements

4. **Cloze Activities**
   - Fill-in-the-blank exercises
   - Hint system and multiple word support

5. **Sorting/Unscramble**
   - Word categorization and relationship understanding
   - Interactive validation

6. **Pronunciation Practice**
   - Speech recognition and pronunciation feedback

7. **Interactive Text Exercises**
   - Open text responses
   - Text highlighting and interaction

8. **Camera Integration**
   - Photo-based learning exercises
   - Real-world object recognition

### Real-time Features
- **Voice Interaction**: Natural conversations using OpenAI Realtime API
- **WebRTC Integration**: Real-time audio processing
- **Live Feedback**: Immediate responses and corrections
- **Session Management**: Persistent learning sessions

### Progress Tracking
- **Achievement System**: Badge collection and milestones
- **Session Summaries**: Detailed learning progress reports
- **Credits System**: Usage-based learning credits
- **Leaderboards**: Social learning motivation

## User Experience Design

### Learning Flow
1. **Onboarding**: Age and language selection
2. **Assessment**: Initial skill evaluation
3. **Lesson Selection**: Personalized recommendations
4. **Interactive Learning**: Voice-based activities
5. **Progress Tracking**: Achievement and feedback
6. **Social Features**: Leaderboards and sharing

### Accessibility Features
- **Multi-language Support**: i18n implementation
- **Voice Recognition**: Speech-to-text capabilities
- **Visual Indicators**: Clear progress markers
- **Keyboard Navigation**: Full keyboard accessibility
- **Screen Reader Support**: ARIA compliance