Updated README, app.py and requirements.txt

README.md

@@ -12,63 +12,76 @@ short_description: Agent that manages user reminders with in-session memory
 
 Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
 
+# ⏰ Stateful Reminder Agent (Timezone-Aware)
 
-# ⏰ Stateful Reminder Agent
-
-A lightweight agentic AI app that lets you create, check, and delete reminders—all in-session. Built with Python and Gradio, it demonstrates how an agent can maintain state, respond to commands, and simulate real-world utility.
+A simple agentic AI app to help you add, view, check, and delete reminders — now with **timezone support**! Built using Python and Gradio, this project showcases stateful behavior and time-based task handling in real-time.
 
 ---
 
 ## 🚀 Live Demo
 
-👉 [Launch on Hugging Face Spaces](https://huggingface.co/spaces/ujwal55/Stateful_Reminder_Agent) *(replace with actual link when deployed)*
+👉 [Launch on Hugging Face Spaces](https://huggingface.co/spaces/ujwal55/Stateful_Reminder_Agent) *(Replace with your actual link)*
 
 ---
 
 ## 🧠 Features
 
-- ✅ **Add Reminders** — specify a time and message.
-- 📋 **List All Reminders** — see upcoming reminders in chronological order.
-- 🔔 **Check “What’s Next?”** — find out which reminder is due right now.
-- 🗑️ **Delete Reminders** — remove any scheduled reminder by time.
-- 💾 **Stateful Memory** — reminders are stored in memory during the session using Python data structures.
+- ✅ **Add Reminders** — set reminders using a chosen timezone.
+- 🌍 **Timezone Support** — select from common timezones (e.g., Asia/Kolkata, UTC).
+- 📋 **List Reminders** — shows upcoming reminders with time left.
+- 🔔 **Check “What’s Next?”** — tells you if something is due right now.
+- 🗑️ **Delete Reminders** — remove a reminder by exact time + timezone.
+- 💾 **In-Session State** — reminders are stored in memory (not persisted).
 
 ---
 
 ## 📦 Tech Stack
 
-- **Python**
-- **Gradio** — for building a reactive multi-tab user interface.
-- **Datetime** — to handle scheduling logic.
-- **In-memory Dictionary/List** — for state management.
+- **Python 3.6+**
+- **Gradio** — interactive UI
+- **pytz** — for timezone-aware datetime handling
+
+---
+
+## 📁 File Structure
+
+```
+
+Stateful\_Reminder\_Agent/
+├── app.py            # Main app logic
+├── README.md         # This file
+└── requirements.txt  # Dependencies
+
+````
 
 ---
 
-## 🧩 Agentic AI Concepts
+## 🧠 Agentic AI Concepts
+
+This agent simulates key agentic AI principles:
 
-This project mimics basic agentic behavior:
-- Maintains **state** in memory
-- Executes **task-specific logic** on user input
-- Handles multiple user queries through a unified UI
-- Performs real-time computation (e.g., checking due reminders)
+- Maintains **session memory** of tasks (reminders)
+- Responds to user input with **goal-oriented behavior**
+- Operates with **real-time logic** and conditional decisions
+- Supports **multi-function interaction** via tabs
 
 ---
 
-## 💻 Run Locally
+## 🛠️ Setup & Run Locally
 
-1. Clone the repo:
+### 1. Clone the repo
 ```bash
 git clone https://huggingface.co/spaces/ujwal55/Stateful_Reminder_Agent
 cd Stateful_Reminder_Agent
 ````
 
-2. Install dependencies:
+### 2. Install dependencies
 
 ```bash
-pip install gradio
+pip install -r requirements.txt
 ```
 
-3. Run the app:
+### 3. Run the app
 
 ```bash
 python app.py
@@ -76,41 +89,40 @@ python app.py
 
 ---
 
-## 📁 File Structure
+## 🧪 Example Usage
 
-```
-app.py          # Main Gradio app
-README.md       # Project info
-requirements.txt # Gradio
-```
+* **Add Reminder**
+  ➤ Time: `2025-06-07 09:00`
+  ➤ Message: `Join Turing Test Interview`
+  ➤ Timezone: `Asia/Kolkata`
 
----
+* **List All**
+  → Shows upcoming reminders in your selected timezone.
 
-## 🧪 Example Usage
+* **Check "What's Next?"**
+  → Tells if anything is due within the next 60 seconds.
 
-* **Input:** Add reminder at `2025-06-07 09:00` with message `Doctor's appointment`
-* **List:** View all reminders with time left
-* **Check:** Ask “What's next?” to find out what’s due now
-* **Delete:** Remove the reminder using its exact timestamp
+* **Delete Reminder**
+  → Input same time + timezone to remove.
 
 ---
 
-## ⚠️ Limitations
+## ⚠️ Known Limitations
 
-* Reminders are stored **in-memory only** (not saved across sessions)
-* No background scheduler (must press button to check due reminders)
+* Data is not persisted — reminders are lost when session ends.
+* No background scheduler (must manually press "What's Next?")
+* Limited timezone dropdown (can be expanded easily)
 
 ---
 
-## 📌 Future Ideas
+## 💡 Possible Extensions
 
-* Add persistent storage (e.g., JSON or SQLite)
-* Integrate voice or chatbot interface
-* Enable time zone support
-* Use local LLM to parse natural language reminders
+* Persist reminders with SQLite or JSON
+* Use natural language input like: *"Remind me to drink water in 2 hours"*
+* Add background trigger or sound alert
+* Detect user’s timezone automatically (via browser)
 
 ---
 
-👨‍💻 Built by [@ujwal55](https://huggingface.co/ujwal55) — Agentic AI Developer in Progress
+👨‍💻 Built by [@ujwal55](https://huggingface.co/ujwal55) — aspiring Agentic AI Developer
 
-```

app.py

@@ -1,78 +1,91 @@
 import gradio as gr
-from datetime import datetime, timedelta
+from datetime import datetime
+import pytz
 
 # In-session reminder list
-reminders = []
+reminders = []  # Format: {'time': datetime, 'message': str, 'tz': str}
 
-# Format: {'time': datetime, 'message': str}
-def add_reminder(time_str, message):
+# Add a reminder
+def add_reminder(time_str, message, timezone):
     try:
-        time_obj = datetime.strptime(time_str, "%Y-%m-%d %H:%M")
-        now = datetime.now()
-        if time_obj < now:
+        user_tz = pytz.timezone(timezone)
+        naive_dt = datetime.strptime(time_str, "%Y-%m-%d %H:%M")
+        aware_dt = user_tz.localize(naive_dt)
+
+        now_utc = datetime.now(pytz.utc)
+        if aware_dt.astimezone(pytz.utc) < now_utc:
             return "⛔ Time is in the past. Please enter a future time."
-        reminders.append({'time': time_obj, 'message': message})
-        reminders.sort(key=lambda x: x['time'])  # Sort by time
-        return f"✅ Reminder added for {time_obj.strftime('%Y-%m-%d %H:%M')}"
+
+        reminders.append({'time': aware_dt, 'message': message, 'tz': timezone})
+        reminders.sort(key=lambda x: x['time'].astimezone(pytz.utc))
+        return f"✅ Reminder added for {aware_dt.strftime('%Y-%m-%d %H:%M %Z')}"
     except Exception as e:
         return f"❌ Error: {str(e)}"
 
+# List reminders
 def list_reminders():
     if not reminders:
         return "📭 No reminders yet."
+    now = datetime.now(pytz.utc)
     result = []
-    now = datetime.now()
     for r in reminders:
-        time_left = r['time'] - now
+        local_time = r['time'].astimezone(pytz.timezone(r['tz']))
+        time_left = r['time'].astimezone(pytz.utc) - now
         mins = int(time_left.total_seconds() / 60)
-        result.append(f"🕒 {r['time'].strftime('%Y-%m-%d %H:%M')} → {r['message']} ({mins} min left)")
+        result.append(f"🕒 {local_time.strftime('%Y-%m-%d %H:%M %Z')} → {r['message']} ({mins} min left)")
     return "\n".join(result)
 
+# Check next due reminder
 def check_next():
-    now = datetime.now()
-    due = [r for r in reminders if abs((r['time'] - now).total_seconds()) < 60]
-    if due:
-        return f"🔔 Due now: {due[0]['message']} ({due[0]['time'].strftime('%H:%M')})"
-    return "✅ Nothing due right now."  
+    now = datetime.now(pytz.utc)
+    for r in reminders:
+        if abs((r['time'].astimezone(pytz.utc) - now).total_seconds()) < 60:
+            local_time = r['time'].astimezone(pytz.timezone(r['tz']))
+            return f"🔔 Due now: {r['message']} ({local_time.strftime('%H:%M %Z')})"
+    return "✅ Nothing due right now."
 
-def delete_reminder(time_str):
+# Delete reminder
+def delete_reminder(time_str, timezone):
     try:
-        time_obj = datetime.strptime(time_str, "%Y-%m-%d %H:%M")
+        user_tz = pytz.timezone(timezone)
+        target_time = user_tz.localize(datetime.strptime(time_str, "%Y-%m-%d %H:%M"))
         global reminders
-        original = len(reminders)
-        reminders = [r for r in reminders if r['time'] != time_obj]
-        if len(reminders) < original:
-            return f"🗑️ Reminder for {time_str} deleted."
-        else:
-            return f"⚠️ No reminder found for {time_str}."
-    except:
-        return "❌ Invalid time format. Use YYYY-MM-DD HH:MM"
+        original_len = len(reminders)
+        reminders = [r for r in reminders if not (
+            r['time'].astimezone(pytz.utc) == target_time.astimezone(pytz.utc)
+        )]
+        if len(reminders) < original_len:
+            return f"🗑️ Reminder at {time_str} ({timezone}) deleted."
+        return "⚠️ No matching reminder found."
+    except Exception as e:
+        return f"❌ Error: {str(e)}"
+
+# Common timezone choices
+timezone_choices = ["UTC", "Asia/Kolkata", "America/New_York", "Europe/London", "Asia/Tokyo"]
 
 # Gradio UI
 with gr.Blocks() as demo:
-    gr.Markdown("## ⏰ Stateful Reminder Agent")
-    
+    gr.Markdown("## ⏰ Stateful Reminder Agent with Timezone Support")
+
     with gr.Tab("➕ Add Reminder"):
-        time_in = gr.Textbox(label="Time (YYYY-MM-DD HH:MM)", placeholder="2025-06-06 15:30")
-        msg_in = gr.Textbox(label="Reminder Message", placeholder="Attend meeting")
+        time_in = gr.Textbox(label="Time (YYYY-MM-DD HH:MM)", placeholder="2025-06-07 09:00")
+        msg_in = gr.Textbox(label="Reminder Message", placeholder="Doctor appointment")
+        tz_in = gr.Dropdown(label="Timezone", choices=timezone_choices, value="UTC")
         out_add = gr.Textbox(label="Status")
-        btn_add = gr.Button("Add Reminder")
-        btn_add.click(fn=add_reminder, inputs=[time_in, msg_in], outputs=out_add)
+        gr.Button("Add Reminder").click(fn=add_reminder, inputs=[time_in, msg_in, tz_in], outputs=out_add)
 
     with gr.Tab("📋 View All Reminders"):
         out_list = gr.Textbox(label="Reminders", lines=10)
-        btn_list = gr.Button("List Reminders")
-        btn_list.click(fn=list_reminders, outputs=out_list)
+        gr.Button("List Reminders").click(fn=list_reminders, outputs=out_list)
 
     with gr.Tab("🔔 Check What’s Due"):
         out_next = gr.Textbox(label="Next Reminder")
-        btn_next = gr.Button("What's Next?")
-        btn_next.click(fn=check_next, outputs=out_next)
+        gr.Button("What's Next?").click(fn=check_next, outputs=out_next)
 
     with gr.Tab("🗑️ Delete Reminder"):
         del_time = gr.Textbox(label="Time to Delete (YYYY-MM-DD HH:MM)")
+        del_tz = gr.Dropdown(label="Timezone of Reminder", choices=timezone_choices, value="UTC")
         out_del = gr.Textbox(label="Status")
-        btn_del = gr.Button("Delete")
-        btn_del.click(fn=delete_reminder, inputs=del_time, outputs=out_del)
+        gr.Button("Delete").click(fn=delete_reminder, inputs=[del_time, del_tz], outputs=out_del)
 
 demo.launch()

requirements.txt

@@ -1 +1,2 @@
-gradio
+gradio
+pytz