Skip to content

devyansh770-hue/AIStudyAssistant

Repository files navigation

🚀 StudyAI

Advanced Cognitive Learning Ecosystem & AI-Powered LMS

Build Status Python Version Django Version Gemini Render


📖 Overview

StudyAI is not just another flashcard app. It is a high-performance AI-Powered Learning Management System (LMS) engineered to optimize student retention. By utilizing real-time cognitive modeling, heuristic error analysis, and autonomous knowledge extraction, StudyAI acts as a personalized tutor that understands how and why you learn.


🎨 Design Philosophy: "Focus through Aesthetics"

Our UI is built around a Premium Glassmorphism Design System crafted entirely from scratch using Vanilla CSS.

  • Reduced Visual Fatigue: Carefully selected color palettes and opacity levels.
  • Deep Work Enablement: A futuristic, high-end feel that minimizes distractions and encourages flow-state study sessions.

🧠 Advanced Engineering Features

1. 📉 Hybrid NLP Mistake Pattern Analyzer

Instead of basic binary error logging (right/wrong), StudyAI utilizes a Hybrid NLP Engine powered by Gemini 1.5 Pro.

  • Pattern Recognition: Heuristically clusters your errors into psychological categories (e.g., Conceptual Confusion, Difficulty Ceilings, or Time-Pressure Fatigue).
  • Semantic Synthesis: Translates raw structured performance data into actionable, natural-language insights.

2. 🔥 Adaptive Cognitive Load Optimizer

Powered by a custom Heuristic State-Space Model, StudyAI tracks your engagement and mental fatigue in real-time.

  • Dynamic Load Estimation: Adjusts a cognitive load variable dynamically based on time-weighted rewards and difficulty penalties.
  • Flow Zone Detection: Automatically recommends difficulty adjustments or scheduled breaks to keep you perfectly balanced between challenge and skill.

3. 🕸️ Autonomous Knowledge Graph Construction

Say goodbye to linear learning. StudyAI performs Entity-Relationship Extraction (ERE) on unstructured course syllabi.

  • Relational Mapping: Dynamically builds an adjacency list of concepts and dependencies (requires, part_of, leads_to).
  • Mastery Visualization: Renders a stunning force-directed graph using vis.js, where node colors actively reflect your real-time mastery.

4. 📅 Neural Spaced-Repetition Scheduler

A completely data-driven study planner that prioritizes topics to ensure long-term memory consolidation, analyzing both your historical quiz decay rates and upcoming exam proximity.


🛠️ High-Performance Tech Stack

Category Technologies Used
Backend Engineering Python 3.13, Django 6, PostgreSQL (Prod) / SQLite (Dev)
AI / Orchestration Google Gemini 1.5 Pro, GenAI SDK, Custom Heuristic Modeling
Frontend Architecture Vanilla CSS (Glassmorphism), JavaScript (ES6+), vis.js
DevOps & Deployment Docker, Jenkins CI/CD, Render, Supabase
Security & Ops Google OAuth 2.0, WhiteNoise, Gunicorn, OTP-Auth, Rate-Limiting

👥 The Team

Designed and developed by:


🚀 Quick Start (Local Development)

Follow these steps to get StudyAI running on your local machine:

# 1. Clone the repository
git clone https://github.com/devyansh770-hue/AIStudyAssistant.git
cd AIStudyAssistant

# 2. Create and activate a virtual environment (optional but recommended)
python -m venv venv
source venv/bin/activate  # On Windows use: venv\Scripts\activate

# 3. Install dependencies
pip install -r requirements.txt

# 4. Set up environment variables
cp .env.example .env
# Make sure to add your GEMINI_API_KEY and other credentials in the .env file

# 5. Run database migrations
python manage.py migrate

# 6. Launch the local server
python manage.py runserver

Visit http://localhost:8000 in your browser to access the platform.


Built with ❤️ for better learning.

About

Created an AI-powered study assistant that analyzes learning patterns, recommends study materials, generates practice questions, and provides personalized study schedules based on exam dates and course complexity.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors