🎯 AI Student Exam Assistant

Plan smarter. Study better. Score higher.

An AI-powered academic strategy engine that generates personalized, time-optimized study plans using Google Gemini.

---

🚀 Overview

AI Student Exam Assistant helps students convert limited time into maximum results by generating structured, day-wise study plans based on:

• 📅 Days left for exam
• ⏳ Daily study hours
• 📘 Subject
• 📊 Preparation level

Built with Streamlit + Google Gemini AI, this app acts like a personal academic mentor.

---

💡 Problem Statement

Students often struggle with:

• ❌ What to study first
• ❌ How to plan limited time
• ❌ Inefficient revision strategies
• ❌ Exam anxiety due to lack of structure

---

✅ Solution

This project provides:

• 📅 Day-wise structured study plans
• 🎯 Priority-based topic suggestions
• ⚡ Adaptive strategies (Crash / Revision / Balanced)
• 🧠 AI-driven personalized recommendations

---

🎯 Problem Alignment

Students often face challenges in exam preparation due to:

• Lack of structured study planning
• Inefficient time management
• Difficulty identifying important topics

✅ How This Solution Addresses It

This project solves these problems by:

• Generating personalized study plans based on time constraints
• Using AI to prioritize high-impact topics
• Adapting strategies dynamically (Normal vs Last-Minute)
• Providing actionable, day-wise guidance

The system transforms unstructured preparation into a clear and optimized study strategy.

---

🧠 Key Features

• 🎯 Personalized Study Plans
• ⚡ Smart Strategy Engine (based on time & level)
• 📊 Interactive UI with sliders & inputs
• 📥 Downloadable study plans
• 🧠 AI-powered structured responses
• ⚠️ Urgency detection (last-minute exam warnings)

---

🧩 System Architecture

User Input → Strategy Engine → Prompt Generator → Gemini API → Response Formatter → UI Output

---

♿ Accessibility

This application is designed with user accessibility in mind:

• Clear labels and instructions for all inputs
• Help tooltips for better understanding
• Simple and clean UI using Streamlit
• Error messages designed for non-technical users
• Visual indicators like progress bars for guidance

The app ensures usability for beginners and non-technical users.

---

⚙️ How It Works

1. User enters:

   • Exam days
   • Study hours
   • Subject
   • Preparation level

2. System:

   • Determines strategy (Crash / Revision / Balanced)
   • Generates optimized prompt

3. Gemini AI:

   • Produces structured study plan

4. Output:

   • Displayed in UI
   • Available for download

---

☁️ Google Services Used

• Google Gemini API (Generative AI)
• Secure API key handling via environment variables

---

☁️ Google Services Integration

This project leverages Google Gemini AI for intelligent study planning.

Key usage includes:

• Context-aware prompt engineering
• Dynamic plan generation based on user input
• AI-driven prioritization of topics
• Adaptive strategies (Normal vs Last-Minute mode)

🤖 AI Capabilities

• Reasoning-based study planning
• Context-aware decision making
• Adaptive output generation

---

🧪 Testing

This project includes unit testing using pytest.

Test coverage includes:

• Strategy logic validation
• Edge case handling
• Mode-based behavior (Normal vs Last-Minute)

To run tests:

pytest

---

⚡ Efficiency

The application is optimized for performance:

• Uses caching to avoid redundant API calls
• Minimizes response latency
• Optimized prompt design to reduce token usage
• Lightweight Streamlit interface for fast loading
• Tracks response generation time

This ensures faster and resource-efficient execution.

---

🔐 Security

This project follows best practices for secure development:

• API keys are stored using environment variables (not hardcoded)
• Sensitive data is excluded using .gitignore
• Input validation prevents misuse or unexpected input
• Error handling avoids exposing internal system details

Built with security-first approach using environment-based configuration.

---

🧠 Advanced AI Pipeline

This system uses a multi-step AI reasoning approach:

1. Situation Analysis

   • Evaluates difficulty, urgency, and risk

2. Strategy Selection

   • AI determines best preparation approach

3. Plan Generation

   • Creates optimized study plan using insights

This makes the system more intelligent than traditional single-prompt solutions.

---

🚀 Unique Value Proposition

Unlike generic AI tools, this project:

• Focuses on time-based planning
• Adapts strategy dynamically
• Provides actionable daily plans, not just suggestions
• Lightweight, fast, and practical

---

📊 Impact

• ⏱ Saves 2–3 hours of planning time
• 📈 Improves study efficiency
• 🧠 Reduces exam stress
• 🎯 Helps students focus on high-impact topics

---

🛠️ Tech Stack

• Python
• Streamlit
• Google Gemini API
• Prompt Engineering

---

📸 Demo

---

🔗 Live App

👉 https://ai-student-exam-assistant.streamlit.app/

---

⚙️ Installation

git clone https://github.com/maruthisaiteja/ai-student-exam-assistant
cd ai-student-exam-assistant
pip install -r requirements.txt
streamlit run app.py

---

🔐 Environment Setup

Create .env or Streamlit Secrets:

GEMINI_API_KEY=your_api_key

---

📈 Future Enhancements

📅 Google Calendar integration 📊 Progress tracking dashboard 📚 Subject-wise syllabus breakdown 🧠 Weak topic analysis 🔔 Smart reminders

---

👨‍💻 Author

Maruthi Sai Teja B.Tech | AI Enthusiast | Builder 🚀