yaekobB/electroCare-ai-assistant-chatbot-project

ElectroCare AI Assistant Chatbot – A multilingual customer-support chatbot built with Flask, NLP, and intent classification, supporting English, Italian, and Tigrigna. # ⚡ ElectroCare AI Assistant Chatbot ElectroCare AI Assistant Chatbot is an **NLP-based customer service chatbot** designed to help customers get information about ElectroCare company's **services, policies, and steps to perform certain actions** — all through an easy-to-use chat interface. It supports **multilingual conversations** in **English**, **Italiano**, and **Tigrigna**, allowing customers to interact in the language they are most comfortable with. --- ## ✨ Features - 🗨 **Real-time chat** with an AI-powered intent classifier. - 🌍 **Multilingual support**: English, Italiano, and Tigrigna. - 🔍 **Knowledge Base Search** for fallback answers when intent confidence is low. - 📚 **Intent classification** using TF-IDF + Logistic Regression with custom threshold tuning. - 📝 **Suggestions & quick replies** for related topics. --- ## 🛠 Tech Stack - **Backend**: Python, Flask, scikit-learn, joblib - **Frontend**: HTML, CSS, Vanilla JS - **NLP**: TF-IDF, Logistic Regression, threshold tuning - **Multilingual Translation**: deep-translator - **Data**: Custom `intents.json` & `kb_articles.json` knowledge base --- ## 🚀 Getting Started ### 1️⃣ Clone the Repository ```bash git clone github.com cd electroCare-ai-assistant-chatbot-project ``` ### 2️⃣ Install Dependencies Make sure you have **Python 3.10+** installed. ```bash pip install -r requirements.txt ``` ### 3️⃣ Run the Application ```bash python app/app.py ``` The app will start on **http://localhost:5000** --- ## 🌐 Usage 1. Select your **preferred language** (English, Italiano, Tigrigna) from the dropdown in the UI. 2. Type your question — e.g., - `"How do I return a product?"` - `"Come posso restituire un prodotto?"` - `"ኣነ ምምላስ እንተደሊኩ እንታይ ክግበር ኣለኒ?"` 3. Receive responses **in your selected language**, along with: - Related knowledge base links. - Suggested related questions. --- ## 📸 Screenshots **Main UI** View Main Chat UI **English C …