---
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**.

![Python](https://img.shields.io/badge/Python-3.10%2B-blue)
![Gradio](https://img.shields.io/badge/Gradio-UI-orange)
![LlamaIndex](https://img.shields.io/badge/LlamaIndex-RAG-lightgrey)
![Pinecone](https://img.shields.io/badge/Pinecone-VectorDB-green)
![License](https://img.shields.io/badge/License-MIT-yellow)

---

## 🧠 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>