ekpenyongasuquo/stembridge-nigeria

# 🌉 STEMBridge Nigeria > **AI-powered WAEC/NECO tutor for Nigerian SS1–SS3 students** > Built for DSH Hacks V1 | Theme: AI × STEM Education [(emfon-stembridge-nigeria.hf…)] --- ## 🎯 The Problem Nigeria has **over 1.5 million WAEC candidates** yearly. Most cannot afford private tutors (₦5,000–₦20,000/hour). Free online resources don't understand the WAEC syllabus or use Nigerian examples. Students memorize formulas without understanding concepts — leading to high failure rates (only ~50% pass 5+ subjects in WAEC annually). ## 💡 The Solution STEMBridge is an adaptive AI tutor that: - **Speaks Nigerian** — uses Naira, Lagos-Abuja distances, NNPC/Dangote references, local ecosystems - **Knows WAEC** — RAG pipeline over real past questions (2016–2023) - **Finds misconceptions** — doesn't just give answers, identifies *why* a student got it wrong - **Adapts difficulty** — tracks performance per topic and personalizes the learning path ## 🚀 Features | Feature | Description | |---------|-------------| | 💬 AI Tutor Chat | Conversational WAEC tutor with Nigerian context and step-by-step explanations | | 📝 WAEC Quiz Generator | Auto-generated MCQ questions at WAEC difficulty level with instant feedback | | 🔍 Misconception Detector | Analyzes wrong answers to pinpoint specific conceptual gaps | | 📊 Progress Tracker | Accuracy per subject, topics covered, personalized study tips | | 🔢 4 Subjects | Mathematics, Physics, Chemistry, Biology | | 🌍 RAG Pipeline | ChromaDB vector store over scraped WAEC past questions | ## 🛠️ Tech Stack ``` Frontend: Streamlit AI Model: Google Gemini 2.0 Flash (free tier) Vector DB: ChromaDB + Sentence Transformers (all-MiniLM-L6-v2) Embeddings: Local (no API cost) Data: Scraped WAEC past questions + curated Nigerian content Deployment: Render.com ``` ## 📦 Local Setup ```bash # 1. Clone git clone github.com cd stembridge-nigeria # 2. Create virtual environment py …