Campus Assistant
AI & MLMultilingual AI helpdesk and knowledge base for educational institutions with regional RAG & Gemini.
infoProject Overview
Campus Assistant is an institutional AI helpdesk and automated knowledge system designed for universities and colleges. It resolves student inquiries across 7+ Indian regional languages (Hindi, English, Gujarati, Marathi, Punjabi, Tamil, and Rajasthani) with zero translation API costs via deep-translator. Utilizing Retrieval-Augmented Generation (RAG) powered by Google Gemini (gemini-2.0-flash / gemini-2.5-flash) and ChromaDB vector embeddings (sentence-transformers/paraphrase-multilingual-MiniLM-L12-v2), Campus Assistant answers complex academic, fee, and admission queries while routing grievances to human administrators through a real-time web console and Telegram bot bridge.
layersTechnology Stack
auto_awesomeKey Features
8 HighlightsMultilingual Pipeline (7+ Languages)
Zero-cost automatic language detection and translation across Hindi, English, Gujarati, Marathi, Punjabi, Tamil, and Rajasthani via deep-translator.
Retrieval-Augmented Generation (RAG)
Combines structured FAQ relational data and unstructured institutional documents with semantic vector search in ChromaDB.
Google Gemini Intelligence
Leverages Gemini 2.0/2.5 for contextual dialogue, student intent classification, and automated follow-up question generation.
Administrative Control Center
Comprehensive admin dashboard for analytics, conversation monitoring, PDF/DOCX syllabus ingestion, and real-time FAQ vector reindexing.
Async Database Engine
Async SQLAlchemy 2.0 with Alembic migrations supporting local SQLite development and high-throughput production PostgreSQL.
Telegram Bot Integration
Full-featured Telegram webhook daemon allowing students to query campus information directly through mobile chat.
photo_libraryInterface & Screenshot Gallery
Multilingual Chat Interface
Interactive student chat interface with seamless language selection across 7+ regional languages and dynamic follow-up suggestions.
Administrative Knowledge Dashboard
Full administrative console for real-time FAQ vector reindexing, syllabus and document ingestion, conversation monitoring, and escalation handling.
System Architecture Overview
End-to-end multi-layer architecture connecting the Next.js frontend, FastAPI API gateway, LangChain RAG pipeline, ChromaDB vector store, and async PostgreSQL persistence.
Request & Localization Flow
Step-by-step query lifecycle detailing language detection, English normalization, semantic vector retrieval, Gemini generation, and bidirectional response localization.
playlist_add_checkQuick Start & Setup Guide
$git clone https://github.com/DS-Labs-33/Campus-Assistant.git && cd Campus-Assistant/backend && python -m venv venv$source venv/bin/activate # Windows: .\venv\Scripts\Activate.ps1
pip install -r requirements.txt$cp .env.example .env
alembic upgrade head$uvicorn app.main:app --reload --port 8000$cd ../frontend && npm install && npm run devRequires Python 3.11+ and Node.js 18+. Optional Google AI API key for full Gemini LLM generation.