docs: enhance README and improve Streamlit interface

README.md

@@ -8,6 +8,12 @@
 ![SentenceTransformers](https://img.shields.io/badge/SentenceTransformers-5.5-0A66C2)
 ![Groq](https://img.shields.io/badge/Groq-LLM-FF6B00)
 
+## 🚀 Live Demo
+
+Experience the NileTel Arabic AI Assistant in action!
+
+👉 <b><a href="https://telecom-rag-system.streamlit.app/" style="color: #007bff; text-decoration: none;">Launch the Live Demo Here</a></b>
+
 RAG-based telecom support assistant for Arabic and English with hybrid retrieval, query rewriting, and ticket automation. The UI is built with Streamlit and the API runs on FastAPI. Ticket creation is triggered automatically via n8n when the answer implies an action, and the UI asks for the user name only in those cases.
 
 ## Features
@@ -42,23 +48,43 @@ Then edit `.env`:
 GROQ_API_KEY=your_key_here
 ```
 
-### 2) Install dependencies
+### Installation & Running Options
+
+Choose one of the following methods to run the project. We recommend using **Option A** for significantly faster dependency installation and execution.
 
-Using pip:
+#### Option A: Fast Setup with `uv` (Recommended)
 
+**1) Install dependencies:**
+```bash
+uv pip install -r requirements.txt
 ```
-pip install -r requirements.txt
+
+**2) Run the API:**
+```bash
+uv run uvicorn main:app --reload --port 8000
 ```
 
-### 3) Run the API
+**3) Run the UI:**
+```bash
+uv run streamlit run streamlit_app.py
+```
 
+---
+
+#### Option B: Standard Setup with `pip`
+
+**1) Install dependencies:**
+```bash
+pip install -r requirements.txt
 ```
+
+**2) Run the API:**
+```bash
 uvicorn main:app --reload --port 8000
 ```
 
-### 4) Run the UI
-
-```
+**3) Run the UI:**
+```bash
 streamlit run streamlit_app.py
 ```
 

main.py

@@ -93,26 +93,29 @@ def ask(request: QueryRequest):
     # 2. IF ACTION NEEDED → CALL n8n
     # --------------------------------------------------------
     if response["needs_action"] == "YES":
-        print("[API] Action detected → Triggering n8n workflow...")
-
-        try:
-            # Send POST request to n8n webhook
-            res = requests.post(
-                N8N_WEBHOOK_URL,   #  destination (n8n)
-                json={             #  data sent to n8n
-                    "query": request.query,
-                    "name": name,
-                    "answer": response["answer"],
-                    "sources": response["sources"]
-                },
-                timeout=5  # prevent hanging if n8n is slow
-            )
-
-            print(f"[API] n8n status: {res.status_code}")
-            print(f"[API] n8n response: {res.text}")
-
-        except Exception as e:
-            print(f"[API] n8n error: {str(e)}")
+        if not name:
+            print("[API] Action detected but no name provided → Skipping n8n.")
+        else:
+            print("[API] Action detected → Triggering n8n workflow...")
+
+            try:
+                # Send POST request to n8n webhook
+                res = requests.post(
+                    N8N_WEBHOOK_URL,   #  destination (n8n)
+                    json={             #  data sent to n8n
+                        "query": request.query,
+                        "name": name,
+                        "answer": response["answer"],
+                        "sources": response["sources"]
+                    },
+                    timeout=5  # prevent hanging if n8n is slow
+                )
+
+                print(f"[API] n8n status: {res.status_code}")
+                print(f"[API] n8n response: {res.text}")
+
+            except Exception as e:
+                print(f"[API] n8n error: {str(e)}")
 
     else:
         print("[API] No action needed")

streamlit_app.py

@@ -19,6 +19,10 @@ if "last_response" not in st.session_state:
     st.session_state.last_response = None
     st.session_state.last_query = ""
     st.session_state.ticket_name = ""
+if "last_page" not in st.session_state:
+    st.session_state.last_page = ""
+if "tickets_refresh" not in st.session_state:
+    st.session_state.tickets_refresh = 0
 
 # Injecting Custom CSS for a VERY GOOD UI
 st.markdown(
@@ -299,7 +303,7 @@ with st.sidebar:
     st.markdown("## Navigation")
     page = st.radio(
         "Choose a View",
-        ["💬 Chat Assistant", "🎫 Tickets Dashboard"],
+        ["💬 Chat Assistant", "🎫 Tickets Table"],
         label_visibility="collapsed"
     )
     
@@ -309,13 +313,16 @@ with st.sidebar:
         <div class="sidebar-card">
             <div class="sidebar-card-title">System Status</div>
             <div class="sidebar-row"><span class="status-dot"></span> Live API</div>
-            <div class="sidebar-row">Data refresh: 60s</div>
             <div class="sidebar-row">Languages: AR / EN</div>
         </div>
         """,
         unsafe_allow_html=True
     )
 
+if page == "🎫 Tickets Table" and st.session_state.last_page != page:
+    st.session_state.tickets_refresh += 1
+st.session_state.last_page = page
+
 
 # =========================
 # 🌟 MAIN VIEW ROUTING
@@ -433,17 +440,22 @@ if page == "💬 Chat Assistant":
                 chips_html = "".join([f"<span class='source-chip'>📄 {html.escape(str(s))}</span>" for s in sources])
                 st.markdown(f"<div>{chips_html}</div>", unsafe_allow_html=True)
 
-elif page == "🎫 Tickets Dashboard":
-    st.markdown("### 🎫 Tickets Dashboard")
+elif page == "🎫 Tickets Table":
+    st.markdown("### 🎫 Tickets Table")
     st.markdown("<p style='color:#5a5a5a; margin-bottom: 20px;'>View and manage all telecom support tickets fetched live from the central system.</p>", unsafe_allow_html=True)
+    
+    col1, col2 = st.columns([8, 2])
+    with col2:
+        if st.button("🔄 Refresh Data", use_container_width=True):
+            st.session_state.tickets_refresh += 1
 
-    @st.cache_data(show_spinner=False, ttl=60)
-    def _load_tickets(url):
+    @st.cache_data(show_spinner=False)
+    def _load_tickets(url, refresh_token):
         return pd.read_csv(url)
 
     with st.spinner("Loading tickets from live database..."):
         try:
-            df = _load_tickets(SHEET_URL)
+            df = _load_tickets(SHEET_URL, st.session_state.tickets_refresh)
             if df.empty:
                 st.info("No tickets available at the moment.")
             else: