📄 README.md

# 🔌 KPLC Assistant

[![Streamlit App](https://img.shields.io/badge/Streamlit-FF4B4B?style=for-the-badge&logo=streamlit&logoColor=white)](https://streamlit.io/)
[![LangChain](https://img.shields.io/badge/LangChain-262727?style=for-the-badge&logo=langchain&logoColor=white)](https://langchain.com/)
[![Python](https://img.shields.io/badge/Python-3776AB?style=for-the-badge&logo=python&logoColor=white)](https://python.org)

**AI-Powered Kenya Power & Lighting Company (KPLC) Customer Support Assistant** with RAG (PDF search) + web search fallback.

![Demo](docs/demo.gif)

## ✨ **Features**
- 🔍 **RAG Pipeline**: Semantic search over KPLC PDFs/documents
- 🌐 **Web Search**: Tavily search across all `*.kplc.co.ke` domains
- 💾 **Memory**: Persistent conversation history per session
- 🖥️ **Web UI**: Professional Streamlit chat interface
- 📱 **Responsive**: Works on desktop + mobile
- ⚡ **Streaming**: Real-time responses

## 🚀 **Quick Start**

### 1. Clone & Setup
```bash
git clone https://github.com/YOUR_USERNAME/kplc-assistant.git
cd kplc-assistant
python -m venv venv
source venv/bin/activate  # Linux/Mac
# venv\Scripts\activate  # Windows
pip install -r requirements.txt

2. Configure API Keys

cp .env.example .env
# Edit .env:
# GOOGLE_API_KEY=your_key
# TAVILY_API_KEY=your_key

3. Add KPLC Documents

📁 kplc_document.pdf     # Your tariffs/connection docs

4. Launch Web App

streamlit run streamlit_kplc_app.py

Open: http://localhost:8501

💬 Sample Queries

❓ "What's 1 token unit price?"
❓ "How do I get new electricity connection?"  
❓ "Prepaid vs postpaid differences?"

🏗️ Architecture

User Query → Streamlit UI → LangChain Agent → [RAG Tool | Tavily Search] → Gemini → Clean Response

📊 Tech Stack

Component	Technology
Frontend	Streamlit
Backend	LangChain + LangGraph
Vector DB	ChromaDB
LLM	Google Gemini 2.5 Flash
Search	Tavily (KPLC domains)
Embeddings	Google text-embedding-004

🤝 Contributing

1. Fork the repo
2. Create feature branch (git checkout -b feature/amazing-feature)
3. Commit changes (git commit -m 'Add amazing feature')
4. Push & PR!

📄 License

MIT License - see LICENSE © 2026

🛠️ Deployment

• Heroku
• Railway
• Docker
• VPS

---

Built with ❤️ for KPLC customers | Open Issue