StudyGuardian AI is a next-generation education tool designed to revolutionize how students interact with their study materials. By leveraging the advanced capabilities of the Google Gemini 1.5 & 2.5 Flash models, we transform complex, lengthy lectures into actionable, bite-sized knowledge in seconds.
Built for speed, accuracy, and accessibility, this platform helps students overcome information overload and focus on "Start Smart" rather than just studying hard.
Students today face an overwhelming amount of content: lengthy PDF lectures, complex textbooks, and unstructured notes.
- Problem: 80% of study time is often wasted just organizing and trying to understand complex material before actual learning begins.
- Gap: Existing tools are either too slow, lack Arabic support, or provide generic, unhelpful summaries.
StudyGuardian acts as a personal Elite Professor. It doesn't just summarize; it teaches. Using a custom-tuned AI prompt engineering strategy (the Feynman Technique), it breaks down concepts, quizzes the student, and generates a personalized study roadmap.
- ⚡ Blazing Fast Analysis: Optimized with
gemini-1.5-flashand2.5-flashmodels for sub-second response times. - 🔄 Smart Caching & Zero-Lag: Uses intelligent LocalStorage caching. Reload the page, and your study session is instantly restored. No waiting.
- 🌍 Bilingual Excellence: Fully optimized for Arabic & English. It understands academic Arabic dialects and terms perfectly.
- 📄 Professional PDF Export: Generates print-ready, clean academic study guides (Magazine Style) for offline study.
- 🛡️ Robust API Failover: Features an enterprise-grade multi-key rotation system. If one API key fails, it instantly switches to a backup without interrupting the user.
- Frontend: Next.js 14 (App Router) - For a modern, server-optimized React framework.
- Styling: Tailwind CSS + Framer Motion - For a premium, fluid, and responsive UI.
- AI Engine: Google Generative AI SDK - Integrated with deeply custom-engineered prompts.
- State Management: React Hooks + Persistent LocalStorage Strategy.
- Deployment: Vercel / Netlify ready.
- Input: User uploads a PDF or pastes text.
- Processing: The system identifies the language and context.
- Prompt Engineering: We inject a specialized "Elite Professor" persona into the AI, instructing it to use specific teaching methodologies (e.g., analogies, concrete examples).
- Output Generation: A structured JSON response is returned containing:
- Executive Summary
- Simplification (Feynman Style)
- Critical Thinking Exam Questions
- 3-Day Action Plan
- Rendering: The UI renders this markdown beautifully, ready for interactive study or PDF export.
-
Clone the repository
git clone https://github.com/mohammed18salah/StudyGuardian-AI.git cd studyguardian-ai -
Install dependencies
npm install
-
Set up Environment Variables Create a
.env.localfile and add your Google Gemini Keys:GEMINI_API_KEY=your_primary_key GEMINI_API_KEY_BACKUP=your_backup_key
-
Run the development server
npm run dev
-
Open http://localhost:3000 and start learning!
Built with ❤️ for the Hackathon Community by Mohammed Salahuldeen.