Spaces:
Sleeping
Sleeping
| title: Lumen AI - Dubai Utility Bill Assistant | |
| emoji: ⚡ | |
| colorFrom: blue | |
| colorTo: indigo | |
| sdk: gradio | |
| sdk_version: 6.20.0 | |
| app_file: app.py | |
| pinned: true | |
| license: mit | |
| short_description: AI Assistant for DEWA Utility Bill Questions | |
| thumbnail: >- | |
| https://cdn-uploads.huggingface.co/production/uploads/681ecc9f68e6f14b1e7d43b0/cbzKXEzOCugIJB5lAe4lJ.png | |
| # ⚡ Lumen AI — Dubai Utility Bill & Energy Assistant | |
| **Lumen** is a Retrieval-Augmented Generation (RAG) chatbot that answers questions about DEWA (Dubai Electricity & Water Authority) residential electricity and water bills — slab tariffs, fuel surcharge, housing/sewerage fees, VAT, and energy-saving tips — grounded entirely in a local knowledge base, with no hallucinated or out-of-scope answers. | |
| Built as a 3-day AI bootcamp project (Decoding Data Science), following a production-style RAG architecture: **LlamaIndex + Pinecone + OpenAI + Gradio**. | |
|  | |
|  | |
|  | |
|  | |
|  | |
| --- | |
| ## 🧠 What It Does | |
| - Answers DEWA electricity & water billing questions strictly from an attached knowledge base. | |
| - Explains slab tariffs, fuel surcharge, housing fee, sewerage fee, and VAT. | |
| - Provides illustrative bill estimates. | |
| - Suggests energy-saving tips. | |
| - Refuses to answer questions outside the DEWA billing domain. | |
| - Never invents account-specific information. | |
| --- | |
| ## 🏗️ Architecture | |
| ```text | |
| PDF Knowledge Base | |
| │ | |
| ▼ | |
| LlamaIndex Reader | |
| │ | |
| ▼ | |
| Chunking | |
| │ | |
| ▼ | |
| OpenAI Embeddings | |
| │ | |
| ▼ | |
| Pinecone Vector Database | |
| │ | |
| ▼ | |
| GPT-4o-mini Query Engine | |
| │ | |
| ▼ | |
| Gradio Chat Interface | |
| ``` | |
| --- | |
| ## 📁 Project Structure | |
| ```text | |
| . | |
| ├── app.py | |
| ├── data/ | |
| │ ├── DEWA_Utility_Bill_Knowledge_Base.pdf | |
| │ └── DEWA_Sample_FAQs.pdf | |
| ├── requirements.txt | |
| ├── .env | |
| └── README.md | |
| ``` | |
| --- | |
| ## 🚀 Running Locally | |
| ```bash | |
| git clone https://github.com/<your-username>/lumen-ai-dewa-assistant.git | |
| cd lumen-ai-dewa-assistant | |
| pip install -r requirements.txt | |
| ``` | |
| Create a `.env` file: | |
| ```env | |
| OPENAI_API_KEY=your_openai_api_key | |
| PINECONE_API_KEY=your_pinecone_api_key | |
| ``` | |
| Run: | |
| ```bash | |
| python app.py | |
| ``` | |
| --- | |
| ## ☁️ Deploy on Hugging Face Spaces | |
| 1. Create a **Gradio Space**. | |
| 2. Push this repository. | |
| 3. Add your secrets: | |
| - `OPENAI_API_KEY` | |
| - `PINECONE_API_KEY` | |
| 4. The Space will automatically launch using `app.py`. | |
| --- | |
| ## 🛠️ Tech Stack | |
| | Layer | Technology | | |
| | ---------- | ----------------- | | |
| | LLM | GPT-4o-mini | | |
| | Embeddings | OpenAI Embeddings | | |
| | Framework | LlamaIndex | | |
| | Vector DB | Pinecone | | |
| | UI | Gradio | | |
| | Language | Python | | |
| --- | |
| ## ⚠️ Disclaimer | |
| This project is intended for demonstration purposes. The included PDF documents are sample references and should not be considered official DEWA tariff documentation. | |
| --- | |
| ## 📬 Contact | |
| **Nipun Kavinda** | |
| Industrial AI & Intelligent Automation Engineer | |
| 📧 nipun.mecheng@gmail.com | |
| --- | |
| <p align="center"><sub>Built for the Decoding Data Science AI Bootcamp</sub></p> |