Arjuna AI: GenAI-Powered Student Performance Prediction System 🎯

Arjuna AI is an advanced, comprehensive educational platform built for the IBM-PBEL 3.0 GenAI submission. It leverages Machine Learning and Google's Gemini LLM to predict student academic performance, identify at-risk behaviors, and provide highly personalized, actionable counseling to ensure every student reaches their full potential.

🚀 Key Features

🧠 Predictive Analytics & Explainable AI

• Performance Prediction: Analyzes sleep, study hours, screen time, attendance, and extracurriculars to predict final academic scores.
• SHAP Integration: Visually explains the "Why" behind every prediction, breaking down the exact impact of each lifestyle factor.

🤖 Arjuna Counselor Chatbot

• Interactive AI Guide: A fully conversational AI assistant built directly into the student portal.
• Voice Engine (TTS): Gender-matched, Indian-accented voice counseling that can read out study plans and chat responses dynamically.
• Hindi Translation: Real-time translation and spoken audio in Hindi to break down language barriers.

👑 Admin & Counselor Dashboard

• Deep Drill-Down Analytics: Clickable overview metrics for Total Predictions, At-Risk Students, and Top Performers.
• Expected Topper Algorithm: Automatically flags students matching >95% State/Board Topper benchmarks with detailed reasoning.
• User Management: Admins can view full student profiles, intercept raw Chat Histories, and forcefully delete/moderate accounts.

🧑‍🎓 Student & Parent Portals

• Dynamic Study Planner: Generates personalized, modular study blocks and behavioral routines (including specialized wellness blocks based on gender/profile).
• Global Anonymous Leaderboard: Gamified ranking system where students compete anonymously, but Admins retain full visibility.
• PDF Export: Seamless html2pdf.js integration to export beautiful, highly-organized Performance Reports.
• Progressive Web App (PWA): Fully installable on Desktop and Mobile devices for offline access and native app-like experience.

🛠️ Technology Stack

• Frontend: React (Vite), Lucide-React, Recharts, html2pdf.js
• Backend: FastAPI (Python), SQLite, SQLAlchemy
• AI / ML: Google Gemini 1.5 Flash (Generative AI), Scikit-Learn (RandomForest), SHAP (Explainability)

⚙️ Local Setup Instructions

1. Clone the repository

   git clone https://github.com/your-username/Arjuna-AI_An-AI-Based-Student-Performance-Prediction-System.git
   cd Arjuna-AI_An-AI-Based-Student-Performance-Prediction-System

2. Setup the Backend (FastAPI)

   pip install -r requirements.txt
   python -m uvicorn main:app --reload --port 8000

3. Setup the Frontend (React) Open a new terminal window:

   npm install
   npm run dev

4. Access the Application Open your browser and navigate to http://localhost:5173. Use student login or the Admin portal (ID: ADMIN, Pass: admin123).

📜 License

This project is licensed under the MIT License.