🧠 TravelAround AI — Intelligent Group Travel Planning Platform

✈️ Plan Together. Decide Smarter. Travel Better.

An AI-powered platform that simplifies group travel planning — from idea to itinerary.

---

🌟 Why TravelAround AI?

Group travel planning is chaotic — different preferences, budgets, schedules, and endless WhatsApp messages 😵‍💫.

TravelAround AI fixes this.

It acts as a smart travel coordinator that listens to everyone, thinks intelligently, and delivers a plan that works for the whole group.

---

✨ Key Highlights

• 🤖 AI-generated itineraries tailored to group preferences
• 🧠 Smart conflict resolution when opinions clash
• 💰 Budget prediction & optimization using AI
• 👥 Group collaboration in one place
• 💬 AI travel assistant for instant help
• 🛡️ Admin validation & control for bookings

---

🎯 Real-World Problem

Planning a group trip usually means:

• Endless group chats
• Conflicting opinions
• Budget confusion
• Poor coordination

❌ Traditional Approach

Manual planning, spreadsheets, and guesswork.

✅ TravelAround AI Approach

AI-driven planning with clarity, collaboration, and confidence.

---

---

🤖 AI Features Explained

Feature	Description
🧠 Itinerary Generator	Builds day-wise travel plans using AI
⚖️ Conflict Resolver	Balances group preferences intelligently
💸 Budget Predictor	Estimates expenses & suggests optimizations
🗺️ Recommendation Engine	Suggests destinations & activities
💬 AI Chat Assistant	Answers travel-related questions

---

🚀 Quick Start

🔧 Prerequisites

• Node.js v18+
• MongoDB v6+
• npm / yarn
• OpenAI API Key (for AI features)

---

⚙️ Installation

# Clone repository
git clone https://github.com/vikash0064/TravelAround.Ai.git
cd TravelAround.Ai

# Backend setup
cd backend
npm install

# Frontend setup
cd ../frontend
npm install

---

▶️ Running the App

# Terminal 1: Start Backend
cd backend
npm run dev

# Terminal 2: Start Frontend
cd frontend
npm start

📍 Frontend: http://localhost:3000 📍 Backend: http://localhost:5000

---

🏗️ Project Architecture

TravelAround.Ai/
├── backend/        # Node.js + Express + MongoDB
├── frontend/       # React Application
├── docs/           # Documentation
├── ReportINT222.pdf
├── README.md
└── LICENSE

🧩 Functional Modules

👤 User Module

• Authentication & profile management
• Join or create travel groups

🧳 Trip Planning Module

• Destination selection
• AI itinerary generation
• Group voting & feedback

🧠 AI Module

• Preference analysis
• Budget intelligence
• Smart recommendations

🛡️ Admin Module

• Trip validation
• User & content moderation

---

🛠️ Tech Stack

Frontend

• React 18
• Context API
• CSS / Modular styling

Backend

• Node.js
• Express.js
• MongoDB + Mongoose

AI & Tools

• OpenAI API
• REST APIs
• JWT Authentication

---

🔐 Environment Variables

Create a .env file in the backend folder:

PORT=5000
MONGO_URI=your_mongodb_uri
OPENAI_API_KEY=your_openai_key
JWT_SECRET=your_secret

---

🧪 Testing

• Backend: Jest / Supertest (planned)
• Frontend: React Testing Library (planned)

---

🚀 Deployment

Supported platforms:

• Render (Full Stack)
• Vercel (Frontend)
• Railway / Cyclic (Backend)

📘 See docs/DEPLOYMENT.md for details.

---

📁 Project Report

📄 INT222 Project Report included:

• System architecture
• Use case diagrams
• AI logic explanation
• Results & screenshots

File: ReportINT222.pdf

---

🧠 Future Scope

• Real-time group chat
• Hotel & transport booking
• Map-based planning
• Multilingual AI assistant
• Mobile app version

---

🤝 Contributing

We welcome contributions!

1. Fork the repo
2. Create your feature branch
3. Commit changes
4. Open a Pull Request

---

👥 Team

• Vikash Kushwaha — Full Stack Developer

---

📄 License

This project is licensed under the MIT License.

---

⭐ If you find this project useful, don’t forget to star the repository!