{"id":24798799,"url":"https://github.com/403errors/tour_planning_assistant","last_synced_at":"2025-03-24T22:41:51.592Z","repository":{"id":269587540,"uuid":"895967267","full_name":"403errors/tour_planning_assistant","owner":"403errors","description":"One-day tour planning assistant for city exploration with personalized itinerary suggestions.","archived":false,"fork":false,"pushed_at":"2025-01-06T07:07:53.000Z","size":149,"stargazers_count":0,"open_issues_count":2,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-30T02:15:15.635Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/403errors.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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":"2024-11-29T09:28:19.000Z","updated_at":"2025-01-06T07:07:57.000Z","dependencies_parsed_at":null,"dependency_job_id":"8eff60c9-b3d7-43b0-87ea-94c05ca9044e","html_url":"https://github.com/403errors/tour_planning_assistant","commit_stats":null,"previous_names":["403errors/tour_planning_assistant"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/403errors%2Ftour_planning_assistant","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/403errors%2Ftour_planning_assistant/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/403errors%2Ftour_planning_assistant/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/403errors%2Ftour_planning_assistant/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/403errors","download_url":"https://codeload.github.com/403errors/tour_planning_assistant/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245366200,"owners_count":20603438,"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":[],"created_at":"2025-01-30T02:15:17.605Z","updated_at":"2025-03-24T22:41:51.564Z","avatar_url":"https://github.com/403errors.png","language":"Python","readme":"# AI Tour Planner\nWelcome to the Tour Planning Assistant, a project designed to simplify one-day tour planning. This assistant integrates multiple intelligent agents to generate and optimize personalized travel itineraries based on user preferences, weather conditions, and geographical data.\n\n![home screen image](images/home_screen.png)\n\n## Features\n* Personalized Itinerary Generation: Tailors one-day travel plans based on user preferences and constraints.\n* Interactive Map Integration: Generates maps and directions using Google Maps API.\n* Weather Awareness: Incorporates weather forecasts to suggest suitable activities and timings.\n* Dynamic Optimization: Optimizes itineraries for time and travel efficiency using location data.\n* Seamless User Interaction: Gathers and manages user preferences interactively for a smooth experience.\n\n## Installation\n\n### Prerequisites\n\n* Python 3.8 or higher\n* Docker (optional, for containerized deployment)\n\n\n### Clone the Repository\n\n```\ngit clone https://github.com/403errors/tour_planning_assistant.git\ncd tour_planning_assistant\n```\n\n### Set Up Environment Variables\n\nCreate a .env file and define your API keys like this:\n\n```\nMAPS_API_KEY=\u003cYour Google Maps API Key\u003e\nOPENWEATHER_API_KEY=\u003cYour OpenWeather API Key\u003e\n```\n\n### Install Dependencies\n\nInstall the required Python packages:\n\n```\npip install -r requirements.txt\n```\n\n## Usage\n\nRunning Locally\n\n```\nstreamlit run app.py\n```\n\n\n## Containerized Deployment\n1.\tBuild the Docker image:\n\n```\ndocker build -t tour_planning_assistant\n```\n\n\n2.\tRun the container:\n\n```\ndocker run -p 5000:5000 --env-file .env tour_planning_assistant\n```\n\n## How It Works\n1. User Interaction\n- Users provide preferences (e.g., locations, interests) via the UserInteractionAgent.\n2. Weather Analysis\n- The WeatherAgent fetches weather data to enhance activity recommendations. \n3. Itinerary Generation\n- The ItineraryAgent integrates input from other agents (e.g., weather, maps) to create a draft itinerary.\n4. Optimization\n- The OptimizationAgent refines the plan, minimizing travel time and maximizing convenience.\n5. Visualization\n- The MapAgent generates interactive maps for easy navigation.\n\n## Future Enhancements\n* Complete implementation of MemoryAgent and Neo4jAgent.\n* Add support for multi-day trips.\n* Include recommendation systems for restaurants and attractions.\n* Enhance UI/UX for a more interactive experience.\n\n## Contributing\n\nContributions are welcome! Feel free to fork this repository, make improvements, and submit a pull request. For major changes, open an issue first to discuss your ideas.\n\n## License\n\nThis project is licensed under the MIT License.\n\n## Contact\n\nFor any inquiries or support, please contact:\n\u003e Email: pieisnot22by7@gmail.com\n\n\u003e GitHub: 403errors\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F403errors%2Ftour_planning_assistant","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F403errors%2Ftour_planning_assistant","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F403errors%2Ftour_planning_assistant/lists"}