Skip to content

Deepender25/Campus_Chatbot

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 

Repository files navigation

Campus Assistant Bot

An intelligent, multilingual AI-powered campus information assistant that transforms how students interact with university services.


Status Platform AI Languages


Table of Contents


Overview

Campus Assistant Bot is a comprehensive AI-powered solution designed to revolutionize campus information delivery. Built with cutting-edge technologies, it provides instant, accurate responses to student queries in multiple languages, available 24/7 across multiple platforms.

The Problem We Solve

Challenge Our Solution
Long queues at information desks Instant AI responses 24/7
Language barriers for diverse students Automatic multilingual support
Inconsistent information across channels Single source of truth with knowledge base
Limited office hours Round-the-clock availability
Repetitive queries consuming staff time Automated handling of FAQs

Key Features

Intelligent Conversation Engine

Sample Conversation:

Student: hi

Campus Assistant: Hello! Welcome to Gurugram University. We're delighted 
to have you join our vibrant academic community.

Student: what is the admission process

Campus Assistant: I apologize, but I do not have specific information 
regarding the admission process. To get the most accurate and up-to-date 
details, I recommend contacting the relevant campus admissions office 
directly.

Student: admission process kya h?

Campus Assistant: Ji haan, main aapko admission process ke baare mein 
detail mein bata sakta hun... Sabse accurate aur latest information ke 
liye, main aapko suggest karunga ki aap directly Campus Admissions Office 
se contact karein.
  • Context-Aware Responses: Maintains conversation history for coherent multi-turn dialogues
  • Natural Language Understanding: Processes queries in natural, conversational language
  • Smart Fallback: Gracefully escalates to human support when needed

Multilingual Support

flowchart LR
    A[User Query] --> B{Language Detection}
    B -->|English| C[English Processing]
    B -->|Hindi| D[Hindi Processing]
    C --> E[Generate Response]
    D --> E
    E --> F[Reply in Same Language]
Loading
  • Automatic Detection: No manual language selection needed
  • Native Responses: Replies in the user's preferred language
  • Extensible: Architecture supports adding new languages

Dynamic Knowledge Base

  • PDF Document Processing: Upload campus documents and FAQs
  • Vector Search: Fast, semantic search across all documents
  • Real-time Updates: Knowledge base can be updated without downtime
  • Source Attribution: Know where each answer comes from

Secure Admin Dashboard

  • Role-Based Access Control: Administrator and Moderator roles
  • Analytics Dashboard: Track usage patterns and popular queries
  • User Management: Manage access and permissions
  • Document Management: Upload, organize, and maintain knowledge base

System Architecture

High-Level Architecture

flowchart TB
    subgraph Clients["Client Applications"]
        WEB[Web Application]
        TG[Telegram Bot]
        FUTURE[Future: Mobile App]
    end

    subgraph Gateway["API Gateway Layer"]
        AUTH[Authentication]
        RATE[Rate Limiting]
    end

    subgraph Core["Core Services"]
        API[REST API]
        AI[AI Engine]
        KB[Knowledge Base]
    end

    subgraph Data["Data Layer"]
        VDB[(Vector Database)]
        RDB[(Relational Database)]
        CACHE[(Cache Layer)]
    end

    subgraph External["External Services"]
        GEMINI[Google Gemini AI]
        SUPABASE[Supabase Cloud]
    end

    WEB --> Gateway
    TG --> Gateway
    FUTURE --> Gateway
    
    Gateway --> Core
    
    API --> Data
    AI --> GEMINI
    KB --> VDB
    
    RDB --> SUPABASE
Loading

Request Flow

sequenceDiagram
    participant U as User
    participant C as Client App
    participant A as API Server
    participant K as Knowledge Base
    participant AI as AI Engine
    
    U->>C: Sends Query
    C->>A: API Request
    A->>A: Detect Language
    A->>K: Search Relevant Context
    K-->>A: Return Context
    A->>AI: Query + Context
    AI-->>A: Generated Response
    A->>A: Log Conversation
    A-->>C: JSON Response
    C-->>U: Display Answer
Loading

User Journey

Student Experience

journey
    title Student Query Journey
    section Discovery
      Opens chatbot: 5: Student
      Sees welcome message: 5: System
    section Interaction
      Types question: 5: Student
      Processes query: 5: System
      Receives answer: 5: Student
    section Resolution
      Gets helpful response: 5: Student
      Continues conversation: 4: Student
      Query resolved: 5: System
Loading

Administrator Experience

