sayuki2117/uniben-compass-ai

AI-powered University of Benin inquiry assistant built with Next.js, FastAPI, Supabase pgvAI-powered University of Benin inquiry assistant built with Next.js, FastAPI, Supabase pgvector, and retrieval-augmented generation (RAG).ector, and retrieval-augmented generation (RAG). # UNIBEN Compass AI UNIBEN Compass AI is an AI-powered university inquiry assistant created for the University of Benin community. It helps prospective students, admitted students, current students, parents, staff, and members of the public find clear answers to questions about admissions, academic programmes, Post-UTME, postgraduate studies, clearance, fees, campuses, student services, and other university-related topics. Unlike a general-purpose chatbot, UNIBEN Compass AI uses retrieval-augmented generation (RAG) to search a dedicated University of Benin knowledge base before generating an answer. Relevant passages are retrieved from Supabase using vector similarity search and supplied to the language model as supporting context. The application also displays the retrieved sources so users can see which knowledge-base documents informed an answer. > **Project status:** Active development. Information produced by the assistant should be confirmed through official University of Benin channels before it is used for admission, payment, registration, or other important decisions. ## Key Features - AI-assisted answers to University of Benin inquiries - Retrieval-augmented generation using a custom knowledge base - Semantic search with OpenAI embeddings and Supabase pgvector - Source attribution for retrieved knowledge - Audience-aware responses for different categories of users - Conversation history and chat persistence - Responsive interface for desktop and mobile devices - FastAPI REST API with automatic interactive documentation - Support for OpenAI or OpenRouter as the chat-model provider - Separate frontend and backend applications for independent deployment ## Technology Stack ### Frontend - Next.js - React - TypeScript - Tailwind CSS - Supabase JavaScript client - Lucide React icons ### Backend - Python 3.11 - FastAPI - Uvicorn - Pydantic - OpenAI Python SDK - Supabase Python client ### Data and AI - Supabase PostgreSQL - pgvector - OpenAI embeddings …