henokakriso/Edunex

AI-powered education & learning management platform for Ethiopia — LMS, AI tutoring, assessments, performance tracking. Part of Project ARWE. # Edunex — AI-Powered Ethiopian Learning Platform **Core vision:** Create a unified intelligent education ecosystem for Ethiopia. *Part of Project ARWE.* ## Overview Edunex is a full-stack **Learning Management System (LMS)** built for Ethiopian schools: a PHP 8 + MySQL web application with a dark, role-based UI and a C desktop client (ncurses + libcurl) that syncs through the same JSON API. It covers the full school lifecycle — administration, teaching, exams, attendance, messaging, transfers, gamification and an AI tutoring layer — with an integrity ledger that makes grading and certificates tamper-evident. ## Problem Ethiopian schools juggle paper registers, spreadsheets and disconnected tools. Teachers cannot easily generate courses and exams, students move between schools with no portable record, attendance is hard to audit, and AI assistance requires cloud APIs that offline or low-bandwidth campuses cannot reach. ## Solution Edunex puts the whole school on one platform with clear role separation (super admin, director, teacher, student, parent, guest): - **Offline-first AI** — a local Ollama tutor (`edunex-tutor`, qwen2.5 3B) with an optional vision model; a provider abstraction (`local` / `openai`) means the AI layer works with no API key at all. - **PDF-book course generator** — teachers upload a book and get a course plus an exam through the configured AI provider. - **Portable student records** — school-to-school transfers move the complete profile (XP, badges, goals, certificates, grades, attendance) via referral codes. - **Tamper-evident integrity ledger** — grading, attendance and certificate events are SHA-256 hash-chained and visible at Admin → Integrity Ledger. - **C desktop client** — ncurses terminal client for low-resource environments, syncing via the JSON API with HMAC bearer auth. ## Features - Courses, lessons, exams & grading, assignments - Attendance: teacher marking, QR codes, student code check-in, attendance-mobile endpoints - A …