| π Quick Start | π οΈ Tech Stack | π€ Contributing | π Installation Guide |
|---|
TourEase is an open-source intelligent travel assistant designed to help tourists plan, explore, and experience destinations seamlessly. Combining AI-powered trip planning, real-time safety data, and community-driven insights.
Weβve packed TourEase with features to make travel personalized and safe.
π― Dynamic Itinerary Adjustment (NEW!) (Click to expand)
- Real-Time Event Detection: Automatically discovers festivals, concerts, and cultural events during your trip.
- Weather Monitoring: 5-day forecasts with smart suggestions for bad weather days.
- Disruption Alerts: Proactive notifications for closures, strikes, or travel disruptions.
- AI-Powered Suggestions: Intelligent recommendations to enhance your itinerary.
- Full User Control: Accept, reject, or modify all suggestions with clear reasoning.
- Event-Enhanced Days: Visual indicators for days with special events.
π€ AI & Smart Planning (Click to expand)
- AI Travel Planner: Custom itineraries based on budget and interests.
- AI Voice Assistant: Real-time translation and voice-activated queries.
- Seasonal Mapping: AI recommendations for the best times to visit.
- Event-Aware: Integration with global event APIs for festivals and sports.
π‘οΈ Safety & Support (Click to expand)
- Local Safety: Real-time location of nearest hospitals, police, and embassies.
- Emergency System: One-tap contact to authorities and live safety alerts.
- 24/7 Support: AI-powered trip logging and optional real-time tracking.
- Issue Reporting: Report fraud, lost items, or unsafe areas directly.
π Travel Tools & Community (Click to expand)
- Smart Finder: Map integration for hotels, hostels, and hidden gems.
- Travel Locker: Digital record of documents and belongings.
- Split & Expense: Group bill management with PDF/CSV export.
- Community Feed: Instagram-like feed for reviews and travel moments.
Displays featured destinations, search functionality, and navigation menu.
Shows available travel destinations with filtering options.
Search and filter destinations by category like Budget, Luxury, Beach, Mountains, etc.
Users can save and manage their favorite destinations.
Provides detailed information about selected destination including pricing and description.
Allows users to enter booking details and confirm reservations.
Users can send queries or feedback through contact form.
TourEase is fully responsive and works seamlessly across devices.
To get the project running in under 2 minutes:
- Clone the Repo
git clone [https://github.com/Suhani1234-5/TourEase.git](https://github.com/Suhani1234-5/TourEase.git) cd TourEase - Install & Run
Note
For the full environment variable setup and detailed configuration, please see the Detailed Installation Guide.
- Terminal 1: Backend
cd backend
npm install
npm start- Terminal 2: Frontend
cd frontend
npm install
npm start
- Access the App: Once both servers are running, open your browser and navigate to:
http://localhost:3000
Joining us for SWOC'26? We love PRs! π
- Please read our Contributing Guidelines to get started.
- Check out the Project Roadmap in our issues for open tasks.
Suhani β @Suhani1234-5
- π’ Questions? Open a GitHub Discussion
- πΌ Connect: LinkedIn
Thanks to all the amazing people who have contributed to TourEase !π
Made with β€οΈ by travelers, for travelers








