Adaptive Study Sessions.md - himent12/FlashGenie GitHub Wiki

๐Ÿง  Adaptive Study Sessions

FlashGenie's Adaptive Study Sessions use AI to create personalized study plans based on your context, preferences, and learning patterns.

๐ŸŽฏ What Are Adaptive Study Sessions?

Adaptive Study Sessions are AI-powered study plans that optimize your learning by considering:

  • Available time - How much time you have to study
  • Energy levels - Your current mental state and focus
  • Environment - Where you're studying (home, commute, etc.)
  • Learning goals - What you want to achieve
  • Historical performance - How you've performed previously
  • Card difficulty - The challenge level of your content

๐Ÿ’ก Key Features

Dynamic Session Structure

Each adaptive session is structured into phases:

  1. Warmup Phase - Easy, familiar cards to build confidence
  2. Core Learning Phase - Balanced mix of new and review cards
  3. Challenge Phase - Difficult cards when your focus is optimal
  4. Cooldown Phase - Reinforcement of key concepts

Intelligent Break Scheduling

# Create a plan with automatic break scheduling
python -m flashgenie plan "Biology" --time 45 --energy 4

The system will suggest optimal break timing:

Recommended breaks: 12min, 27min, 38min

Environment Awareness

# Create a plan optimized for mobile study during commute
python -m flashgenie plan "Spanish" --time 20 --environment commuting

The system adapts to different environments:

  • Quiet environments - More challenging content, deeper learning
  • Noisy environments - Shorter, more focused cards
  • Mobile environments - Simplified interaction, visual emphasis

๐Ÿš€ Using Adaptive Study Sessions

Basic Usage

# Create a basic adaptive plan
python -m flashgenie plan "Spanish Vocabulary" --time 30

Advanced Usage

# Fully specified adaptive plan
python -m flashgenie plan "Biology" \
  --time 45 \
  --energy 4 \
  --environment quiet_home \
  --goal mastery \
  --device desktop

Available Parameters

Parameter Description Values
--time Available study time (minutes) 5-180
--energy Current energy level 1-5
--environment Study environment quiet_home, noisy_public, commuting, workplace, bed
--goal Learning goal review, acquisition, mastery, test_prep
--device Device type desktop, laptop, tablet, smartphone

๐Ÿงช The Science Behind It

FlashGenie's adaptive sessions are based on cognitive science research:

  • Spaced Repetition - Optimized review intervals based on the forgetting curve
  • Desirable Difficulty - Calibrated challenge levels for optimal learning
  • Cognitive Load Theory - Balanced mental effort for effective learning
  • Circadian Rhythms - Alignment with natural energy patterns
  • Context-Dependent Memory - Environmental factors in memory formation

๐Ÿ“Š Example Study Plans

Morning Study Session (High Energy)

python -m flashgenie plan "Biology" --time 45 --energy 5 --environment quiet_home

Generates a plan with:

  • 10-minute intensive new card learning
  • 25-minute challenging review
  • 5-minute mastery reinforcement
  • 5-minute breaks distributed optimally

Quick Commute Review (Medium Energy)

python -m flashgenie plan "Vocabulary" --time 15 --energy 3 --environment commuting

Generates a plan with:

  • Short, focused card reviews
  • Mobile-optimized presentation
  • Interruption-resistant sequencing
  • No scheduled breaks

Evening Wind-Down (Low Energy)

python -m flashgenie plan "Light Reading" --time 20 --energy 2 --environment bed

Generates a plan with:

  • Easy, familiar content
  • Gentle pacing
  • Confidence-building progression
  • Relaxed interaction style

๐Ÿ” Viewing and Analyzing Plans

# View your last study plan
python -m flashgenie plan-history

# Analyze plan effectiveness
python -m flashgenie plan-analysis "Spanish Vocabulary"

# Export plan to calendar
python -m flashgenie plan-export --format ical

๐ŸŽฏ Tips for Effective Adaptive Sessions

  1. Be honest about your energy level - The system works best with accurate input
  2. Specify your environment - Environmental context significantly impacts learning
  3. Set clear goals - Different goals lead to different optimal structures
  4. Follow break recommendations - They're scientifically calculated for optimal retention
  5. Provide feedback - Rate sessions to improve future recommendations

๐Ÿš€ Next Steps


FlashGenie v1.5.0 | Last updated: June 2025