Admission Chatbot for Mapúa Malayan Colleges Mindanao

Welcome to the repository for our Admission Chatbot project, developed as part of our CS121 course, Programming Languages. This web-hosted GUI application is designed to assist prospective students with their admission queries and provide a user-friendly experience.

Margatron: Admissions Buddy

Technologies Used

• Python: The primary programming language for implementing the chatbot’s logic and functionality.
• Gemini: Utilized for enhancing the chatbot's natural language processing capabilities.
• Streamlit: Framework used for building the web interface, allowing for an interactive and seamless user experience.

Features

• Interactive Chat Interface: Users can engage with the chatbot to get answers to their admission-related questions.
• Nonsense Input Checking: The chatbot intelligently handles irrelevant inputs to improve user interaction.
• API Integration: The application connects to external APIs to provide up-to-date information.

Getting Started

How to Create Environment:

1. Create a Virtual Environment:

   python -m venv nameofENV

   Example: python -m venv AdBot

   Conda: conda create --name myenv

   Specify Python version: conda create --name myenv python=3.9

2. Activate the Virtual Environment:

   • Windows:

     AdBot\Scripts\activate

   • Linux/Mac:

     source AdBot/bin/activate

   • Conda:

     conda activate myenv

Environment Variables

• Create a .env file.
• Add your API key:

  API_KEY = "your-api-key"

Install the required packages:

• Type in the terminal after activating environment:

  pip install google-generativeai streamlit python-dotenv langdetect nltk

• Version Needed: Python 3.9 or higher

  python --version

  Example Output: Python 3.12

Contributors

• Marga Pilapil - vennDiagramm
• Jhouvann Morden - Joooban
• Darwin Guirigay - dlGuiri
• Mel Macabenta - Lumeru
• Gavin Rivera - Watta2xTops