Upload 7 files

.env.example

@@ -0,0 +1,20 @@
+# EcoAgent — environment variable template
+# Copy this file to .env and fill in your values.
+# NEVER commit .env with real API keys to version control.
+
+# IBM Cloud API Key
+# Get from: https://cloud.ibm.com → Manage → Access (IAM) → API keys
+WATSONX_API_KEY=your-ibm-cloud-api-key-here
+
+# watsonx.ai endpoint — choose your region:
+#   eu-de (Frankfurt):  https://eu-de.ml.cloud.ibm.com       <- default
+#   us-south (Dallas):  https://us-south.ml.cloud.ibm.com
+#   eu-gb (London):     https://eu-gb.ml.cloud.ibm.com
+#   jp-tok (Tokyo):     https://jp-tok.ml.cloud.ibm.com
+#   au-syd (Sydney):    https://au-syd.ml.cloud.ibm.com
+WATSONX_URL= your-region-endpoint
+
+# watsonx.ai Studio Project ID (UUID)
+# Get from: https://eu-de.dataplatform.cloud.ibm.com
+#   → open your project → Manage tab → General → Project ID
+WATSONX_PROJECT_ID=your-project-id-uuid-here

AGENTS.md

@@ -0,0 +1,114 @@
+# AGENTS.md
+
+This file provides guidance to agents when working with code in this repository.
+
+## Project
+
+EcoAgent v2 — A Gradio Blocks web app for eco lifestyle advice, powered by **IBM Granite** (`ibm/granite-4-h-small`) via the `ibm-watsonx-ai` SDK. India-focused with 4 tabs: Chat, Dashboard, Recycling Guide, Household Profile.
+
+**Classification:** Prompt-Engineered LLM Application (not RAG, not Agentic AI)
+**IBM Orchestrate REST API is NOT used** — direct SDK calls to watsonx.ai only.
+
+## Stack
+
+- **Runtime:** Python 3.14 via `uv` (venv at `.venv/`)
+- **Package manager:** `uv` — always use `uv pip install` / `uv run python`, NOT bare `pip` or `python`
+- **UI Framework:** Gradio 6.20 (ultra-light eco green theme)
+- **AI Model:** IBM Granite 4 H Small (`ibm/granite-4-h-small`) via watsonx.ai eu-de
+- **SDK:** `ibm-watsonx-ai` >= 1.1.15 (APIClient + ModelInference pattern)
+- **System Python is 3.11 (Miniconda)** — unrelated to this project's venv
+- **Target deploy:** Hugging Face Spaces (Gradio SDK)
+
+## Key Commands
+
+```bash
+uv pip install -r requirements.txt   # install deps
+uv run python app.py                  # run locally → http://localhost:7860
+```
+
+## Critical Gotchas
+
+- **`.env` is gitignored** — cannot be written by file tools. Use `Set-Content` PowerShell command instead.
+- **`WATSONX_PROJECT_ID` is mandatory** — the SDK raises an error without it. Get it from: `https://eu-de.dataplatform.cloud.ibm.com` → project → Manage → General → Project ID.
+- **Region is eu-de (Frankfurt)** — `WATSONX_URL=https://eu-de.ml.cloud.ibm.com`. Do not use `us-south`.
+- **Model lazy-init** — `_get_model()` in `watsonx_client.py` initialises `ModelInference` on the first call, not at import. Import-time errors = missing env vars. First-call errors = bad project ID or model access.
+- **`load_dotenv(".env")` explicit path** — both `app.py` and `watsonx_client.py` call this. The default `load_dotenv()` looks for `.env` by name; the explicit path ensures it works regardless of CWD.
+- **Chat history format (Gradio 6.x)** — History uses structured content blocks: `{"role": "user", "content": [{"type": "text", "text": "..."}]}`. The `chat_submit()` function extracts text for the API call and returns structured blocks for display.
+- **`dashboard_html` is defined inside the Tab 2 block** — it's referenced by `save_profile()` in Tab 4. Both must be inside the same `gr.Blocks` context.
+- **Theme/CSS in Gradio 6.x** — `theme` and `css` parameters go in `demo.launch()`, NOT in `gr.Blocks()` constructor.
+- **SSL_CERT_FILE** — The app auto-detects and sets the correct certifi path on startup.
+
+## Architecture
+
+```
+.env
+ └─ WATSONX_API_KEY, WATSONX_PROJECT_ID, WATSONX_URL
+        │
+        ▼
+watsonx_client.py
+  ├─ AGENT_INSTRUCTIONS  ← 86-line system prompt (persona, tone, rules, format)
+  ├─ IMPACT_TABLE        ← 20 actions with CO2/water/waste lookup values
+  ├─ PRODUCT_RECS        ← static eco-product recs per material category
+  ├─ INDIAN_CITIES       ← 15 major Indian cities for recycling guide
+  ├─ _get_model()        ← lazy-init APIClient + ModelInference ( Granite 4 H Small )
+  ├─ get_eco_answer()    ← multi-turn chat, builds [system]+messages list
+  ├─ get_recycling_guide() ← single-turn recycling lookup call
+  └─ compute_session_impact() ← aggregates logged actions → metric dict
+        │
+        ▼
+app.py (Gradio Blocks — ultra-light theme)
+  ├─ Tab 1: Chat          ← chatbot + action chip logger + eco score ring
+  ├─ Tab 2: Dashboard     ← HTML metric cards from compute_session_impact()
+  ├─ Tab 3: Recycling     ← material+city dropdowns → get_recycling_guide()
+  └─ Tab 4: Profile       ← household form → profile_state (gr.State)
+```
+
+## Environment Variables
+
+| Variable | Source | Purpose |
+|---|---|---|
+| `WATSONX_API_KEY` | `.env.example` | IBM Cloud API key |
+| `WATSONX_PROJECT_ID` | watsonx.ai Studio | SDK project scope — required |
+| `WATSONX_URL` | `https://eu-de.ml.cloud.ibm.com` | eu-de watsonx.ai endpoint |
+
+## Prompt Engineering Pattern
+
+This project uses **prompt engineering** to transform IBM Granite into a domain-specific eco advisor:
+
+- **System Prompt:** 86-line `AGENT_INSTRUCTIONS` defining persona, output format, focus areas, and guardrails
+- **Static Knowledge:** `IMPACT_TABLE` (20 eco actions) and `PRODUCT_RECS` (8 material categories) injected via prompt
+- **Dynamic Context:** Household profile (members, location, habits) injected per session
+- **Output Format:** Fixed 4-part structure (Quick Tip → Why it Matters → Impact → Optional Resource)
+- **Guardrails:** Never invent stats, label [Lookup] vs [Estimate], no medical/financial advice
+
+## UI Theme
+
+Ultra-light eco green theme:
+- Background: `#fcfcfd` (near white)
+- Primary accent: `#2e7d50` (green)
+- Cards: `#ffffff` with subtle shadows
+- Text: `#1c1c1e` (near black), muted: `#4a4a4e`
+- Borders: `#e4e4e7` (light gray)
+- CheckboxGroup styled as selectable pills/chips
+- Chatbot with welcome placeholder and white-flash prevention CSS
+
+## Project Files
+
+| File | Purpose |
+|---|---|
+| `app.py` | Gradio Blocks UI — 4 tabs, callbacks, CSS theme |
+| `watsonx_client.py` | IBM watsonx.ai SDK wrapper, agent config, impact data |
+| `requirements.txt` | Pinned Python dependencies (4 packages) |
+| `.env` | Local credentials (gitignored) |
+| `.env.example` | Template — safe to commit |
+| `AGENTS.md` | This file — agent guidance |
+| `README.md` | HF Spaces front-matter, setup instructions |
+| `ecoagent-plan.md` | Implementation plan and architecture decisions |
+| `architecture.png` | Architecture blueprint diagram |
+| `fill.txt` | PPT content fill for presentation |
+
+## Deleted Files (v1 → v2)
+
+- `rag_pipeline.py` → replaced by `watsonx_client.py`
+- `ibm-credentials.env` → replaced by `.env`
+- `embed.txt` → was a debugging artifact; deleted

README.md

@@ -1,14 +1,164 @@
 ---
 title: EcoAgent
-emoji: 🏢
-colorFrom: red
-colorTo: yellow
+emoji: 🌱
+colorFrom: green
+colorTo: pink
 sdk: gradio
-sdk_version: 6.20.0
-python_version: '3.12'
+sdk_version: "6.20.0"
 app_file: app.py
 pinned: false
-short_description: Agent adopting a greener lifestyle for users
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# 🌱 EcoAgent — AI-Powered Eco Lifestyle Assistant
+
+An India-focused sustainable living assistant powered by **IBM Granite** via **watsonx.ai**. Chat about eco habits, explore a household impact dashboard, look up local recycling guides, and build a family sustainability profile.
+
+**Classification:** Prompt-Engineered LLM Application — not RAG, not Agentic AI.
+
+---
+
+## Features
+
+| Tab | What it does |
+|---|---|
+| 💬 **Chat** | Multi-turn conversation with IBM Granite — personalised eco tips, government schemes, impact estimates |
+| 📊 **Dashboard** | Session-based eco score (0–100), CO₂/water/waste savings tracker, household summary |
+| ♻️ **Recycling Guide** | City-specific recycling instructions for 8 material categories + eco-friendly product alternatives |
+| 🏡 **Profile** | Household members, Indian city, current eco habits — personalises all chat responses |
+
+---
+
+## Architecture
+
+```
+.env  (WATSONX_API_KEY, WATSONX_PROJECT_ID, WATSONX_URL)
+        │
+        ▼
+watsonx_client.py   ← IBM Granite ModelInference, AGENT_INSTRUCTIONS, IMPACT_TABLE
+        │
+        ▼
+app.py              ← Gradio Blocks (4 tabs, ultra-light eco green theme, session state)
+```
+
+**Model:** `ibm/granite-4-h-small` (eu-de region, watsonx.ai)  
+**Auth:** IBM Cloud API key → watsonx.ai SDK (no Orchestrate REST API)
+
+---
+
+## How It Works
+
+EcoAgent uses **prompt engineering** to transform IBM Granite into a domain-specific eco advisor:
+
+1. **System Prompt:** 86-line `AGENT_INSTRUCTIONS` defining persona, output format, focus areas, and guardrails
+2. **Static Knowledge:** `IMPACT_TABLE` (20 eco actions) and `PRODUCT_RECS` (8 material categories) injected via prompt
+3. **Dynamic Context:** Household profile (members, location, habits) injected per session
+4. **Output Format:** Fixed 4-part structure (Quick Tip → Why it Matters → Impact → Optional Resource)
+5. **Guardrails:** Never invent stats, label [Lookup] vs [Estimate], no medical/financial advice
+
+---
+
+## UI Theme
+
+Ultra-light eco green theme with near-white background and green accents:
+
+- Background: `#fcfcfd` (near white)
+- Primary accent: `#2e7d50` (green)
+- Cards: `#ffffff` with subtle shadows
+- Text: `#1c1c1e` (near black), muted: `#4a4a4e`
+- Borders: `#e4e4e7` (light gray)
+- CheckboxGroup styled as selectable pills/chips
+
+---
+
+## Environment Variables
+
+Set these as **Secrets** in your Hugging Face Space (Settings → Variables and Secrets)  
+or in a local `.env` file (never commit with real values).
+
+| Variable | Required | Description |
+|---|---|---|
+| `WATSONX_API_KEY` | ✅ | IBM Cloud API key — [get one here](https://cloud.ibm.com/iam/apikeys) |
+| `WATSONX_PROJECT_ID` | ✅ | watsonx.ai Studio Project ID (UUID) — see below |
+| `WATSONX_URL` | ✅ | watsonx.ai endpoint for your region — default `https://eu-de.ml.cloud.ibm.com` |
+
+### How to get `WATSONX_PROJECT_ID`
+
+1. Go to [https://eu-de.dataplatform.cloud.ibm.com](https://eu-de.dataplatform.cloud.ibm.com)
+2. Create or open a project
+3. Click the **Manage** tab → **General** section
+4. Copy the **Project ID** (a UUID like `xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx`)
+5. Add it to `.env` as `WATSONX_PROJECT_ID=<your-uuid>`
+
+### Regional watsonx.ai URLs
+
+| Region | URL |
+|---|---|
+| EU Frankfurt (default) | `https://eu-de.ml.cloud.ibm.com` |
+| US Dallas | `https://us-south.ml.cloud.ibm.com` |
+| UK London | `https://eu-gb.ml.cloud.ibm.com` |
+| Japan Tokyo | `https://jp-tok.ml.cloud.ibm.com` |
+| Australia Sydney | `https://au-syd.ml.cloud.ibm.com` |
+
+---
+
+## Local Development
+
+### Prerequisites
+- Python 3.10+ (Python 3.14 via `uv` is configured in `.venv`)
+- [`uv`](https://github.com/astral-sh/uv) (recommended) or `pip`
+
+### Steps
+
+```bash
+# 1. Clone the repo
+git clone https://huggingface.co/spaces/<your-username>/ecoagent
+cd ecoagent
+
+# 2. Install dependencies
+uv pip install -r requirements.txt
+# or: pip install -r requirements.txt
+
+# 3. Configure credentials
+# Copy .env.example to .env and fill in your values:
+cp .env.example .env
+# Edit .env — set WATSONX_API_KEY, WATSONX_PROJECT_ID, WATSONX_URL
+
+# 4. Run
+uv run python app.py
+# → Open http://localhost:7860
+```
+
+---
+
+## Customising the Agent
+
+Open [`watsonx_client.py`](watsonx_client.py) and edit the `AGENT_INSTRUCTIONS` constant at the top of the file. You can change:
+
+- **Persona & tone** — make it more formal, more playful, multilingual, etc.
+- **Focus areas** — add specific sustainability topics (e.g. marine conservation)
+- **India-specific context** — add regional schemes, local brands, city-specific advice
+- **Safety rules** — tighten or relax what the agent will/won't say
+- **Answer structure** — change the tip → why → impact → resource format
+
+The `IMPACT_TABLE` dict below it controls the carbon/water/waste numbers shown in the Dashboard tab — add new actions or update existing values there.
+
+---
+
+## Project Files
+
+| File | Purpose |
+|---|---|
+| `app.py` | Gradio Blocks UI — 4 tabs, callbacks, CSS theme |
+| `watsonx_client.py` | IBM watsonx.ai SDK wrapper, agent config, impact data |
+| `requirements.txt` | Pinned Python dependencies (4 packages) |
+| `.env` | Local credentials (gitignored) |
+| `.env.example` | Template — safe to commit |
+| `ecoagent-plan.md` | Implementation plan and architecture decisions |
+| `architecture.png` | Architecture blueprint diagram |
+| `fill.txt` | PPT content fill for presentation |
+
+---
+
+## Disclaimer
+
+Answers are AI-generated by IBM Granite. Impact figures labelled `[Lookup]` are sourced from IPCC AR6, BEE India, and CPCB data. Figures labelled `[Estimate]` are model-generated approximations. Always verify government schemes and legal/financial details with official sources.

app.py

@@ -0,0 +1,926 @@
+"""
+app.py
+------
+EcoAgent — Gradio Blocks UI with 4 tabs:
+  Chat | Dashboard | Recycling Guide | Household Profile
+
+Features:
+  - IBM Granite 4 H Small via watsonx.ai (ibm-watsonx-ai APIClient)
+  - Clean light-theme CSS, no dark mode
+  - Session-based eco score, action logging, impact dashboard
+  - India-specific recycling guide and product recommendations
+  - Household/family profile with habit tracking
+  - Hugging Face Spaces compatible
+"""
+
+import os
+import logging
+
+# Fix SSL certificate path for environments where SSL_CERT_FILE points to wrong Python
+if "SSL_CERT_FILE" not in os.environ or not os.path.isfile(os.environ.get("SSL_CERT_FILE", "")):
+    try:
+        import certifi
+        os.environ["SSL_CERT_FILE"] = certifi.where()
+        os.environ["REQUESTS_CA_BUNDLE"] = certifi.where()
+    except ImportError:
+        pass
+
+import gradio as gr
+from dotenv import load_dotenv
+
+from watsonx_client import (
+    get_eco_answer,
+    get_recycling_guide,
+    compute_session_impact,
+    IMPACT_TABLE,
+    PRODUCT_RECS,
+    INDIAN_CITIES,
+)
+
+# ---------------------------------------------------------------------------
+load_dotenv(".env")
+logging.basicConfig(level=logging.INFO)
+logger = logging.getLogger(__name__)
+
+# ---------------------------------------------------------------------------
+# Custom CSS — light-only eco green theme, polished cards and layout
+# ---------------------------------------------------------------------------
+CUSTOM_CSS = """
+@import url('https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&display=swap');
+
+:root {
+    --eco-primary:   #2e7d50;
+    --eco-secondary: #43a868;
+    --eco-light:     #f0f7f3;
+    --eco-bg:        #fcfcfd;
+    --eco-card:      #ffffff;
+    --eco-text:      #1c1c1e;
+    --eco-muted:     #6b6b6f;
+    --eco-border:    #e4e4e7;
+    --eco-shadow:    0 1px 3px rgba(0,0,0,0.04);
+    --radius:        6px;
+}
+
+body, .gradio-container {
+    font-family: 'Inter', system-ui, sans-serif !important;
+    background: var(--eco-bg) !important;
+    color: var(--eco-text) !important;
+}
+
+/* ── Gradio component overrides for ultra-light look ── */
+.gradio-container { background: var(--eco-bg) !important; }
+.gradio-container .wrap { background: var(--eco-bg) !important; }
+
+/* Tabs */
+.tab-nav button {
+    font-weight: 500 !important;
+    color: var(--eco-muted) !important;
+    border: none !important;
+    border-bottom: 2px solid transparent !important;
+    background: transparent !important;
+    border-radius: 0 !important;
+    padding: 8px 16px !important;
+}
+.tab-nav button.selected {
+    color: var(--eco-primary) !important;
+    border-bottom: 2.5px solid var(--eco-primary) !important;
+    font-weight: 600 !important;
+}
+.tab-nav button:hover {
+    color: var(--eco-primary) !important;
+    background: var(--eco-light) !important;
+}
+
+/* Buttons */
+button.primary, button.primary.lg {
+    background: var(--eco-primary) !important;
+    border-color: var(--eco-primary) !important;
+    color: #fff !important;
+    border-radius: var(--radius) !important;
+    font-weight: 600 !important;
+}
+button.primary:hover {
+    background: #256a42 !important;
+    border-color: #256a42 !important;
+}
+button.secondary, button.secondary.lg {
+    background: var(--eco-light) !important;
+    border: 1px solid var(--eco-border) !important;
+    color: var(--eco-text) !important;
+    border-radius: var(--radius) !important;
+    font-weight: 500 !important;
+}
+button.secondary:hover {
+    background: #e4eff0 !important;
+    border-color: var(--eco-border) !important;
+}
+
+/* Textbox / Dropdown / Slider */
+textarea, input[type="text"], .wrap textarea, .wrap input[type="text"] {
+    border: 1px solid var(--eco-border) !important;
+    border-radius: var(--radius) !important;
+    background: var(--eco-card) !important;
+    color: var(--eco-text) !important;
+}
+textarea:focus, input[type="text"]:focus {
+    border-color: var(--eco-primary) !important;
+    box-shadow: 0 0 0 2px rgba(46,125,80,0.12) !important;
+}
+
+/* Fix Gradio 6 Dropdown*/
+
+.gr-dropdown-menu,
+.gr-select-dropdown,
+.gradio-dropdown-menu,
+[role="listbox"] {
+    background: #ffffff !important;
+    border: 1px solid #dcdcdc !important;
+    color: #1c1c1e !important;
+}
+
+.gr-dropdown-menu li,
+.gr-select-dropdown li,
+[role="option"] {
+    background: #ffffff !important;
+    color: #1c1c1e !important;
+    padding: 10px 14px !important;
+}
+
+.gr-dropdown-menu li:hover,
+.gr-select-dropdown li:hover,
+[role="option"]:hover,
+[aria-selected="true"] {
+    background: #e8f5e9 !important;
+    color: #2e7d50 !important;
+}
+
+/* Slider */
+input[type="range"] {
+    accent-color: #2e7d50 !important;
+}
+
+input[type="range"]::-webkit-slider-thumb {
+    background: #2e7d50 !important;
+}
+
+input[type="range"]::-webkit-slider-runnable-track {
+    background: #d8e9dc !important;
+}
+
+input[type="range"]::-moz-range-thumb {
+    background: #2e7d50 !important;
+}
+
+input[type="range"]::-moz-range-track {
+    background: #d8e9dc !important;
+}
+
+/* CheckboxGroup — pills/chips style */
+/* ---------- CheckboxGroup ---------- */
+
+.gr-checkboxgroup label,
+.gradio-checkbox label {
+    background: #f0f7f3 !important;
+    border: 1px solid #d6e7da !important;
+    color: #1c1c1e !important;
+    border-radius: 18px !important;
+    padding: 8px 14px !important;
+}
+
+.gr-checkboxgroup label:hover,
+.gradio-checkbox label:hover {
+    background: #e6f3ea !important;
+}
+
+.gr-checkboxgroup input:checked + span,
+.gradio-checkbox input:checked + span {
+    color: white !important;
+}
+
+.gr-checkboxgroup label:has(input:checked),
+.gradio-checkbox label:has(input:checked) {
+    background: #2e7d50 !important;
+    border-color: #2e7d50 !important;
+}
+
+/* Chatbot */
+.message.user {
+    background: var(--eco-light) !important;
+    border: 1px solid var(--eco-border) !important;
+    border-radius: var(--radius) !important;
+}
+.message.bot {
+    background: var(--eco-card) !important;
+    border: 1px solid var(--eco-border) !important;
+    border-radius: var(--radius) !important;
+}
+/* Prevent white flash during model thinking */
+#chatbot, #chatbot > .wrap, #chatbot > .wrap > .panel {
+    background: var(--eco-bg) !important;
+}
+
+/* Markdown headings inside tabs */
+h3, h2 { color: var(--eco-text) !important; }
+
+/* ── Header ── */
+.eco-header {
+    background: var(--eco-card);
+    border: 1px solid var(--eco-border);
+    border-radius: var(--radius);
+    padding: 22px 28px;
+    margin-bottom: 16px;
+    color: var(--eco-text);
+    box-shadow: var(--eco-shadow);
+}
+.eco-header h1 {
+    margin: 0 0 4px;
+    font-size: 1.5rem;
+    font-weight: 700;
+    letter-spacing: -0.3px;
+    color: var(--eco-primary);
+}
+.eco-header p {
+    margin: 0;
+    font-size: 0.85rem;
+    color: var(--eco-muted);
+}
+.eco-model-badge {
+    display: inline-block;
+    margin-top: 8px;
+    background: var(--eco-light);
+    border: 1px solid var(--eco-border);
+    border-radius: 20px;
+    padding: 3px 12px;
+    font-size: 0.73rem;
+    font-weight: 600;
+    color: var(--eco-primary);
+    letter-spacing: 0.3px;
+}
+
+/* ── Metric cards ── */
+.metric-card {
+    background: var(--eco-card);
+    border: 1px solid var(--eco-border);
+    border-radius: var(--radius);
+    padding: 18px 16px;
+    text-align: center;
+    box-shadow: var(--eco-shadow);
+}
+.metric-value {
+    font-size: 1.8rem;
+    font-weight: 700;
+    color: var(--eco-primary);
+    line-height: 1.1;
+}
+.metric-label {
+    font-size: 0.7rem;
+    color: var(--eco-muted);
+    margin-top: 3px;
+    text-transform: uppercase;
+    letter-spacing: 0.6px;
+    font-weight: 500;
+}
+.metric-unit {
+    font-size: 0.82rem;
+    color: var(--eco-muted);
+}
+
+/* ── Score ring ── */
+.score-ring-wrap {
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    gap: 6px;
+}
+.score-ring {
+    width: 80px; height: 80px; border-radius: 50%;
+    background: conic-gradient(var(--eco-secondary) calc(var(--pct) * 1%), #eaeaea 0);
+    display: flex; align-items: center; justify-content: center;
+    position: relative;
+}
+.score-ring::after {
+    content: '';
+    width: 60px; height: 60px;
+    background: var(--eco-card);
+    border-radius: 50%;
+    position: absolute;
+}
+.score-number {
+    font-size: 1rem; font-weight: 700;
+    color: var(--eco-primary);
+    position: relative; z-index: 1;
+}
+.score-label {
+    font-size: 0.68rem;
+    color: var(--eco-muted);
+    font-weight: 600;
+    text-transform: uppercase;
+    letter-spacing: 0.5px;
+}
+.score-count {
+    background: var(--eco-light);
+    color: var(--eco-primary);
+    border: 1px solid var(--eco-border);
+    border-radius: 20px;
+    padding: 2px 10px;
+    font-size: 0.72rem;
+    font-weight: 600;
+}
+
+/* ── Recycling output ── */
+.recycling-output {
+    background: var(--eco-card);
+    border: 1px solid var(--eco-border);
+    border-radius: var(--radius);
+    padding: 14px;
+    box-shadow: var(--eco-shadow);
+}
+
+/* ── Product cards ── */
+.product-card {
+    background: var(--eco-card);
+    border-left: 3px solid var(--eco-secondary);
+    border-radius: 0 var(--radius) var(--radius) 0;
+    padding: 10px 14px;
+    margin: 5px 0;
+    box-shadow: var(--eco-shadow);
+    font-size: 0.86rem;
+    color: var(--eco-text);
+}
+
+/* ── Profile card ── */
+.profile-card {
+    background: var(--eco-card);
+    border: 1px solid var(--eco-border);
+    border-radius: var(--radius);
+    padding: 14px;
+    box-shadow: var(--eco-shadow);
+}
+
+/* ── Disclaimer ── */
+.disclaimer {
+    font-size: 0.72rem;
+    color: var(--eco-muted);
+    text-align: center;
+    padding: 8px 0 4px;
+    border-top: 1px solid var(--eco-border);
+    margin-top: 10px;
+}
+"""
+
+# ---------------------------------------------------------------------------
+# Static HTML — clean light header, no dark-mode button
+# ---------------------------------------------------------------------------
+HEADER_HTML = """
+<div class="eco-header">
+  <h1>EcoAgent</h1>
+  <p>Your AI guide to greener living — personalized, practical, powered by IBM Granite and watsonx.ai</p>
+  <span class="eco-model-badge">ibm/granite-4-h-small</span>
+</div>
+"""
+
+DISCLAIMER_HTML = """
+<div class="disclaimer">
+  Answers are AI-generated by IBM Granite. Impact figures marked [Lookup] are from IPCC/BEE/CPCB data;
+  [Estimate] figures are model-generated. Verify government schemes at official sources.
+  Not financial or legal advice.
+</div>
+"""
+
+# ---------------------------------------------------------------------------
+# Quick-action chips for logging eco actions
+# ---------------------------------------------------------------------------
+ACTION_CHIPS = [
+    ("cloth_bags",            "Used cloth bags"),
+    ("led_bulbs",             "Switched to LED"),
+    ("short_shower",          "Short shower"),
+    ("no_plastic_bottles",    "Used steel bottle"),
+    ("public_transport",      "Public transport"),
+    ("composting",            "Composted waste"),
+    ("segregate_waste",       "Segregated waste"),
+    ("seasonal_local_produce","Bought local produce"),
+    ("line_dry_clothes",      "Line-dried clothes"),
+    ("fix_water_leaks",       "Fixed a water leak"),
+]
+
+EXAMPLE_PROMPTS = [
+    "How can I reduce plastic use in my Indian kitchen?",
+    "What government schemes help with solar panel installation in India?",
+    "Give me a week-long plan to reduce my family's water usage.",
+    "How do I properly dispose of old mobile phones and laptops?",
+    "What are the most eco-friendly travel options in a Tier-2 Indian city?",
+]
+
+
+# ---------------------------------------------------------------------------
+# Dashboard HTML builder
+# ---------------------------------------------------------------------------
+def _build_dashboard_html(impact: dict, profile: dict) -> str:
+    score = impact.get("eco_score", 0)
+    co2 = impact.get("co2_kg_year", 0.0)
+    water = impact.get("water_L_day", 0.0)
+    waste = impact.get("waste_kg_year", 0.0)
+    actions = impact.get("actions_count", 0)
+    location = profile.get("location", "India") if profile else "India"
+    members = profile.get("members", 1) if profile else 1
+
+    return f"""
+<div style="font-family:Inter,sans-serif;color:#1c1c1e;">
+  <div style="display:flex;gap:14px;flex-wrap:wrap;margin-bottom:14px;align-items:stretch;">
+    <div class="metric-card" style="flex:1;min-width:150px;">
+      <div class="score-ring-wrap">
+        <div class="score-ring" style="--pct:{score};">
+          <span class="score-number">{score}</span>
+        </div>
+        <span class="score-label">Eco Score</span>
+        <span class="score-count">{actions} action{'s' if actions != 1 else ''} logged</span>
+      </div>
+    </div>
+    <div class="metric-card" style="flex:1;min-width:150px;">
+      <div class="metric-value">{members}</div>
+      <div class="metric-unit">household member{'s' if members != 1 else ''}</div>
+      <div class="metric-label">{location}</div>
+    </div>
+  </div>
+  <p style="font-size:0.76rem;color:#6b6b6f;margin:0 0 8px;font-weight:600;text-transform:uppercase;letter-spacing:0.5px;">
+    Estimated annual savings if logged actions are sustained
+  </p>
+  <div style="display:flex;gap:10px;flex-wrap:wrap;">
+    <div class="metric-card" style="flex:1;min-width:130px;">
+      <div class="metric-value">{co2:,.0f}</div>
+      <div class="metric-unit">kg CO&#8322;</div>
+      <div class="metric-label">Carbon Avoided</div>
+    </div>
+    <div class="metric-card" style="flex:1;min-width:130px;">
+      <div class="metric-value">{water:,.0f}</div>
+      <div class="metric-unit">L / day</div>
+      <div class="metric-label">Water Saved</div>
+    </div>
+    <div class="metric-card" style="flex:1;min-width:130px;">
+      <div class="metric-value">{waste:,.0f}</div>
+      <div class="metric-unit">kg / year</div>
+      <div class="metric-label">Waste Diverted</div>
+    </div>
+  </div>
+  {_equivalencies_html(co2, water) if co2 > 0 or water > 0 else ""}
+  {_actions_html(impact)}
+</div>
+"""
+
+
+def _equivalencies_html(co2: float, water: float) -> str:
+    lines = []
+    if co2 > 0:
+        trees = round(co2 / 21)
+        lines.append(f"CO&#8322; savings equivalent to planting <b>{trees} trees</b> per year")
+    if water > 0:
+        baths = round(water / 150)
+        lines.append(f"Water savings equivalent to <b>{baths} bucket baths</b> per day")
+    if not lines:
+        return ""
+    return (
+        "<div style='background:#f0f7f3;border:1px solid #e4e4e7;border-radius:6px;"
+        "padding:10px 14px;margin-top:12px;font-size:0.82rem;color:#2e7d50;'>"
+        + "<br>".join(lines)
+        + "</div>"
+    )
+
+
+def _actions_html(impact: dict) -> str:
+    count = impact.get("actions_count", 0)
+    if count == 0:
+        return (
+            "<p style='color:#6b6b6f;font-size:0.82rem;margin-top:10px;'>"
+            "No actions logged yet. Chat with EcoAgent, then use the action buttons "
+            "to log what you have done today.</p>"
+        )
+    return (
+        f"<p style='color:#6b6b6f;font-size:0.80rem;margin-top:10px;'>"
+        f"You have logged <b>{count} unique action{'s' if count != 1 else ''}</b> this session. "
+        f"Each sustained action compounds over the year.</p>"
+    )
+
+
+# ---------------------------------------------------------------------------
+# Recycling products HTML builder
+# ---------------------------------------------------------------------------
+def _build_products_html(material: str) -> str:
+    recs = PRODUCT_RECS.get(material, [])
+    if not recs:
+        return ""
+    items = "".join(f'<div class="product-card">{r}</div>' for r in recs)
+    return (
+        f"<div style='margin-top:14px;'>"
+        f"<p style='font-weight:600;color:#2e7d50;font-size:0.86rem;margin-bottom:4px;'>"
+        f"Eco-friendly alternatives and resources for {material}:</p>"
+        f"{items}</div>"
+    )
+
+
+# ---------------------------------------------------------------------------
+# Profile summary HTML builder
+# ---------------------------------------------------------------------------
+def _build_profile_html(profile: dict) -> str:
+    if not profile or not profile.get("name"):
+        return "<p style='color:#6b6b6f;font-size:0.84rem;'>No profile saved yet.</p>"
+    habits = profile.get("habits", [])
+    habit_list = (
+        "<ul style='margin:4px 0;padding-left:18px;font-size:0.82rem;'>"
+        + "".join(f"<li>{h}</li>" for h in habits)
+        + "</ul>"
+        if habits
+        else "<p style='color:#6b6b6f;font-size:0.82rem;'>No habits recorded.</p>"
+    )
+    return f"""
+<div class="profile-card">
+  <p style="font-size:0.93rem;font-weight:700;color:#2e7d50;margin:0 0 6px;">{profile['name']}</p>
+  <p style="font-size:0.82rem;margin:2px 0;"><b>Location:</b> {profile.get('location','—')}</p>
+  <p style="font-size:0.82rem;margin:2px 0;"><b>Members:</b> {profile.get('members',1)}</p>
+  <p style="font-size:0.82rem;margin:6px 0 2px;"><b>Current eco habits:</b></p>
+  {habit_list}
+</div>
+"""
+
+
+# ---------------------------------------------------------------------------
+# Core chat callback
+# ---------------------------------------------------------------------------
+def chat_submit(
+    message: str,
+    history: list,
+    profile_state: dict,
+    actions_state: list,
+):
+    """Handle a user message: call Granite, update history.
+
+    Gradio 6.x passes history as list[dict] where content is a list of
+    content blocks: [{"role": "user", "content": [{"type": "text", "text": "..."}]}].
+    We extract plain text for the API call and return structured blocks for display.
+    """
+    if not message or not message.strip():
+        return history, profile_state, actions_state, _score_html(actions_state)
+
+    # Gradio 6 delivers history with structured content blocks
+    # Extract plain text for the watsonx API call
+    messages: list[dict] = []
+    for turn in history:
+        role = turn.get("role", "")
+        content = turn.get("content", "")
+        if role in ("user", "assistant") and content:
+            # Content can be a string or a list of content blocks
+            if isinstance(content, list):
+                text = " ".join(
+                    block.get("text", "") for block in content
+                    if isinstance(block, dict) and block.get("type") == "text"
+                )
+            else:
+                text = str(content)
+            if text:
+                messages.append({"role": role, "content": text})
+
+    messages.append({"role": "user", "content": message})
+
+    try:
+        reply = get_eco_answer(messages, profile_state)
+    except EnvironmentError as exc:
+        reply = (
+            "**Setup required.**\n\n"
+            f"{exc}\n\n"
+            "Please set your credentials in `.env` and restart the app."
+        )
+    except RuntimeError as exc:
+        logger.error("watsonx error: %s", exc)
+        reply = (
+            "**EcoAgent is temporarily unavailable.**\n\n"
+            f"Error: {exc}\n\n"
+            "Please check your internet connection or try again in a moment."
+        )
+    except Exception as exc:  # noqa: BLE001
+        logger.exception("Unexpected error in chat_submit")
+        reply = f"An unexpected error occurred ({type(exc).__name__}). Please try again."
+
+    # Append in Gradio 6 structured content block format
+    history = history + [
+        {"role": "user", "content": [{"type": "text", "text": message}]},
+        {"role": "assistant", "content": [{"type": "text", "text": reply}]},
+    ]
+    return history, profile_state, actions_state, _score_html(actions_state)
+
+
+def _score_html(actions_state: list) -> str:
+    impact = compute_session_impact(actions_state)
+    score = impact["eco_score"]
+    count = impact["actions_count"]
+    return (
+        f"<div class='score-ring-wrap' style='padding:6px 0;'>"
+        f"<div class='score-ring' style='--pct:{score};width:72px;height:72px;'>"
+        f"<span class='score-number'>{score}</span></div>"
+        f"<span class='score-label'>Eco Score</span>"
+        f"<span class='score-count'>{count} action{'s' if count != 1 else ''}</span></div>"
+    )
+
+
+def log_action(slug: str, actions_state: list) -> tuple[list, str]:
+    """Toggle an action slug in the logged actions list."""
+    if slug in actions_state:
+        actions_state = [a for a in actions_state if a != slug]
+    else:
+        actions_state = actions_state + [slug]
+    return actions_state, _score_html(actions_state)
+
+
+def update_dashboard(actions_state: list, profile_state: dict) -> str:
+    members = profile_state.get("members", 1) if profile_state else 1
+    impact = compute_session_impact(actions_state, members)
+    return _build_dashboard_html(impact, profile_state or {})
+
+
+def get_recycling(material: str, city: str) -> tuple[str, str]:
+    """Fetch guide + product recs for a material/city combination."""
+    if not material or not city:
+        return "Please select both a material and a city.", ""
+    try:
+        guide = get_recycling_guide(material, city)
+    except EnvironmentError as exc:
+        guide = f"Setup required: {exc}"
+    except RuntimeError as exc:
+        guide = f"Could not fetch guide: {exc}"
+    products_html = _build_products_html(material)
+    return guide, products_html
+
+
+def save_profile(
+    name: str,
+    location: str,
+    members: int,
+    habits: list,
+    actions_state: list,
+) -> tuple[dict, str, str]:
+    """Save household profile and return updated state + HTML summary."""
+    profile = {
+        "name": name.strip() if name else "My Household",
+        "location": location,
+        "members": int(members),
+        "habits": habits,
+    }
+    summary = _build_profile_html(profile)
+    dashboard = update_dashboard(actions_state, profile)
+    return profile, summary, dashboard
+
+
+# ===========================================================================
+#  GRADIO BLOCKS APP
+# ===========================================================================
+with gr.Blocks(title="EcoAgent — Eco Lifestyle Assistant") as demo:
+
+    profile_state = gr.State({})
+    actions_state = gr.State([])
+
+    gr.HTML(HEADER_HTML)
+
+    with gr.Tabs(elem_classes="tab-nav"):
+
+        # ================================================================
+        #  TAB 1: CHAT
+        # ================================================================
+        with gr.Tab("Chat"):
+            with gr.Row():
+                with gr.Column(scale=3):
+                    chatbot = gr.Chatbot(
+                        height=430,
+                        show_label=False,
+                        elem_id="chatbot",
+                        placeholder=(
+                            "<div style='text-align:center;padding:40px 20px;background:#fcfcfd;border-radius:6px;'>"
+                            "<p style='font-size:1rem;font-weight:600;margin:0 0 6px;color:#2e7d50;'>Welcome to EcoAgent</p>"
+                            "<p style='font-size:0.84rem;margin:0;color:#4a4a4e;'>Ask me anything about sustainable living, "
+                            "eco travel, recycling, or Indian government green schemes.</p>"
+                            "</div>"
+                        ),
+                    )
+                    with gr.Row():
+                        msg_input = gr.Textbox(
+                            placeholder="Ask EcoAgent a question...",
+                            show_label=False,
+                            scale=5,
+                            lines=1,
+                        )
+                        send_btn = gr.Button("Send", variant="primary", scale=1)
+
+                    gr.Markdown("**Quick start questions:**")
+                    with gr.Row():
+                        for prompt in EXAMPLE_PROMPTS[:3]:
+                            ex_btn = gr.Button(prompt, size="sm", variant="secondary")
+                            ex_btn.click(lambda p=prompt: p, outputs=msg_input)
+                    with gr.Row():
+                        for prompt in EXAMPLE_PROMPTS[3:]:
+                            ex_btn = gr.Button(prompt, size="sm", variant="secondary")
+                            ex_btn.click(lambda p=prompt: p, outputs=msg_input)
+
+                with gr.Column(scale=1, min_width=190):
+                    score_display = gr.HTML(_score_html([]))
+                    gr.Markdown("**Log today's actions:**")
+                    chip_btns = []
+                    for slug, label in ACTION_CHIPS:
+                        btn = gr.Button(label, size="sm", variant="secondary")
+                        chip_btns.append((slug, btn))
+
+            def _submit(message, history, profile, actions):
+                return chat_submit(message, history, profile, actions)
+
+            send_btn.click(
+                _submit,
+                inputs=[msg_input, chatbot, profile_state, actions_state],
+                outputs=[chatbot, profile_state, actions_state, score_display],
+            ).then(lambda: "", outputs=msg_input)
+
+            msg_input.submit(
+                _submit,
+                inputs=[msg_input, chatbot, profile_state, actions_state],
+                outputs=[chatbot, profile_state, actions_state, score_display],
+            ).then(lambda: "", outputs=msg_input)
+
+            for slug, btn in chip_btns:
+                btn.click(
+                    lambda a, s=slug: log_action(s, a),
+                    inputs=[actions_state],
+                    outputs=[actions_state, score_display],
+                )
+
+        # ================================================================
+        #  TAB 2: DASHBOARD
+        # ================================================================
+        with gr.Tab("Dashboard"):
+            gr.Markdown(
+                "### Your Eco Impact Dashboard\n"
+                "Log actions in the Chat tab to see your estimated savings grow."
+            )
+            dashboard_html = gr.HTML(
+                _build_dashboard_html(compute_session_impact([]), {}),
+            )
+            refresh_btn = gr.Button("Refresh Dashboard", variant="secondary")
+            refresh_btn.click(
+                update_dashboard,
+                inputs=[actions_state, profile_state],
+                outputs=dashboard_html,
+            )
+
+        # ================================================================
+        #  TAB 3: RECYCLING GUIDE
+        # ================================================================
+        with gr.Tab("Recycling Guide"):
+            gr.Markdown(
+                "### Local Recycling Guide\n"
+                "Select a waste material and your city to get India-specific "
+                "recycling instructions and eco-friendly product alternatives."
+            )
+            with gr.Row():
+                material_dd = gr.Dropdown(
+                    choices=list(PRODUCT_RECS.keys()),
+                    label="Waste Material",
+                    value="E-waste",
+                    scale=1,
+                )
+                city_dd = gr.Dropdown(
+                    choices=INDIAN_CITIES,
+                    label="Your City",
+                    value="Bangalore",
+                    scale=1,
+                )
+                guide_btn = gr.Button("Get Recycling Guide", variant="primary", scale=1)
+
+            guide_output = gr.Markdown(
+                "*Select a material and city above, then click Get Recycling Guide.*",
+                label="Recycling Instructions",
+                elem_classes="recycling-output",
+            )
+            products_output = gr.HTML("", label="Eco-Friendly Alternatives")
+
+            guide_btn.click(
+                get_recycling,
+                inputs=[material_dd, city_dd],
+                outputs=[guide_output, products_output],
+            )
+            material_dd.change(
+                lambda m: _build_products_html(m),
+                inputs=material_dd,
+                outputs=products_output,
+            )
+
+        # ================================================================
+        #  TAB 4: PROFILE
+        # ================================================================
+        with gr.Tab("Profile"):
+            gr.Markdown(
+                "### Household Profile\n"
+                "Set your household details so EcoAgent can give personalised, "
+                "family-scale advice relevant to your location."
+            )
+            with gr.Row():
+                with gr.Column(scale=2):
+                    hh_name = gr.Textbox(
+                        label="Household Name",
+                        placeholder="e.g. The Sharma Family",
+                    )
+                    with gr.Row():
+                        hh_location = gr.Dropdown(
+                            choices=INDIAN_CITIES + [
+                                "Other - North India", "Other - South India",
+                                "Other - East India", "Other - West India",
+                                "Rural area",
+                            ],
+                            label="City / Location",
+                            value="Bangalore",
+                            scale=2,
+                        )
+                        hh_members = gr.Slider(
+                            minimum=1, maximum=12, value=4, step=1,
+                            label="Household Members",
+                            scale=2,
+                        )
+                    hh_habits = gr.CheckboxGroup(
+                        choices=[
+                            "Vegetarian / vegan diet",
+                            "Use public transport regularly",
+                            "Have solar panels installed",
+                            "Compost kitchen waste",
+                            "Use cloth / jute bags",
+                            "Avoid single-use plastics",
+                            "Harvest rainwater",
+                            "Segregate wet and dry waste",
+                            "Use LED bulbs throughout",
+                            "Grow some food at home",
+                        ],
+                        label="Current Eco Habits (select all that apply)",
+                    )
+                    save_btn = gr.Button("Save Profile", variant="primary")
+
+                with gr.Column(scale=1):
+                    profile_summary = gr.HTML(
+                        "<p style='color:#6b6b6f;font-size:0.84rem;'>"
+                        "Fill in your details and click Save Profile.</p>",
+                    )
+
+            # Save updates profile_state, profile HTML, and dashboard
+            save_btn.click(
+                save_profile,
+                inputs=[hh_name, hh_location, hh_members, hh_habits, actions_state],
+                outputs=[profile_state, profile_summary, dashboard_html],
+            )
+
+    # ── Footer disclaimer ──────────────────────────────────────────────────
+    gr.HTML(DISCLAIMER_HTML)
+
+
+# ---------------------------------------------------------------------------
+# Entry point
+# ---------------------------------------------------------------------------
+if __name__ == "__main__":
+    eco_theme = gr.themes.Soft(
+        primary_hue="green",
+        secondary_hue="emerald",
+        neutral_hue="gray",        
+        font="Inter, system-ui, sans-serif",
+        font_mono="Fira Code, monospace",
+    ).set(
+        body_background_fill="#fcfcfd",
+        body_background_fill_dark="#fcfcfd",
+        body_text_color="#1c1c1e",
+        body_text_color_dark="#1c1c1e",
+        block_background_fill="#ffffff",
+        block_border_color="#e4e4e7",
+        block_label_text_color="#4a4a4e",
+        block_title_text_color="#1c1c1e",
+        input_background_fill="#ffffff",
+        input_border_color="#e4e4e7",
+        input_border_color_focus="#2e7d50",
+        button_primary_background_fill="#2e7d50",
+        button_primary_background_fill_hover="#256a42",
+        button_primary_border_color="#2e7d50",
+        button_primary_text_color="#ffffff",
+        button_secondary_background_fill="#f0f7f3",
+        button_secondary_background_fill_hover="#e4eff0",
+        button_secondary_border_color="#e4e4e7",
+        button_secondary_text_color="#1c1c1e",
+        checkbox_background_color="#ffffff",
+        checkbox_background_color_selected="#2e7d50",
+        checkbox_border_color="#e4e4e7",
+        checkbox_border_color_selected="#2e7d50",
+        checkbox_label_text_color="#1c1c1e",
+        checkbox_label_text_color_selected="#ffffff",
+        checkbox_label_background_fill="#f0f7f3",
+        checkbox_label_background_fill_hover="#e4eff0",
+        checkbox_label_background_fill_selected="#2e7d50",
+        checkbox_label_border_color="#e4e4e7",
+        checkbox_label_border_color_selected="#2e7d50",
+        checkbox_label_border_width="1px",
+        slider_color="#2e7d50",
+    )
+
+    demo.launch(
+        server_name="0.0.0.0",
+        server_port=int(os.environ.get("PORT", 7860)),
+        share=False,
+        theme=eco_theme,
+        css=CUSTOM_CSS,
+    )

ecoagent-plan.md

@@ -0,0 +1,271 @@
+# EcoAgent v2 — Complete Rebuild Plan
+
+## Top-Level Overview
+
+**Goal:** Rebuild EcoAgent from scratch as a full-featured Gradio web application using `ibm-watsonx-ai` SDK directly (ModelInference.chat() with `ibm/granite-4-h-small`). The IBM Orchestrate REST API integration is abandoned — it was not reachable via a public REST endpoint. The IBM Cloud API key (`CLOUD_API` from `.env.example`) works for direct watsonx.ai SDK calls.
+
+**Classification:** Prompt-Engineered LLM Application (not RAG, not Agentic AI)
+
+**What gets replaced/deleted:**
+- `rag_pipeline.py` → replaced by `watsonx_client.py`
+- `app.py` → fully rewritten
+- `ibm-credentials.env` → replaced by `.env` (simpler var names)
+- `requirements.txt` → updated
+- `ecoagent-plan.md` → this file supersedes it
+
+**Architecture:**
+```
+.env
+  └─ WATSONX_API_KEY, WATSONX_PROJECT_ID, WATSONX_URL
+        │
+        ▼
+watsonx_client.py          ← ModelInference wrapper, AGENT_INSTRUCTIONS, impact lookup table
+        │
+        ▼
+app.py                     ← Gradio Blocks UI: Chat + Dashboard + Recycling + Profile
+        │
+        ├─ gr.Blocks (ultra-light eco green theme)
+        ├─ Chat tab          ← primary interaction, eco score streak
+        ├─ Dashboard tab     ← CO₂/water/waste savings visualised
+        ├─ Recycling tab     ← material lookup → guidelines + product recommendations
+        └─ Profile tab       ← household members, habits, location (India-specific)
+```
+
+**IBM SDK usage (confirmed working):**
+```python
+from ibm_watsonx_ai import APIClient, Credentials
+from ibm_watsonx_ai.foundation_models import ModelInference
+model = ModelInference(model_id="ibm/granite-4-h-small", credentials=creds, project_id=...)
+response = model.chat(messages=[{"role":"system","content":"..."}, {"role":"user","content":"..."}])
+answer = response["choices"][0]["message"]["content"]
+```
+
+**Non-Goals:**
+- No Exa MCP / web search (user dropped that requirement in the new prompt)
+- No IBM Orchestrate REST API
+- No FAISS / local embeddings
+
+---
+
+## Environment Variables (new `.env`)
+
+| Variable | Value | Purpose |
+|---|---|---|
+| `WATSONX_API_KEY` | `CLOUD_API` value from `.env.example` | IBM Cloud API key for watsonx.ai |
+| `WATSONX_PROJECT_ID` | User must fill in from watsonx.ai Studio | Required by ModelInference |
+| `WATSONX_URL` | `https://eu-de.ml.cloud.ibm.com` | watsonx.ai eu-de (Frankfurt) endpoint |
+
+**Region confirmed:** `eu-de` (Frankfurt) — platform at `https://eu-de.dataplatform.cloud.ibm.com`
+**`ibm-credentials.env`**: Delete — fully superseded by `.env`.
+
+---
+
+## Sub-Tasks
+
+---
+
+### Sub-Task 1: Create `.env` and update `ibm-credentials.env`
+
+**Intent:** Replace the sprawling `ibm-credentials.env` with a clean `.env` using the new variable names. Keep `ibm-credentials.env` as a legacy backup comment only.
+
+**Expected Outcomes:**
+- `.env` exists with `WATSONX_API_KEY`, `WATSONX_PROJECT_ID`, `WATSONX_URL`
+- `.env.example` updated to document the new vars (without real values for PROJECT_ID)
+- `ibm-credentials.env` cleared out or noted as superseded
+
+**Todo List:**
+1. Write `.env` with `CLOUD_API` value mapped to `WATSONX_API_KEY`
+2. Set `WATSONX_URL=https://eu-de.ml.cloud.ibm.com`
+3. Leave `WATSONX_PROJECT_ID=` blank (user must fill in from watsonx.ai Studio)
+4. Update `.env.example` to document all three vars without values
+
+**Status:** `[x] completed`
+
+---
+
+### Sub-Task 2: Create `watsonx_client.py`
+
+**Intent:** All IBM watsonx.ai SDK logic in one file: `AGENT_INSTRUCTIONS` block, carbon impact lookup table, and `get_eco_answer(messages, profile)` function.
+
+**Expected Outcomes:**
+- `watsonx_client.py` is importable and `get_eco_answer()` returns a string
+- `AGENT_INSTRUCTIONS` is a clearly labelled, easily editable multi-line string at the top
+- Carbon/resource impact lookup table covers ≥15 common actions with CO₂/water/waste values
+- If SDK call fails, raises `RuntimeError` with a descriptive message
+- `project_id` must be set; if missing raises a clear error at import time
+
+**Todo List:**
+1. `load_dotenv(".env")` at module top
+2. Write `AGENT_INSTRUCTIONS` constant — covers:
+   - Persona/tone: friendly, concise, India-aware eco advisor
+   - Answer structure: quick tip → why it matters (1 line) → optional resource
+   - Safety rules: no invented stats, label estimates vs lookup values
+   - Sustainability focus areas: plastic, energy, water, travel, food, waste
+   - India-specific context: regional schemes (PM Surya Ghar, Swachh Bharat, FAME), local recycling norms, common household practices
+3. Write `IMPACT_TABLE: dict[str, dict]` — keyed by action slug, values: `{co2_kg_year, water_L_day, waste_kg_year, label}`; cover actions like: cloth bags, LED bulbs, solar panels, composting, public transport, short showers, rainwater harvesting, etc.
+4. Write `_build_system_prompt(profile: dict) -> str` — injects profile (location, members, habits) into the system message alongside `AGENT_INSTRUCTIONS`
+5. Write `get_eco_answer(messages: list[dict], profile: dict) -> str`:
+   - Builds `[system_msg] + messages` list
+   - Calls `ModelInference.chat()` with `max_tokens=800, temperature=0.7`
+   - Returns `response["choices"][0]["message"]["content"]`
+6. Write `get_recycling_guide(material: str, location: str) -> str` — a focused single-turn call to Granite to return recycling instructions for a material in an Indian city context
+7. Startup validation: raise `EnvironmentError` if `WATSONX_API_KEY` or `WATSONX_URL` is missing
+
+**Relevant Context:**
+- SDK: `ibm_watsonx_ai` >= 1.1.15
+- `Credentials(url=WATSONX_URL, api_key=WATSONX_API_KEY)`
+- `APIClient(credentials, project_id)`
+- `ModelInference(model_id="ibm/granite-4-h-small", credentials=creds, project_id=WATSONX_PROJECT_ID)`
+- Chat response: `response["choices"][0]["message"]["content"]`
+- `WATSONX_PROJECT_ID` may be empty during dev — handle gracefully
+
+**Status:** `[x] completed`
+
+---
+
+### Sub-Task 3: Create `app.py` — Gradio Blocks UI
+
+**Intent:** Full Gradio Blocks application with 4 tabs, ultra-light eco green theme, and session state.
+
+**Expected Outcomes:**
+- `python app.py` launches on `http://localhost:7860`
+- Chat tab works end-to-end with Granite via `watsonx_client.get_eco_answer()`
+- Dashboard tab shows live session-based eco score + cumulative CO₂/water/waste savings
+- Recycling tab has a material input + location dropdown + Granite-powered guide output
+- Profile tab captures household members, location (Indian cities), habits
+- Mobile-responsive via CSS
+- All state is session-based (gr.State)
+
+**Todo List:**
+
+**3a. Custom CSS/JS:**
+1. Define `CUSTOM_CSS` string: ultra-light eco green palette (`#fcfcfd` background, `#2e7d50` primary accent), card shadows, chat bubble styles, animated eco score ring
+2. Define eco score calculation: `score = min(100, len(logged_actions) * 10)` per session
+
+**3b. Chat Tab:**
+1. `gr.Chatbot` with welcome placeholder and structured content blocks for Gradio 6.x
+2. Message input + Send button
+3. Under the chat: "🌱 Log this action" checkbox group → increments session action counter → updates eco score
+4. Eco score display: circular progress indicator (CSS-only, value from gr.State)
+5. Weekly streak counter (session days active — session-based approximation)
+6. `chat_submit(message, history, profile_state, actions_state)` → calls `get_eco_answer()` → returns updated history + updated state
+
+**3c. Dashboard Tab:**
+1. Header: "Your Eco Impact This Session"
+2. Three metric cards: CO₂ saved (kg), Water saved (L), Waste diverted (kg) — computed from logged actions via `IMPACT_TABLE`
+3. Eco score gauge (HTML/CSS ring)
+4. Household summary: member count, location
+5. `update_dashboard(actions_state, profile_state)` → returns HTML string of metric cards
+
+**3d. Recycling Guide Tab:**
+1. Material dropdown: Paper, Plastic, Glass, E-waste, Metal, Organic, Batteries, Clothing
+2. City dropdown: 15 major Indian cities
+3. "Get Guide" button → calls `get_recycling_guide()` → renders in `gr.Markdown`
+4. Below: eco-friendly product recommendation section (hardcoded lookup per material category)
+
+**3e. Profile Tab:**
+1. Household name input
+2. Location dropdown (Indian states + major cities)
+3. Member count slider (1–10)
+4. Habits checklist: vegetarian diet, uses public transport, has solar panels, composts, uses cloth bags, avoids single-use plastic, harvests rainwater
+5. "Save Profile" button → updates `profile_state`
+6. Profile summary card shown after save
+
+**3f. App assembly:**
+1. `gr.Blocks()` with `css` parameter in `launch()` for Gradio 6.x compatibility
+2. All tabs inside `gr.Tabs`
+3. `demo.launch(server_name="0.0.0.0", server_port=int(os.environ.get("PORT", 7860)))`
+4. `if __name__ == "__main__":` guard
+
+**Status:** `[x] completed`
+
+---
+
+### Sub-Task 4: Update `requirements.txt`
+
+**Intent:** Minimal, pinned dependency list for the new architecture.
+
+**Expected Outcomes:**
+- Only packages actually used are listed
+- Installs cleanly on Python 3.10+ in a fresh HF Spaces environment
+
+**Todo List:**
+1. Keep: `gradio`, `ibm-watsonx-ai`, `python-dotenv`, `requests`
+2. Remove: `langchain`, `langchain-community`, `faiss-cpu`, `sentence-transformers` (not used)
+3. Pin versions based on what is installed in `.venv`
+
+**Status:** `[x] completed`
+
+---
+
+### Sub-Task 5: Update `README.md` and `AGENTS.md`
+
+**Intent:** Update docs to reflect the new architecture. HF Spaces front-matter, new env var names, deployment steps.
+
+**Todo List:**
+1. Update `README.md` HF Spaces YAML: keep gradio SDK, update description
+2. Document the 3 new env vars (`WATSONX_API_KEY`, `WATSONX_PROJECT_ID`, `WATSONX_URL`)
+3. Add "How to get a `WATSONX_PROJECT_ID`" section (watsonx.ai Studio → create project → copy ID)
+4. Update `AGENTS.md` to note `rag_pipeline.py` is deleted, new entry point is `watsonx_client.py`
+
+**Status:** `[x] completed`
+
+---
+
+## Implementation Order
+
+```
+Sub-Task 1 (.env)                    ✓ completed
+      ↓
+Sub-Task 2 (watsonx_client.py)       ✓ completed
+      ↓
+Sub-Task 3 (app.py)                  ✓ completed
+      ↓
+Sub-Task 4 (requirements.txt)        ✓ completed
+      ↓
+Sub-Task 5 (README + AGENTS.md)      ✓ completed
+```
+
+---
+
+## Files Deleted After Implementation
+
+- `rag_pipeline.py` — replaced by `watsonx_client.py`
+- `embed.txt` — was a debugging artifact, no longer needed
+- `ibm-credentials.env` — replaced by `.env`
+- `__pycache__/` — stale cache from old modules
+
+---
+
+## UI Theme
+
+Ultra-light eco green theme (implemented in `app.py`):
+- Background: `#fcfcfd` (near white)
+- Primary accent: `#2e7d50` (green)
+- Cards: `#ffffff` with subtle shadows
+- Text: `#1c1c1e` (near black), muted: `#4a4a4e`
+- Borders: `#e4e4e7` (light gray)
+- CheckboxGroup styled as selectable pills/chips
+- Chatbot with welcome placeholder and white-flash prevention CSS
+
+---
+
+## Prompt Engineering Pattern
+
+This project uses **prompt engineering** to transform IBM Granite into a domain-specific eco advisor:
+
+- **System Prompt:** 86-line `AGENT_INSTRUCTIONS` defining persona, output format, focus areas, and guardrails
+- **Static Knowledge:** `IMPACT_TABLE` (20 eco actions) and `PRODUCT_RECS` (8 material categories) injected via prompt
+- **Dynamic Context:** Household profile (members, location, habits) injected per session
+- **Output Format:** Fixed 4-part structure (Quick Tip → Why it Matters → Impact → Optional Resource)
+- **Guardrails:** Never invent stats, label [Lookup] vs [Estimate], no medical/financial advice
+
+---
+
+## Open Questions / Notes
+
+1. **`WATSONX_PROJECT_ID`** is required by the SDK for `ModelInference`. The user must create a project in watsonx.ai Studio (https://eu-de.dataplatform.cloud.ibm.com/) and copy the project ID. The app shows a clear setup error if it is missing.
+2. **`ibm/granite-4-h-small`** is the primary model. Fallback: `ibm/granite-3-3-8b-instruct` if granite-4-h-small is not available.
+3. **Session state**: All eco score and action logging is in-memory `gr.State` — no database. This resets on page refresh, which is acceptable per the spec ("session-based is fine").
+4. **Impact numbers in `IMPACT_TABLE`**: Sourced from well-known lifecycle assessment references (IPCC, EPA, Indian BEE data). Each entry notes its source category (lookup vs estimate).
+5. **Gradio 6.x compatibility**: `theme` and `css` parameters go in `launch()`, not `Blocks()` constructor. History uses structured content blocks, not plain string pairs.

requirements.txt

@@ -0,0 +1,18 @@
+# -----------------------------------------------------------------------
+# EcoAgent v2 — Python dependencies
+# Python 3.10+  |  Target: Hugging Face Spaces (CPU tier)
+# Install: pip install -r requirements.txt
+#      or: uv pip install -r requirements.txt
+# -----------------------------------------------------------------------
+
+# Gradio UI framework — pinned to installed version
+gradio==6.20.0
+
+# IBM watsonx.ai SDK (ModelInference + Credentials)
+ibm-watsonx-ai>=1.1.15
+
+# HTTP client (used by ibm-watsonx-ai internally and for any direct calls)
+requests>=2.32.3
+
+# Credential / .env loading
+python-dotenv>=1.0.1

watsonx_client.py

@@ -0,0 +1,520 @@
+"""
+watsonx_client.py
+-----------------
+IBM watsonx.ai SDK client for EcoAgent.
+
+Provides:
+  - AGENT_INSTRUCTIONS  : Editable agent behaviour / persona block
+  - IMPACT_TABLE        : CO2/water/waste lookup for 20 common eco actions
+  - get_eco_answer()    : Multi-turn chat via IBM Granite
+  - get_recycling_guide(): Single-turn recycling lookup for Indian cities
+
+Region: eu-de (Frankfurt)  |  Model: ibm/granite-4-h-small
+"""
+
+import os
+import logging
+from dotenv import load_dotenv
+
+# ---------------------------------------------------------------------------
+# Load credentials from .env
+# ---------------------------------------------------------------------------
+load_dotenv(".env")
+
+logger = logging.getLogger(__name__)
+
+# ===========================================================================
+#  AGENT INSTRUCTIONS
+#  Edit this block to customise persona, tone, focus areas, and rules.
+# ===========================================================================
+AGENT_INSTRUCTIONS = """
+You are EcoAgent — a friendly, knowledgeable, and action-focused eco lifestyle
+advisor specialised in the Indian context. Your goal is to help Indian households
+live more sustainably through practical, affordable, and culturally relevant advice.
+
+## Persona & Tone
+- Warm, encouraging, and non-preachy
+- Concise: lead with the action, not the theory
+- Use simple English; avoid jargon
+- Celebrate small wins — every action counts
+
+## Answer Structure (ALWAYS follow this)
+1. **Quick Tip** (1–2 sentences): the specific action the user should take
+2. **Why it Matters** (1 sentence): the environmental/health/cost benefit
+3. **Impact** (1 line): if the action is in the impact table, state the exact figure
+   and label it "[Lookup]"; otherwise estimate and label it "[Estimate]"
+4. **Optional Resource** (1 line): a relevant Indian scheme, website, or product
+   — only include if genuinely useful, never invent URLs
+
+## Sustainability Focus Areas
+- Plastic reduction and single-use alternatives
+- Energy efficiency (LED, appliances, solar)
+- Water conservation (short showers, rainwater harvesting, drip irrigation)
+- Eco-friendly travel (public transport, cycling, EVs under FAME scheme)
+- Food choices (reduce meat, local/seasonal produce, reduce food waste)
+- Waste management (segregation, composting, e-waste disposal)
+
+## India-Specific Context
+- Always reference Indian government schemes where applicable:
+    * PM Surya Ghar Muft Bijli Yojana (rooftop solar, up to 300 units free/month)
+    * FAME II / PM e-DRIVE (EV subsidies for 2W and 3W vehicles)
+    * Swachh Bharat Mission (waste management, ODF)
+    * Jal Jeevan Mission (clean water, conservation)
+    * UJALA scheme (LED bulb distribution at subsidised prices)
+    * National Biogas Programme (biogas plants for households)
+- Reference Indian brands and local alternatives where helpful
+  (e.g., Bamboo India, Bare Necessities, The Better India marketplace)
+- Recycling norms vary by city — acknowledge this and advise accordingly
+- Common Indian household practices to acknowledge:
+    * Pressure cookers, clay pots, steel utensils (already eco-friendly)
+    * Festivals with high waste (Diwali crackers, Holi colours)
+    * Joint family structures → household-level advice is very relevant
+
+## Safety & Accuracy Rules
+- NEVER invent statistics or make up government scheme details
+- If you are not sure of a specific number, say "approximately" and label [Estimate]
+- Do not recommend products with specific prices (prices change)
+- If the user's question is outside your eco domain, politely redirect
+- Do not provide medical, legal, or financial advice
+
+## Household Context
+When a household profile is provided, tailor advice to:
+- The number of family members (scale savings accordingly)
+- Current habits (avoid advising things they already do)
+- Location (city-specific recycling facilities, local schemes)
+- Specific constraints (e.g., rented accommodation → skip solar panel advice)
+"""
+
+# ===========================================================================
+#  CARBON / RESOURCE IMPACT LOOKUP TABLE
+#  Sources: IPCC AR6, EPA GHG equivalencies, BEE India, WRI India reports,
+#           Central Pollution Control Board (CPCB) India data.
+#  Each action maps to annual savings for ONE person unless noted.
+# ===========================================================================
+IMPACT_TABLE: dict[str, dict] = {
+    "cloth_bags": {
+        "label": "Switch to cloth/jute bags",
+        "co2_kg_year": 3.0,
+        "water_L_day": 0,
+        "waste_kg_year": 5.0,
+        "source": "Lookup",
+        "note": "Avoids ~150 plastic bags/year @ 20g CO2 each",
+    },
+    "led_bulbs": {
+        "label": "Replace all bulbs with LED",
+        "co2_kg_year": 45.0,
+        "water_L_day": 0,
+        "waste_kg_year": 0,
+        "source": "Lookup",
+        "note": "Avg Indian home 8 bulbs; 60W→9W LED, 6h/day, Indian grid 0.82 kg CO2/kWh",
+    },
+    "solar_panels": {
+        "label": "Install rooftop solar (1 kW)",
+        "co2_kg_year": 820.0,
+        "water_L_day": 0,
+        "waste_kg_year": 0,
+        "source": "Lookup",
+        "note": "1 kW @ 4.5 peak sun hours, 0.82 kg CO2/kWh displaced",
+    },
+    "composting": {
+        "label": "Compost kitchen waste",
+        "co2_kg_year": 120.0,
+        "water_L_day": 0,
+        "waste_kg_year": 150.0,
+        "source": "Lookup",
+        "note": "Avg 400g/day organic waste; avoids landfill methane",
+    },
+    "public_transport": {
+        "label": "Use public transport instead of car",
+        "co2_kg_year": 1200.0,
+        "water_L_day": 0,
+        "waste_kg_year": 0,
+        "source": "Lookup",
+        "note": "20 km/day commute; 180g CO2/km (petrol car) vs 30g CO2/km (metro/bus)",
+    },
+    "short_shower": {
+        "label": "Reduce shower time by 2 minutes",
+        "co2_kg_year": 12.0,
+        "water_L_day": 20.0,
+        "waste_kg_year": 0,
+        "source": "Lookup",
+        "note": "10 L/min showerhead; 2 min × 10 L = 20 L/day saved",
+    },
+    "rainwater_harvesting": {
+        "label": "Install rainwater harvesting",
+        "co2_kg_year": 8.0,
+        "water_L_day": 80.0,
+        "waste_kg_year": 0,
+        "source": "Lookup",
+        "note": "Avg 100 sqm roof; 800mm annual rainfall region",
+    },
+    "vegetarian_diet": {
+        "label": "Switch to vegetarian diet",
+        "co2_kg_year": 550.0,
+        "water_L_day": 800.0,
+        "waste_kg_year": 0,
+        "source": "Lookup",
+        "note": "Meat diet 2.5 kg CO2/day vs veg 1.0 kg CO2/day; water footprint halved",
+    },
+    "no_plastic_bottles": {
+        "label": "Use refillable steel/copper water bottle",
+        "co2_kg_year": 6.5,
+        "water_L_day": 0,
+        "waste_kg_year": 8.0,
+        "source": "Lookup",
+        "note": "Avoids ~500 plastic bottles/year; 13g CO2 per PET bottle",
+    },
+    "drip_irrigation": {
+        "label": "Switch to drip irrigation (garden/farm)",
+        "co2_kg_year": 0,
+        "water_L_day": 200.0,
+        "waste_kg_year": 0,
+        "source": "Lookup",
+        "note": "Drip uses 30–50% less water than flood irrigation; 40% saving assumed",
+    },
+    "smart_powerstrip": {
+        "label": "Use smart power strip / switch off standby",
+        "co2_kg_year": 28.0,
+        "water_L_day": 0,
+        "waste_kg_year": 0,
+        "source": "Lookup",
+        "note": "Standby power ~10% of home electricity; 350 kWh/year at 0.82 kg CO2/kWh",
+    },
+    "electric_two_wheeler": {
+        "label": "Switch from petrol 2W to electric",
+        "co2_kg_year": 380.0,
+        "water_L_day": 0,
+        "waste_kg_year": 0,
+        "source": "Lookup",
+        "note": "30 km/day; petrol scooter 70g CO2/km vs EV 15g CO2/km (Indian grid)",
+    },
+    "reusable_bags_produce": {
+        "label": "Use mesh bags for fruits/vegetables",
+        "co2_kg_year": 1.5,
+        "water_L_day": 0,
+        "waste_kg_year": 3.0,
+        "source": "Lookup",
+        "note": "Avoids ~150 thin plastic produce bags/year",
+    },
+    "fix_water_leaks": {
+        "label": "Fix dripping taps and leaking pipes",
+        "co2_kg_year": 3.0,
+        "water_L_day": 30.0,
+        "waste_kg_year": 0,
+        "source": "Lookup",
+        "note": "A dripping tap wastes ~15 L/day; 2 taps assumed",
+    },
+    "line_dry_clothes": {
+        "label": "Line-dry clothes instead of electric dryer",
+        "co2_kg_year": 100.0,
+        "water_L_day": 0,
+        "waste_kg_year": 0,
+        "source": "Lookup",
+        "note": "Electric dryer ~3 kWh/load, 3 loads/week; 0.82 kg CO2/kWh",
+    },
+    "seasonal_local_produce": {
+        "label": "Buy seasonal and locally grown produce",
+        "co2_kg_year": 60.0,
+        "water_L_day": 0,
+        "waste_kg_year": 0,
+        "source": "Lookup",
+        "note": "Reduces food transport emissions; avg 200g CO2/km per tonne",
+    },
+    "segregate_waste": {
+        "label": "Segregate wet/dry/hazardous waste at home",
+        "co2_kg_year": 90.0,
+        "water_L_day": 0,
+        "waste_kg_year": 200.0,
+        "source": "Lookup",
+        "note": "Enables recycling of 55% of household waste; avoids landfill methane",
+    },
+    "pressure_cooker": {
+        "label": "Use pressure cooker instead of open pot",
+        "co2_kg_year": 18.0,
+        "water_L_day": 0,
+        "waste_kg_year": 0,
+        "source": "Lookup",
+        "note": "70% faster cooking → 70% less LPG; 1 kg LPG = 3 kg CO2",
+    },
+    "no_single_use_plastic": {
+        "label": "Eliminate single-use plastics (cutlery, straws, cups)",
+        "co2_kg_year": 5.0,
+        "water_L_day": 0,
+        "waste_kg_year": 10.0,
+        "source": "Lookup",
+        "note": "India banned SUP Jul 2022; alternatives: bamboo, steel, areca leaf",
+    },
+    "organic_farming": {
+        "label": "Switch to organic / natural farming inputs",
+        "co2_kg_year": 200.0,
+        "water_L_day": 50.0,
+        "waste_kg_year": 0,
+        "source": "Estimate",
+        "note": "Avoids synthetic fertiliser (4 kg CO2 per kg N); varies widely by crop",
+    },
+}
+
+
+# ===========================================================================
+#  ECO-FRIENDLY PRODUCT RECOMMENDATIONS BY CATEGORY
+#  (Used in the Recycling & Products tab)
+# ===========================================================================
+PRODUCT_RECS: dict[str, list[str]] = {
+    "Plastic": [
+        "Bamboo India — bamboo toothbrushes, combs, straws",
+        "Bare Necessities — zero-waste personal care products",
+        "StorTi — stainless steel food storage containers",
+        "Paperwala — kraft paper bags for shopping",
+    ],
+    "Paper": [
+        "Use both sides before recycling",
+        "Switch to digital billing to reduce paper waste",
+        "Recycled paper products: Haathi Chaap (elephant-dung paper crafts)",
+        "Paper log briquettes for biomass energy",
+    ],
+    "Glass": [
+        "Milkbasket / local dairy — refillable glass bottles",
+        "Borosil glass containers as plastic-free food storage",
+        "Reuse glass jars for storage (zero cost!)",
+    ],
+    "E-waste": [
+        "E-Parisaraa — India's first e-waste recycler (Bangalore)",
+        "Karma Recycling — e-waste pick-up across major Indian cities",
+        "Attero Recycling — certified e-waste management",
+        "Check manufacturer take-back: Dell, HP, Samsung have return programmes",
+    ],
+    "Metal": [
+        "Scrap dealers (kabadiwala) for steel, copper, aluminium",
+        "Steel Recycling Institute of India (SRII) facility locator",
+        "Avoid single-use aluminium foil; use beeswax wraps instead",
+    ],
+    "Organic": [
+        "Daily Dump — home composting kits (Bangalore, ships PAN India)",
+        "Kambha composting pots — traditional Indian clay composters",
+        "SBI (Solid Biomass India) — biogas kits for kitchen waste",
+        "Vermi-composting kits via TNAU / KVK agricultural centres",
+    ],
+    "Batteries": [
+        "Exide / Amaron authorised collection centres for lead-acid batteries",
+        "Panasonic / Duracell — collect at Croma / Reliance Digital stores",
+        "Switch to rechargeable NiMH batteries (Envie brand India)",
+        "Solar lanterns: Greenlight Planet / Minda (avoid disposables)",
+    ],
+    "Clothing": [
+        "ThriftMyFashion / The Loom (pre-owned clothing platforms)",
+        "Ekgaon — organic cotton and natural dye clothing",
+        "Upasana Design Studio — sustainable handloom fashion",
+        "Goonj — donate old clothes for rural upcycling",
+        "Repair before discarding: local darzi (tailor) network",
+    ],
+}
+
+# Indian cities for recycling guide
+INDIAN_CITIES = [
+    "Mumbai", "Delhi", "Bangalore", "Hyderabad", "Chennai",
+    "Kolkata", "Pune", "Ahmedabad", "Jaipur", "Lucknow",
+    "Kochi", "Chandigarh", "Bhopal", "Indore", "Surat",
+]
+
+# ===========================================================================
+#  watsonx.ai CLIENT SETUP
+#  Uses APIClient pattern with set_default_project(), matching IBM example code.
+# ===========================================================================
+_WATSONX_API_KEY  = os.environ.get("WATSONX_API_KEY", "")
+_WATSONX_URL      = os.environ.get("WATSONX_URL", "https://eu-de.ml.cloud.ibm.com")
+_WATSONX_PROJECT_ID = os.environ.get("WATSONX_PROJECT_ID", "")
+
+# IBM Granite 4 H Small — official watsonx.ai model ID for the Granite 4 "H" (tiny) series.
+# The SDK fetches the live model list at runtime; no enum entry is required.
+# Fallback to Granite 3.3 if the project plan does not include Granite 4 access.
+_MODEL_ID_PRIMARY  = "ibm/granite-4-h-small"
+_MODEL_ID_FALLBACK = "ibm/granite-3-3-8b-instruct"
+
+_model = None      # ModelInference instance — lazy-initialised on first call
+_api_client = None # APIClient instance — reused across calls
+
+
+def _get_model():
+    """Return a cached ModelInference instance, initialising on first call.
+
+    Uses the APIClient + set_default_project() pattern so the client is
+    authenticated once and reused for every subsequent chat call.
+    """
+    global _model, _api_client
+    if _model is not None:
+        return _model
+
+    if not _WATSONX_API_KEY:
+        raise EnvironmentError(
+            "WATSONX_API_KEY is not set. "
+            "Add it to your .env file (see .env.example)."
+        )
+    if not _WATSONX_PROJECT_ID:
+        raise EnvironmentError(
+            "WATSONX_PROJECT_ID is not set.\n"
+            "How to get it:\n"
+            "  1. Go to https://eu-de.dataplatform.cloud.ibm.com\n"
+            "  2. Open your project -> Manage tab -> General -> copy Project ID\n"
+            "  3. Add WATSONX_PROJECT_ID=<uuid> to your .env file"
+        )
+
+    try:
+        from ibm_watsonx_ai import APIClient, Credentials
+        from ibm_watsonx_ai.foundation_models import ModelInference
+    except ImportError as exc:
+        raise ImportError(
+            "ibm-watsonx-ai is not installed. Run: pip install ibm-watsonx-ai"
+        ) from exc
+
+    # Build credentials and APIClient — mirrors the IBM example code exactly:
+    #   credentials = Credentials(url=..., api_key=...)
+    #   api_client  = APIClient(credentials, space_id)
+    #   api_client.set.default_project(space_id)
+    credentials = Credentials(url=_WATSONX_URL, api_key=_WATSONX_API_KEY)
+    _api_client = APIClient(credentials, _WATSONX_PROJECT_ID)
+    _api_client.set.default_project(_WATSONX_PROJECT_ID)
+    logger.info("watsonx APIClient initialised (project=%s)", _WATSONX_PROJECT_ID)
+
+    # Try primary model, fall back silently if unavailable in this project
+    for model_id in (_MODEL_ID_PRIMARY, _MODEL_ID_FALLBACK):
+        try:
+            _model = ModelInference(
+                model_id=model_id,
+                api_client=_api_client,
+            )
+            logger.info("watsonx ModelInference initialised: %s", model_id)
+            return _model
+        except Exception as exc:  # noqa: BLE001
+            logger.warning(
+                "Model %s unavailable (%s) — trying fallback", model_id, exc
+            )
+
+    raise RuntimeError(
+        f"Neither {_MODEL_ID_PRIMARY!r} nor {_MODEL_ID_FALLBACK!r} could be "
+        "initialised. Check your watsonx.ai project has access to these models."
+    )
+
+
+def _build_system_prompt(profile: dict) -> str:
+    """Inject household profile context into the system message."""
+    profile_block = ""
+    if profile:
+        members = profile.get("members", 1)
+        location = profile.get("location", "India")
+        habits = profile.get("habits", [])
+        name = profile.get("name", "")
+        profile_block = (
+            f"\n\n## Current Household Profile\n"
+            f"- Household name: {name or 'Not provided'}\n"
+            f"- Location: {location}\n"
+            f"- Members: {members}\n"
+            f"- Current eco habits: {', '.join(habits) if habits else 'None specified'}\n"
+            f"\nScale all impact estimates to {members} person(s) where relevant. "
+            f"Do not re-recommend habits the household already practises."
+        )
+    return AGENT_INSTRUCTIONS.strip() + profile_block
+
+
+def get_eco_answer(messages: list[dict], profile: dict | None = None) -> str:
+    """Send a multi-turn conversation to Granite and return the reply.
+
+    Args:
+        messages: List of {"role": "user"|"assistant", "content": str} dicts.
+                  Do NOT include a system message — this function prepends it.
+        profile:  Optional household profile dict from the Profile tab.
+
+    Returns:
+        The assistant's reply as a plain string.
+
+    Raises:
+        EnvironmentError: Missing credentials (caught by app.py).
+        RuntimeError:     API call failure (caught by app.py).
+    """
+    model = _get_model()
+    system_prompt = _build_system_prompt(profile or {})
+
+    full_messages = [{"role": "system", "content": system_prompt}] + messages
+
+    try:
+        response = model.chat(
+            messages=full_messages,
+            params={
+                "max_tokens": 800,
+                "temperature": 0.7,
+                "top_p": 0.95,
+            },
+        )
+        return response["choices"][0]["message"]["content"].strip()
+    except KeyError as exc:
+        raise RuntimeError(
+            f"Unexpected response format from watsonx.ai: missing key {exc}. "
+            f"Raw response: {str(response)[:300]}"
+        ) from exc
+    except Exception as exc:  # noqa: BLE001
+        raise RuntimeError(f"watsonx.ai call failed: {exc}") from exc
+
+
+def get_recycling_guide(material: str, city: str) -> str:
+    """Ask Granite for recycling instructions for a specific material and city.
+
+    Args:
+        material: One of the material categories (e.g. "E-waste", "Plastic").
+        city:     Indian city name for local context.
+
+    Returns:
+        Formatted recycling guide as a markdown string.
+    """
+    prompt = (
+        f"Provide a practical recycling guide for **{material}** waste in {city}, India. "
+        f"Include:\n"
+        f"1. How to prepare/segregate this waste at home\n"
+        f"2. Where to drop it off or how to get it collected in {city}\n"
+        f"3. What happens to it after collection (briefly)\n"
+        f"4. One eco-friendly alternative to reduce this waste type\n"
+        f"Keep the response concise, practical, and India-specific. "
+        f"Use bullet points. Label any uncertain details as [Estimate]."
+    )
+    model = _get_model()
+    try:
+        response = model.chat(
+            messages=[
+                {"role": "system", "content": AGENT_INSTRUCTIONS.strip()},
+                {"role": "user", "content": prompt},
+            ],
+            params={"max_tokens": 500, "temperature": 0.4},
+        )
+        return response["choices"][0]["message"]["content"].strip()
+    except Exception as exc:  # noqa: BLE001
+        raise RuntimeError(f"Recycling guide call failed: {exc}") from exc
+
+
+def compute_session_impact(logged_actions: list[str], members: int = 1) -> dict:
+    """Aggregate CO2/water/waste savings for a list of logged action slugs.
+
+    Args:
+        logged_actions: List of action slug strings from IMPACT_TABLE keys.
+        members:        Household size to scale savings.
+
+    Returns:
+        Dict with keys: co2_kg_year, water_L_day, waste_kg_year, eco_score (0–100).
+    """
+    co2 = 0.0
+    water = 0.0
+    waste = 0.0
+    unique = set(logged_actions)
+
+    for slug in unique:
+        entry = IMPACT_TABLE.get(slug)
+        if entry:
+            co2 += entry.get("co2_kg_year", 0) * members
+            water += entry.get("water_L_day", 0) * members
+            waste += entry.get("waste_kg_year", 0) * members
+
+    eco_score = min(100, len(unique) * 8)  # 8 pts per unique action, cap 100
+    return {
+        "co2_kg_year": round(co2, 1),
+        "water_L_day": round(water, 1),
+        "waste_kg_year": round(waste, 1),
+        "eco_score": eco_score,
+        "actions_count": len(unique),
+    }