{"id":26261887,"url":"https://github.com/bala-ceg/ai-travelassistant","last_synced_at":"2025-04-30T09:21:39.271Z","repository":{"id":282145359,"uuid":"946141987","full_name":"bala-ceg/ai-travelassistant","owner":"bala-ceg","description":"AI Travel Assistant is a powerful AI-powered tool that helps users plan their trips effortlessly. It integrates flight search, hotel booking, and sightseeing recommendations to generate a structured travel itinerary using LangChain, Apify, and OpenAI","archived":false,"fork":false,"pushed_at":"2025-03-13T17:22:02.000Z","size":26,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-23T23:49:37.236Z","etag":null,"topics":["apify","apify-actor","langchain","langgraph"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bala-ceg.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-03-10T17:14:53.000Z","updated_at":"2025-03-13T17:22:05.000Z","dependencies_parsed_at":"2025-03-13T03:23:38.508Z","dependency_job_id":"05044445-79a3-4c5a-bed0-dfbc4649f3c8","html_url":"https://github.com/bala-ceg/ai-travelassistant","commit_stats":null,"previous_names":["bala-ceg/ai-travelassistant"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bala-ceg%2Fai-travelassistant","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bala-ceg%2Fai-travelassistant/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bala-ceg%2Fai-travelassistant/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bala-ceg%2Fai-travelassistant/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bala-ceg","download_url":"https://codeload.github.com/bala-ceg/ai-travelassistant/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251674989,"owners_count":21625716,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["apify","apify-actor","langchain","langgraph"],"created_at":"2025-03-14T00:16:30.693Z","updated_at":"2025-04-30T09:21:39.252Z","avatar_url":"https://github.com/bala-ceg.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🌍 AI Travel Assistant\n\n**AI Travel Assistant** is a powerful AI-powered tool that helps users plan their trips effortlessly. It integrates **flight search, hotel booking, and sightseeing recommendations** to generate a structured **travel itinerary** using **LangChain, Apify, and OpenAI**.\n\n---\n\n## ✈️ Features\n\n- 🛫 **Flight Search**: Finds the best flight options based on departure and arrival cities.\n- 🏨 **Hotel Search**: Suggests accommodations with pricing, ratings, and amenities.\n- 📍 **Sightseeing Recommendations**: Lists must-visit places at the destination.\n- 📅 **AI-Generated Itinerary**: Creates a day-wise structured travel plan.\n- 📜 **Markdown Report Generation**: Saves itinerary in a readable markdown format.\n- ⚡ **Apify Actor Integration**: Uses Apify actors for web scraping travel data.\n- 🔗 **LangChain \u0026 OpenAI**: Ensures intelligent, natural language processing.\n\n---\n\n## 🚀 Installation\n\n### 1️⃣ Clone the repository\n\n```bash\ngit clone https://github.com/yourusername/ai-travelassistant.git\ncd ai-travelassistant\n```\n\n### 2️⃣ Create a Virtual Environment (Optional)\n```bash\npython -m venv .venv\nsource .venv/bin/activate  # On Windows: .venv\\Scripts\\activate\n```\n\n### 3️⃣ Install Dependencies\n```bash\npip install -r requirements.txt\n```\n\n### 4️⃣ Set API Keys\nCreate a `.env` file and add your API keys:\n```ini\nOPENAI_API_KEY=your-openai-key\nSERPAPI_KEY=your-serpapi-key\n```\n\n---\n\n## 🎯 **How to Run Locally**\n```bash\napify run --input-file=input.json\n```\n📜 **Example `input.json`**\n```json\n{\n    \"ticker\": \"Plan a 7-day trip to Bali from New York, staying in a beachfront hotel.\"\n}\n```\n\n---\n```\nai-travelassistant/\n│── src/\n│   ├── main.py         # Apify Actor entry point\n│   ├── tools.py        # Flight, hotel, sightseeing scraping tools\n│   ├── models.py       # Pydantic data models\n│   ├── prompts.py      # AI prompt templates\n│   ├── report.md       # Generated travel itinerary report\n│── .venv/              # Virtual environment (optional)\n│── requirements.txt    # Python dependencies\n│── README.md           # Project documentation\n│── input.json          # Example input format\n│── .env                # API keys (gitignore this file)\n```\n---\n\n## 📊 **Example Report Output**\n\n# ✈️ AI Travel Assistant Report\n\n## 🌍 Travel Itinerary Summary\n- **Destination:** `Bali`\n- **Departure Date:** `2025-03-17`\n- **Return Date:** `2025-03-24`\n\n---\n\n## 📝 AI-Generated Itinerary\n### Day 1:  \n- 🌅 **Morning Activities:**  \n    - Arrival in Bali\n    - Check-in at Villa Karma Loka\n\n- 🍽 **Lunch:**  \n    - Enjoy a traditional Balinese meal at a local warung\n\n- 🎭 **Afternoon \u0026 Evening Plans:**  \n    - Visit Sacred Monkey Forest Sanctuary\n    - Explore Ubud Market\n    - Dinner at a local restaurant\n\n- 🚖 **Transport:**  \n    - Private car or taxi to attractions\n\n- 💰 **Approximate Daily Costs:**  \n    - Flight: $1001\n    - Hotel: $60\n    - Attractions: $10\n    - Food: $20\n    - Total: $1091\n\n### Day 2:  \n- 🌅 **Morning Activities:**  \n    - Breakfast at Villa Karma Loka\n    - Visit Uluwatu Temple\n\n- 🍽 **Lunch:**  \n    - Enjoy seafood by the beach at Jimbaran Bay\n\n- 🎭 **Afternoon \u0026 Evening Plans:**  \n    - Explore Ceking Rice Terrace\n    - Relax at the beach\n    - Dinner at a beachfront restaurant\n\n- 🚖 **Transport:**  \n    - Rent a scooter for the day\n\n- 💰 **Approximate Daily Costs:**  \n    - Flight: $0 (no flight on this day)\n    - Hotel: $60\n    - Attractions: $15\n    - Food: $30\n    - Total: $105\n\n### Day 3:  \n- 🌅 **Morning Activities:**  \n    - Breakfast at The Kirana Ungasan\n    - Visit Campuhan Ridge Walk\n\n- 🍽 **Lunch:**  \n    - Try local Balinese cuisine at a village restaurant\n\n- 🎭 **Afternoon \u0026 Evening Plans:**  \n    - Visit Ulun Danu Beratan Temple\n    - Explore Bedugul Botanical Gardens\n    - Dinner at a lakeside restaurant\n\n- 🚖 **Transport:**  \n    - Hire a private driver for the day\n\n- 💰 **Approximate Daily Costs:**  \n    - Flight: $0 (no flight on this day)\n    - Hotel: $30\n    - Attractions: $20\n    - Food: $25\n    - Total: $75\n\n### Day 4:  \n- 🌅 **Morning Activities:**  \n    - Breakfast at Prasi Sunset Bungalows\n    - Visit Waterbom Bali\n\n- 🍽 **Lunch:**  \n    - Have a poolside lunch at a resort\n\n- 🎭 **Afternoon \u0026 Evening Plans:**  \n    - Relax at the beach\n    - Sunset dinner cruise\n\n- 🚖 **Transport:**  \n    - Shuttle or taxi to attractions\n\n- 💰 **Approximate Daily Costs:**  \n    - Flight: $0 (no flight on this day)\n    - Hotel: $19\n    - Attractions: $50\n    - Food: $50\n    - Total: $119\n\n### Day 5:  \n- 🌅 **Morning Activities:**  \n    - Breakfast at Masna House\n    - Visit Pura Tirta Empul\n\n- 🍽 **Lunch:**  \n    - Try Indonesian cuisine at a local restaurant\n\n- 🎭 **Afternoon \u0026 Evening Plans:**  \n    - Visit Tegenungan Waterfall\n    - Explore Ubud Palace\n    - Dinner at a rooftop restaurant\n\n- 🚖 **Transport:**  \n    - Rent a car for the day\n\n- 💰 **Approximate Daily Costs:**  \n    - Flight: $0 (no flight on this day)\n    - Hotel: $18\n    - Attractions: $15\n    - Food: $35\n    - Total: $68\n\n### Day 6:  \n- 🌅 **Morning Activities:**  \n    - Breakfast at The Laguna, a Luxury Collection Resort \u0026 Spa, Nusa Dua, Bali\n    - Visit Bali Safari and Marine Park\n\n- 🍽 **Lunch:**  \n    - Enjoy a buffet lunch at the park\n\n- 🎭 **Afternoon \u0026 Evening Plans:**  \n    - Relax at the resort\n    - Dinner at a fine dining restaurant\n\n- 🚖 **Transport:**  \n    - Shuttle to the park\n\n- 💰 **Approximate Daily Costs:**  \n    - Flight: $0 (no flight on this day)\n    - Hotel: $128\n    - Attractions: $50\n    - Food: $40\n    - Total: $218\n\n### Day 7:  \n- 🌅 **Morning Activities:**  \n    - Breakfast at Sumberkima Hill Retreat\n    - Visit Besakih Great Temple\n\n- 🍽 **Lunch:**  \n    - Try traditional Balinese cuisine at a local restaurant\n\n- 🎭 **Afternoon \u0026 Evening Plans:**  \n    - Visit Bali Zoo\n    - Sunset dinner at a beach club\n\n- 🚖 **Transport:**  \n    - Private car hire for the day\n\n- 💰 **Approximate Daily Costs:**  \n    - Flight: $0 (no flight on this day)\n    - Hotel: $33\n    - Attractions: $30\n    - Food: $45\n    - Total: $108\n\n### Day 8:  \n- 🌅 **Morning Activities:**  \n    - Breakfast at The Anvaya Beach Resort Bali\n    - Visit Penataran Agung Lempuyang Temple\n\n- 🍽 **Lunch:**  \n    - Enjoy a seafood lunch by the bay\n\n- 🎭 **Afternoon \u0026 Evening Plans:**  \n    - Visit Tirta Gangga\n    - Relax at a natural hot spring\n    - Farewell dinner at a beachfront restaurant\n\n- 🚖 **Transport:**  \n    - Private transfer to sights\n\n- 💰 **Approximate Daily Costs:**  \n    - Flight: $0 (no flight on this day)\n    - Hotel: $112\n    - Attractions: $20\n    - Food: $40\n    - Total: $172\n\n### Overall Trip Cost:  \n- Total Flight Cost: $1001\n- Total Hotel Cost: $460\n- Total Attractions Cost: $220\n- Total Food Cost: $265\n- **Grand Total: $1946 USD**\n\nThis itinerary provides a comprehensive plan for your trip to Bali, covering flights, hotels, attractions, and daily activities. Enjoy your vacation in Bali! 🌴🌞🍹\n\n---\n\n📌 *This report was generated automatically by AI Travel Assistant. Please verify details before booking.*\n    \n\n\n\n## 🚀 **Contributing**\nWe welcome contributions! Feel free to:\n- **Open Issues** for bug reports or feature requests.\n- **Submit Pull Requests** to improve the code.\n\n---\n\n## 📜 **License**\nThis project is licensed under the **MIT License**.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbala-ceg%2Fai-travelassistant","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbala-ceg%2Fai-travelassistant","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbala-ceg%2Fai-travelassistant/lists"}