{"id":24802633,"url":"https://github.com/siddh-coder/travelgenie","last_synced_at":"2025-03-25T05:36:08.869Z","repository":{"id":258201931,"uuid":"873421274","full_name":"siddh-coder/travelGenie","owner":"siddh-coder","description":"This web-app gives you the perfect travel plan for your vacations. Just you need to enter your Start and End locations and dates of travelling. It will give you the perfect travel plan.","archived":false,"fork":false,"pushed_at":"2024-12-27T05:33:28.000Z","size":1965,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-30T05:15:49.457Z","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":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/siddh-coder.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":"2024-10-16T06:24:35.000Z","updated_at":"2024-12-27T05:33:31.000Z","dependencies_parsed_at":null,"dependency_job_id":"642e856f-395b-4a40-85d8-c8200d62eea7","html_url":"https://github.com/siddh-coder/travelGenie","commit_stats":null,"previous_names":["siddh-coder/travelgenie"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/siddh-coder%2FtravelGenie","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/siddh-coder%2FtravelGenie/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/siddh-coder%2FtravelGenie/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/siddh-coder%2FtravelGenie/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/siddh-coder","download_url":"https://codeload.github.com/siddh-coder/travelGenie/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245407758,"owners_count":20610232,"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-30T05:15:57.925Z","updated_at":"2025-03-25T05:36:08.850Z","avatar_url":"https://github.com/siddh-coder.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Travel Genie\n\nTravel Genie is a user-friendly travel planning application that helps users generate curated travel plans based on their starting location, destination, and travel preferences. With this app, you can create a personalized itinerary, estimate your travel budget, and explore exciting destinations effortlessly.\n\n---\n\n## Features\n\n- **Interactive UI**: Navigate through a sleek and intuitive interface.\n- **Dynamic Date Input**: Select start and end dates for your journey.\n- **Travel Class Options**: Choose between Economy, Business, or First-Class travel preferences.\n- **Google Gemini API Integration**: Generate travel plans using AI-powered recommendations.\n- **Currency Conversion**: Get budgets displayed in your starting location's currency and INR for comparison.\n- **CSV Integration**: Predefined locations are read from a `worldcities.csv` file for user convenience.\n- **Responsive Design**: Mobile-friendly and adaptable to different screen sizes.\n\n---\n\n## Getting Started\n\n### Prerequisites\n\n1. **Python 3.10+** is required to run the app.\n2. Install the required Python packages:\n   ```bash\n   pip install -r requirements.txt\n   ```\n3. **Streamlit** is used for the web interface:\n   ```bash\n   pip install streamlit\n   ```\n\n### Installation\n\n1. Clone the repository:\n   ```bash\n   git clone https://github.com/your-username/travel-genie.git\n   cd travel-genie\n   ```\n\n2. Install dependencies:\n   ```bash\n   pip install -r requirements.txt\n   ```\n\n3. Obtain a Google Gemini API Key from [Google AI Studio](https://aistudio.google.com/app/u/1/apikey?pli=1).\n\n4. Place your `worldcities.csv` file in the same directory as the app.\n\n---\n\n## Running the App\n\n1. Run the app using Streamlit:\n   ```bash\n   streamlit run travelGenie.py\n   ```\n\n2. Open your browser and navigate to `http://localhost:8501` to use the app.\n\n---\n\n## Usage\n\n1. Enter your **Google Gemini API Key** in the sidebar.\n2. Select your **Starting Location** and **Destination** from the dropdown.\n3. Choose your **Start Date** and **End Date** for the trip.\n4. Select your **Travel Class** (Economy, Business, First-Class).\n5. Click **Submit** to generate a travel plan with budget estimates.\n\n---\n\n## File Structure\n\n```\ntravel-genie/\n│\n├── travelGenie.py         # Main application file\n├── worldcities.csv        # CSV file containing location data\n├── requirements.txt       # Python dependencies\n├── README.md              # Documentation file\n└── env/                   # Virtual environment (optional)\n```\n\n---\n\n## Technologies Used\n\n- **Streamlit**: For building the web interface.\n- **Python**: Core programming language for the backend.\n- **Google Gemini API**: To generate AI-based travel recommendations.\n- **CSV**: For managing and reading predefined locations.\n\n---\n\n## Contributors\n\n- **Aditya Mittal**\n- **Srijan Gupta**\n- **Ridwan Umar**\n- **Siddharth Tripathi**\n\n---\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n---\n\n## Screenshots\n\n### Homepage\n![Homepage](https://cdn-icons-png.flaticon.com/512/6213/6213814.png)\n\n---\n\n## Feedback\n\nWe value your feedback! Feel free to open an issue or contribute to the project.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsiddh-coder%2Ftravelgenie","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsiddh-coder%2Ftravelgenie","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsiddh-coder%2Ftravelgenie/lists"}