Your Smart, Safe & Personalized Travel Assistant — Powered by AI
Features • Tech Stack • Getting Started • Contributing • Roadmap • License
TourEase is an open-source intelligent travel assistant designed to help tourists plan, explore, and experience destinations seamlessly. Whether you're a first-time traveler or a seasoned explorer, TourEase combines AI-powered trip planning, real-time safety data, language translation, and community-driven insights — all in one platform.
Our mission is to make travel personalized, safe, and immersive for everyone, everywhere.
- Generate custom travel itineraries based on destination, duration, budget, and interests
- Interactive map-based route visualization with smart destination sequencing
- Estimated travel times, entry fees, and nearby attractions included
- Real-time display of nearest hospitals, police stations, embassies, and authorities
- Live safety alerts (weather warnings, protests, local hazards)
- Emergency one-tap contact to authorities or support team
- Real-time voice translation between traveler's language and local language
- Voice-activated queries for recommendations and directions
- Offline mode with basic stored data
- Map integration showing hotels, hostels, and homestays
- Real-time prices, ratings, distance, and availability
- Advanced filtering by budget, amenities, and location
- Curated lists of local cafés, restaurants, and food stalls
- Hidden gems and small business recommendations
- Side activities: kayaking, cooking classes, trekking, and more
- Auto-generated daily planner with timings, transport routes, and breaks
- Fully customizable schedule management
- Round-the-clock chat and call support
- AI-powered trip logging for immediate assistance
- Optional real-time tracking (opt-in) for enhanced safety
- Digital record of important belongings and documents
- AI/human tour guide chat for FAQs and trip updates
- Report lost items, fraud, or unsafe areas
- Direct sharing with local help desk or authorities
- Leave reviews, post trip photos, and rate places
- Instagram-like community feed for sharing travel moments
- Discover authentic experiences from fellow travelers
- "SPLIT" system for group bill management
- Real-time expense summary with PDF/CSV export
- Storytelling blurbs and audio snippets about locations
- Historical background, legends, myths, and local customs
- Reserved taxi services and private driver options
- Public transport info integration (buses, metros)
- Real-time fare estimation and ride tracking
- Discover destinations based on music festivals, sports tournaments, cultural fairs
- Dynamic updates via event calendar API integration
- AI-powered recommendations for best visit times
- Weather-based and seasonal attraction suggestions
- Local celebration highlights (Diwali, Holi, Christmas markets)
| Layer | Technology |
|---|---|
| Frontend | React.js with Leaflet/Mapbox for maps, shadcn/ui for design |
| Backend | Node.js (Express.js), MongoDB |
| AI/ML | OpenAI API or HuggingFace models |
| Maps/Geolocation | OpenStreetMap / Mapbox / Leaflet |
| Voice Assistant | Web Speech API or Vosk (open-source) |
| Authentication | Firebase Auth or JWT |
| Community Features | MongoDB collections + React feed components |
| Event Data | Integration with global event APIs or local tourism boards |
- Node.js (v16 or higher)
- MongoDB (local or cloud instance)
- npm or yarn package manager
-
Clone the repository
git clone https://github.com/yourusername/tourease.git cd tourease
-
Install dependencies
=======
git clone https://github.com/yourusername/tourease.git cd tourease
-
Install dependencies
cd backend npm install
cd ../frontend npm install
-
Set up environment variables
Create
.envfiles in bothbackendandfrontenddirectories:Backend
.env:PORT=5000 MONGODB_URI=your_mongodb_connection_string JWT_SECRET=your_jwt_secret OPENAI_API_KEY=your_openai_api_key MAPBOX_ACCESS_TOKEN=your_mapbox_token
Frontend
.env:REACT_APP_API_URL=http://localhost:5000 REACT_APP_MAPBOX_TOKEN=your_mapbox_token
-
Run the application
cd backend npm start
cd frontend npm start
-
Access the application
Open your browser and navigate to
http://localhost:3000
We welcome contributions from developers, designers, and travel enthusiasts worldwide! Here's how you can help:
- Fork the repository
- Create a feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
- Follow the existing code style and conventions
- Write clear, descriptive commit messages
- Add tests for new features when applicable
- Update documentation as needed
- Be respectful and constructive in discussions
- 🎨 UI/UX design improvements
- 🌐 Multi-language support and translations
- 🧪 Testing and bug fixes
- 📝 Documentation and tutorials
- 🔌 API integrations (hotels, flights, events)
- 🤖 AI model optimization
- 📱 Mobile app development
Check out our Issues page to find tasks to work on!
- All our amazing contributors
- Open-source community for tools and libraries
- Travel enthusiasts who provide valuable feedback
Please follow SETUP.md to set up the project locally.
=======
Please read CODE_OF_CONDUCT.md for details on expected behavior and reporting guidelines.
Suhani
- GitHub: @Suhani1234-5
- Issues: GitHub Issues
- Discussions: GitHub Discussions
- Linkedin: Linkedin
Made with ❤️ by travelers, for travelers