Skip to content

Giacomod2001/studenti-analytics

Repository files navigation

Student Intelligence Hub

Advanced Predictive Analytics for Higher Education Retention

A cloud-native platform engineered to transform raw academic data into actionable retention strategies. Powered by Google BigQuery and Streamlit, this system provides a real-time dashboard for university administrators to monitor, predict, and prevent student dropout.

Streamlit App Python License Version


Live Demo

Access Student Intelligence Hub


Features

1. Dashboard (Executive Overview)

  • Real-Time KPIs: Total enrollment, risk cases, satisfaction pulse
  • Priority Intervention Queue: Students requiring immediate attention
  • Strategic Insights: Satisfaction drivers and cluster trends

2. Intervention Console

  • Risk Tiers: Critical (>75%), Monitor (35-75%), Safe (<35%)
  • Actionable Lists: Export at-risk cohorts for outreach
  • Model Disclaimer: Built-in warning about prediction polarization

3. Student 360° (Holistic Profiling)

  • Behavioral Clustering: K-Means segmentation into 4 archetypes
  • Silent Burnout Detection: High grades + low satisfaction alerts
  • Feature Importance: Model explainability

4. Alex AI Assistant (Polyglot Expert)

  • Multilingual Support: Real-time interaction in English, Italian, Spanish, and French
  • Priority Context Mapping: Logic refined to prioritize analytical advice over greetings
  • Page-Aware Responses: Answers adapt to current view (Dashboard, Console, 360)

Technical Stack

Component Technology Description
Frontend Streamlit Python reactive web framework
Backend Google BigQuery Serverless cloud data warehouse
ML Models BigQuery ML Random Forest, K-Means, Boosted Tree
Styling CSS3 LinkedIn-inspired premium dark theme
Testing Comprehensive Suite comprehensive_test.py for project-wide validation

Project Structure

studenti-analytics/
├── streamlit_app.py    # Main application (Optimized callbacks)
├── ml_utils.py         # Polyglot AI (EN, IT, ES, FR) & ML logic
├── data_utils.py       # Optimized BigQuery data loading
├── constants.py        # Configuration and table metadata
├── styles_config.py    # LinkedIn-style CSS theme
├── comprehensive_test.py # Automated test suite
├── requirements.txt    # Python dependencies
├── SQL_QUERIES.md      # BigQuery ML queries
└── README.md           # Documentation

Installation

Prerequisites

  • Python 3.9+
  • Google Cloud Service Account (JSON Key)

Setup

# Clone
git clone https://github.com/Giacomod2001/studenti-analytics.git
cd studenti-analytics

# Install dependencies
pip install -r requirements.txt

# Run Tests
python comprehensive_test.py

# Run App
streamlit run streamlit_app.py

ML Models

Model Algorithm Purpose
Churn Prediction Random Forest Dropout probability scoring
Clustering K-Means (K=4) Behavioral segmentation
Satisfaction Boosted Tree Experience score prediction

Note: Model predictions may show polarized distributions. See SQL_QUERIES.md for implementation details.


Authors (IULM University - A.Y. 2025-2026)

  • Alessandro Geli
  • Giacomo Dellacqua
  • Paolo Junior Del Giudice
  • Ruben Scoletta
  • Luca Tallarico

License

Apache License 2.0 - See LICENSE

About

Student Intelligence Hub: Cloud-native ML platform for university dropout prediction. Features "Control Tower" dashboard with split-screen intelligence, intervention console with risk tiers (Critical >75%, Monitor 35-75%), and Student 360 profiling. Includes Psychometric Intelligence detecting Silent Burnout and Resilient students.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages