---

⚡ What is This?

WAPDA MDC AI Assistant is a professional-grade, bilingual AI console built to help field staff and consumers navigate Meter Data Control (MDC) and WAPDA operations instantly — day or night, in whichever language they think in. Developed by Ayesha Javid, it replaces slow manual lookups with a single conversational interface that understands English, Urdu script, and Roman Urdu equally well. 💬 "Ask like you'd ask a colleague — get answered like an expert."

⚡ User Query │ ▼ ┌─────────────┐ │ Language │ │ Detection │ └──────┬──────┘ ▼ ┌─────────────┐ │ 160+ Q&A │ │ Knowledge DB │ └──────┬──────┘ ▼ ┌─────────────┐ │ Smart Reply │ │ + Suggest │ └─────────────┘

🚀 Launch the Live AI Console →

---

🌟 Feature Grid

Category	What It Does
🧠 Intelligent Core	Enterprise knowledge base with 160+ specialized Q&A pairs across WAPDA, MEPCO, LESCO & more Smart Filter flags off-topic / irrelevant questions automatically Auto-Suggest — live, character-by-character A–Z query filtering
🌍 Multi-Lingual Engine	English — full technical + conversational support Urdu Script — native understanding of میٹر، بجلی، بل Roman Urdu — casual phrasing like "MDC ka matlab kia hai?"
🎨 Cinematic UI	ChatGPT/Claude-style enterprise layout with avatars Neon Dark Mode for glare-free field use Glitch-effect titles + laser-scan init animation Persistent sidebar with quick-action chips
💾 Persistence	Session memory — last 20 messages retained per session Recents list for one-click access to prior queries

---

🗺️ How a Query Flows Through the System

flowchart TD
    A[👤 User types a question] --> B{🌍 Language Detected}
    B -->|English| C[NLP Match Engine]
    B -->|Urdu Script| C
    B -->|Roman Urdu| C
    C --> D{📚 Match found in 160+ Q&A?}
    D -->|✅ Yes| E[⚡ Instant Answer Returned]
    D -->|❌ No| F[🚨 Smart Filter: Irrelevant Alert]
    E --> G[💾 Saved to Session Memory]
    F --> G
    G --> H[📋 Recents Sidebar Updated]

Loading

---

🆚 Language Support at a Glance

Language	Example Query	Understood?
🇬🇧 English	"What is MDC in WAPDA billing?"	✅
🇵🇰 Urdu (Script)	"میٹر ریڈنگ کیسے چیک کریں؟"	✅
🗣️ Roman Urdu	"Bill ziyada q aya hai?"	✅
❓ Off-topic	"What's the weather today?"	🚨 Flagged as irrelevant

---

🛠️ Tech Stack

Layer	Technology	Role
⚙️ Backend	Python 3.9 & Flask	API logic, query matching, session control
🎨 Frontend	Vanilla HTML5, CSS3 (Glassmorphism), JavaScript (ES6+)	Cinematic chat console UI
💾 Session Layer	Flask-Session	Per-user chat memory (last 20 messages)
☁️ Deployment	Hugging Face Spaces (Dockerized)	Live, always-on hosting

---

▶️ Getting Started

👉 Try it Live — No Setup Needed 👈

💻 Click to expand: Run it locally

1. Clone the repository

git clone https://github.com/ayeshajavid91-star/wapda-chatbot.git
cd wapda-chatbot

2. Install dependencies

pip install -r requirements.txt

3. Run the console

python app.py

4. Open in browser

http://localhost:5000

🐳 Click to expand: Run with Docker

docker build -t wapda-mdc-assistant .
docker run -p 5000:5000 wapda-mdc-assistant

---

📂 Project Structure

wapda-chatbot/
│
├── ⚙️  app.py                 → Core AI logic & API endpoints
├── 🎨 templates/
│    └── index.html            → Enterprise chat console UI
├── 📚 qa_database.json         → 160+ question knowledge base
├── 📦 requirements.txt         → System dependencies
├── 🐳 Dockerfile               → Hugging Face deployment config
└── 📘 README.md

---

🏷️ GitHub Topics

python flask chatbot ai-assistant nlp bilingual-chatbot

---

🗺️ Roadmap

• 160+ Q&A knowledge base
• English / Urdu / Roman Urdu support
• Smart irrelevant-query filter
• Session memory (last 20 messages)
• Voice input for field staff
• Admin panel to expand the Q&A database
• SMS/WhatsApp integration for offline consumers

---

👩‍💻 Developed By

Ayesha Javid

System Engineer & AI Developer Specializing in Utility Management AI Solutions

---

📄 License

All Rights Reserved.

This project and its source code are the intellectual property of the author. No part of this repository — including the code, design, or documentation — may be copied, modified, distributed, used, or reproduced in any form without the explicit written permission of the author.

© 2026 Ayesha Javid. Unauthorized use is strictly prohibited.

For permissions or licensing inquiries, contact: ayeshajavid91@gmail.com

---

⚡ "Empowering WAPDA with Intelligence." ⚡