Welcome to TravelABull, the cutting-edge open-source web application that revolutionizes the way you plan your travels. Developed for BayHacks 2024 in Tampa, FL, our application leverages the power of AI to create personalized travel itineraries. Whether you're exploring a bustling city, a serene countryside, or any region across the globe, TravelABull makes your journey planning seamless, fun, and uniquely tailored to your preferences.

• Destination Discovery: Input any city, region, district, country, state, or province to start planning your trip.
• Custom Date Range: Specify the exact dates of your travel to get a day-by-day itinerary that fits your schedule.
• Personalized Activities: From sightseeing to events, input your interests, and let TravelABull handle the rest.
• AI-Generated Itineraries: Powered by Google Gemini AI and integrated with Google Maps API, receive a detailed itinerary with morning, afternoon, and evening plans.
• Interactive Maps: Visualize your travel plans with detailed maps showing your daily destinations.
• Rating System: Rate your experiences and see community ratings for places and activities.
• User-Friendly Interface: Built with Angular and Angular Materials for a sleek, responsive experience.

TravelABull is built using a robust stack of modern technologies:

• Frontend: Angular, Angular Materials, TypeScript
• Backend: Flask, Python
• APIs: Google Gemini AI, Google Maps API

To get TravelABull up and running on your local machine, follow these steps:

Ensure you have the following installed:

• Node.js and npm
• Python 3.x

1. Clone the repository

   git clone https://github.com/yourgithub/travelabull.git
   cd travelabull
   

2. Install frontend dependencies

   cd frontend
   npm install (or i)
   

3. Run the Angular server

   ng serve
   

4. Install backend dependencies

   cd ../backend
   pip install -r  
   

5. Start the Flask server

   flask run
   

Your application should now be running on localhost:4200 for the Angular frontend and localhost:5000 for the Flask backend.

TravelABull is open source, and we welcome contributions! Whether it's submitting bug reports, feature requests, or code patches, your input is invaluable in making TravelABull even better.

This project is licensed under the MIT License - see the LICENSE.md file for details.

• BayHacks 2024 for the opportunity to showcase our project.
• Google APIs for enabling us to leverage their powerful mapping and AI technologies.

Happy Travelling with TravelABull!