Unitru Academic is a personal dashboard for students of the Universidad Nacional de Trujillo (UNT). It automates login to the Sistema Universitario Virtual (SUV) using a headless Chromium browser, solves the CAPTCHA with local OCR, and delivers your grades, attendance, schedule, and academic history — all in a single real-time session over WebSocket.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/Andr21Da16/UNITRU-ACADEMIC/llms.txt
Use this file to discover all available pages before exploring further.
Quick Start
Run the full stack locally with Docker Compose in under five minutes.
Deploy to Railway
Ship both services to Railway with public domains and TLS in minutes.
Features Overview
Grades, predictor, schedule optimizer, attendance, analytics, and more.
API Reference
Integrate with the WebSocket API to build your own clients.
What Unitru Academic does
After you enter your SUV credentials, Unitru Academic:Authenticates against the SUV
Opens the SUV login page in a headless Chromium browser, downloads the CAPTCHA image, solves it with Tesseract OCR, and submits your credentials. Up to three automatic retries on CAPTCHA failures.
Extracts all academic data in one session
Navigates through every SUV section — profile, academic record, enrollment, attendance, and grades — without requiring you to click through each page manually.
Enriches and analyzes your data
Runs the grade predictor (what scores do you need to pass?), builds your weekly schedule from attendance records, and computes period-by-period analytics on your full history.
Key features
Grade Predictor
Enumerate every passing note combination for courses with pending units.
Schedule & Optimizer
View your weekly schedule and find the best conflict-free section set for next cycle.
Attendance Tracking
Per-course attendance percentage with at-risk alerts.
Academic Record
Full course history across all periods with credits and weighted averages.
Analytics
Pass rates, course retries, best/worst periods, and overall statistics.
Student Profile
Personal and academic profile data including photo, extracted from the SUV.
Credentials are never stored. They exist only in memory during the active WebSocket session and are discarded the moment the connection closes.