Dancunmau/Chuka-university-graph-rag

# Chuka University GraphRAG Assistant **Empowering 15,000+ students with an intelligent, context-aware academic ecosystem.** The Chuka University Assistant is a state-of-the-art **Hybrid RAG (Retrieval-Augmented Generation)** platform. It bridges the gap between structured institutional data (Neo4j Knowledge Graph) and unstructured academic policies (FAISS Vector Store) to provide students with a single, accurate point of truth for their university experience. --- ## Vision: The Student Command Center Our goal is to eliminate the "Information Desert" by giving every student a personalized AI counselor that understands their program, their year of study, and their daily schedule. ### **Key Strategic Features** - **Hybrid Intelligence**: Combines **Neo4j Cypher** logic for structured data (who teaches what, when, and where) with **FAISS vector search** for policy documents (Student Handbook, Statutes). - **Time-Aware Conversationalist**: The assistant is contextually aware of "now." It translates queries like *"What is my schedule today?"* or *"Where is my class tomorrow?"* into precise database lookups. - **Voice & Multi-Modal**: Students can dictate queries via **Speech-to-Text** or upload PDF documents (fee statements, personal timetables) for instant AI analysis. - **Personalized Sidebar**: A "ChatGPT-style" interface that persists session history, generates on-the-fly PDF timetables, and manages academic identities. - **Examination & Community Hub**: Direct integration with the university repository, providing instant links to past papers and community-curated study resources. --- ## The Hybrid Engine: How it Works The platform operates on a **Dual-Layer Retrieval** strategy orchestrated by **Google Gemini 2.0 Flash**: 1. **The Knowledge Graph (Neo4j)**: - Maps the university from the top down: `Faculty ➔ Department ➔ Programme ➔ CourseUnit`. - Connects units to `TimetableSlot` and `Room` nodes for real-time schedule resolution. - Links `CourseUn …