journey
    title Admin Management Journey
    section Login
      Accesses dashboard: 5: Admin
      Authenticates: 5: System
    section Management
      Views analytics: 5: Admin
      Uploads documents: 5: Admin
      Manages users: 5: Admin
    section Monitoring
      Reviews conversations: 4: Admin
      Identifies improvements: 4: Admin
Loading

Use Cases

For Students

Query Category Example Questions
Admissions "What documents are needed for admission?"
Fees & Payments "What is the fee structure for B.Tech?"
Academic Calendar "When do exams start?"
Campus Facilities "Where is the library located?"
Contact Info "How can I reach the registrar office?"

For Administrators

Feature Benefit
Analytics Dashboard Track most-asked questions, identify gaps
Knowledge Base Management Keep information up-to-date
User Management Control access to sensitive features
Conversation Logs Quality assurance and improvement

For Institutions

Benefit Impact
Reduced Staff Load Free up staff for complex queries
24/7 Availability Support students anytime
Consistent Information Single source of truth
Multilingual Reach Serve diverse student population

Technology Highlights

AI & Machine Learning

Component Technology Purpose
LLM Google Gemini 1.5 Natural language understanding & generation
Embeddings Vector Embeddings Semantic document search
RAG Retrieval-Augmented Generation Context-aware responses

Modern Tech Stack

flowchart LR
    subgraph Frontend
        NEXT[Next.js 14]
        REACT[React 18]
        TW[Tailwind CSS]
    end
    
    subgraph Backend
        FLASK[Flask]
        PYTHON[Python 3.11+]
    end
    
    subgraph Database
        SUPA[Supabase]
        CHROMA[ChromaDB]
    end
    
    subgraph AI
        GEMINI[Google Gemini]
        LANGCHAIN[LangChain]
    end
Loading

Security Features

  • JWT Authentication with secure token refresh
  • Role-Based Access Control (RBAC)
  • Secure Session Management
  • Audit Logging for all admin actions
  • Environment-based Configuration

Multi-Platform Support

Web Application

  • Responsive design for all devices
  • Modern, intuitive chat interface
  • Real-time message updates
  • Dark/Light theme support

Telegram Bot

  • Native Telegram integration
  • Inline buttons for quick actions
  • Image processing support
  • Seamless conversation experience

Future Platforms

  • Mobile App (iOS & Android)
  • WhatsApp Integration
  • Voice Assistant Support

Admin Dashboard

Login Screen

login

Dashboard Overview

dashboard

Key Modules

flowchart TB
    subgraph Dashboard["Admin Dashboard"]
        HOME[Overview]
        CONV[Conversations]
        KB[Knowledge Base]
        UPLOAD[Document Upload]
        ANALYTICS[Analytics]
        USERS[User Management]
        SETTINGS[Settings]
    end
Loading
Module Description
Overview Quick stats, recent activity, system health
Conversations Browse and search conversation history
Knowledge Base View and manage indexed documents
Document Upload Add new PDFs to the knowledge base
Analytics Usage metrics, popular queries, trends
User Management Manage admin and moderator accounts
Settings Configure system behavior and responses

Screenshots

Conversations

conversations

Knowledge Base

knowledge-base

Document Upload

document-upload

Analytics

analytics

User Management

user-management


Roadmap

Current Version (v1.0)

  • Web chat interface
  • Telegram bot integration
  • English & Hindi support
  • PDF document processing
  • Admin dashboard
  • User authentication
  • Analytics & logging

Upcoming Features

timeline
    title Development Roadmap
    Q1 2026 : Voice Input/Output
           : WhatsApp Integration
           : Mobile App (Beta)
    Q2 2026 : Additional Languages
           : Advanced Analytics
           : API for Third-party Integration
    Q3 2026 : Voice Assistant Support
           : Campus System Integration
           : Multi-tenant Architecture
    Q4 2026 : AI Model Fine-tuning
           : Predictive Analytics
           : Enterprise Features
Loading

Feature Requests

We're always looking to improve! Planned enhancements include:

  • Voice input and text-to-speech output
  • Native mobile applications
  • Support for regional Indian languages
  • Advanced predictive analytics
  • Integration with campus ERP systems
  • WhatsApp Business integration

Contact

Project Maintainer

Deepender Yadav

GitHub LinkedIn Email

For Business Inquiries

Interested in implementing Campus Assistant Bot for your institution?


License

This is a proprietary, closed-source project. All rights reserved.

Unauthorized copying, modification, distribution, or use of this software, via any medium, is strictly prohibited without explicit written permission from the author.


Built with passion for better campus experiences

© 2025-2026 Deepender Yadav. All Rights Reserved.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors