CoolFace
Apppublic

esuteric/Agentic-Holidays-Planner

sourceHugging Faceupdated 1y agoView on Hugging Face
0likes
App README

๐Ÿง  Agentic AI Travel Planner โ€“ Islamabad ๐Ÿ‡ต๐Ÿ‡ฐ

Welcome to the Agentic AI Travel Assistant, a smart Python-based app that plans your personalized trip to Islamabad, Pakistan! This fully autonomous agent:


๐Ÿ” Features

โœ… Asks for:

  • โ€”Number of travel days
  • โ€”Start date
  • โ€”Interests (e.g., food, history, nature)

โœ… Automatically:

  • โ€”Checks weather using OpenWeatherMap
  • โ€”Recommends places using Foursquare API
  • โ€”Avoids conflicts using your Google Calendar
  • โ€”Adds all activities as calendar events (no button click needed!)
  • โ€”Provides a clean, day-wise travel plan via Gradio UI

๐Ÿง  Technologies Used

  • โ€”Python
  • โ€”Gradio (for UI)
  • โ€”Google Calendar API (via service account)
  • โ€”OpenWeatherMap API
  • โ€”Foursquare API
  • โ€”dotenv (for secure key loading)
  • โ€”Hugging Face Spaces for deployment

๐Ÿ” How to Set Up Your Own Version

To run this app yourself (on Hugging Face or locally), youโ€™ll need the following secrets:

Secret NamePurpose
OPENWEATHERMAP_API_KEYWeather forecasts
FOURSQUARE_API_KEYPOI recommendations
CALENDAR_IDYour Google Calendar ID
GOOGLE_CLIENT_SECRETService account JSON string
The GOOGLE_CLIENT_SECRET should contain the full content of your credentials.json file, pasted as a Hugging Face secret.

๐Ÿ›  How to Deploy on Hugging Face

  1. 1.Create a new Gradio Space
  2. 2.Upload the following files:
  3. 3.app.py
  4. 4.planner.py
  5. 5.calendar_client.py
  6. 6.requirements.txt
  7. 7.Go to Settings > Secrets and add the required keys
  8. 8.App will launch automatically within 2 minutes ๐ŸŽ‰

๐Ÿค– Demo

Type the number of days, a starting date, and interests like: