cs-navigator

<h1 align="center">CS Navigator</h1>
<p align="center"><strong>AI-Powered Academic Advising for Morgan State University</strong></p>
<p align="center">
  <a href="https://cs.inavigator.ai">Live App</a> |
  <a href="https://api.inavigator.ai/docs">API Docs</a> |
  <a href="#architecture">Architecture</a> |
  <a href="#version-history">Version History</a>
</p>
<p align="center">
  <a href="https://github.com/theaayushstha1/cs-navigator/actions"><img src="https://github.com/theaayushstha1/cs-navigator/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
  <a href="https://github.com/theaayushstha1/cs-navigator/releases/tag/v5.1"><img src="https://img.shields.io/badge/version-5.1-blue" alt="Version"></a>
  <img src="https://img.shields.io/badge/accuracy-100%25%20(50Q)-brightgreen" alt="Accuracy">
  <img src="https://img.shields.io/badge/response-3.9s%20avg-brightgreen" alt="Response Time">
  <img src="https://img.shields.io/badge/deploy-Google%20Cloud%20Run-4285F4" alt="Deploy">
  <img src="https://img.shields.io/badge/AI-Google%20ADK%20%2B%20Gemini-orange" alt="AI">
  <a href="https://github.com/theaayushstha1/cs-navigator/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-green" alt="License"></a>
</p>

---

CS Navigator is a production AI chatbot serving 800+ CS students at Morgan State University. Students ask questions in plain English and get personalized answers grounded in the department's knowledge base, their DegreeWorks academic record, and Canvas LMS grades.

Built with Google ADK (Agent Development Kit), Gemini 2.0 Flash, and Vertex AI Search. Uses a novel **Retrieval-Enforced Generation (REG)** pipeline that guarantees KB grounding at three layers: pre-generation context injection, tool-based retrieval, and post-generation verification. Zero hallucinations across 200+ tested queries with 3.9s average response time.

Deployed on Google Cloud Run with multi-instance scaling, database-backed session persistence, and a 2-tier caching system.

-