ujwal55/Stateful_Reminder_Agent

Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference

⏰ Stateful Reminder Agent (Timezone-Aware)

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 (Replace with your actual link)

🧠 Features

• —✅ 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 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

This agent simulates key agentic AI principles:

• —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

🛠️ Setup & Run Locally

1. Clone the repo

git clone https://huggingface.co/spaces/ujwal55/Stateful_Reminder_Agent
cd Stateful_Reminder_Agent

2. Install dependencies

pip install -r requirements.txt

3. Run the app

python app.py

🧪 Example Usage

• —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.

• —Check "What's Next?" → Tells if anything is due within the next 60 seconds.

• —Delete Reminder → Input same time + timezone to remove.

⚠️ Known Limitations

• —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)

💡 Possible Extensions

• —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 — aspiring Agentic AI Developer