✨ Features

📝 Smart Onboarding

• Input your exam date, subjects, and syllabus
• Rate your confidence level per subject (1-5)
• Specify available daily study hours
• Indicate current stress level

📅 Intelligent Schedule Generation

• Day-by-day task breakdown with effort ratings
• Strategic mix of study, review, practice, and breaks
• Daily checkpoints and stress management tips
• Pacing philosophy tailored to your situation

🔄 Adaptive Re-Planning

• Check in daily with completed tasks
• Report stress level changes
• AI regenerates the plan based on:
  • Missed tasks (dropped or condensed, not just pushed)
  • Stress increases (reduced difficulty for next 2 days)
  • Actual progress vs. expected progress

📊 Visual Dashboard

• Progress tracking with interactive charts
• Task completion interface
• Strategy overview panel
• Stress tips and motivation boosters

🚀 Quick Start

Prerequisites

• Node.js (v18 or higher)
• Gemini API Key

Installation

# Clone the repository
git clone https://github.com/yourusername/academic-rescue-agent.git
cd academic-rescue-agent

# Install dependencies
npm install

# Set up environment variables
# Edit .env.local and add your Gemini API key
VITE_GEMINI_API_KEY=your_api_key_here

# Start the development server
npm run dev

The app will be available at http://localhost:5173

🧠 How It Works

flowchart LR
    A[📝 Input Profile] --> B[🤖 AI Analysis]
    B --> C[📅 Generate Plan]
    C --> D[✅ Execute Tasks]
    D --> E[📊 Daily Check-in]
    E --> F{Stress Changed?}
    F -- Yes --> G[🔄 Adapt Plan]
    F -- No --> D
    G --> D

AI Reasoning Framework

The Gemini AI follows a specialized reasoning framework:

1. Time Scarcity Analysis — Calculates remaining days, identifies impossible coverage zones
2. Cognitive Load Management — Avoids consecutive high-effort tasks, inserts recovery
3. Weakness-Priority Logic — Focuses on low-confidence + high-impact topics
4. Stress-Adaptive Planning — High stress = reduced volume automatically
5. Human Behavior Assumptions — Accounts for procrastination and anxiety

🛠️ Tech Stack

📁 Project Structure

crampilot/
├── App.tsx                 # Main application component
├── types.ts                # TypeScript type definitions
├── components/
│   ├── Onboarding.tsx      # Initial setup wizard
│   ├── Dashboard.tsx       # Main study dashboard
│   └── TaskCard.tsx        # Individual task component
├── services/
│   └── gemini.ts           # Gemini AI integration
├── .env.local              # Environment variables
└── vite.config.ts          # Vite configuration

🔑 Environment Variables

📸 Screenshots

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Built with Google Gemini AI
• Icons by Lucide
• Designed for students, by someone who understands exam stress

CramPilot — Made with ❤️ for stressed students everywhere

"When the syllabus is infinite but time isn't — we've got your back."