Skip to content

vikash0064/TravelAround.Ai

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

28 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🧠 TravelAround AI — Intelligent Group Travel Planning Platform

TravelAround AI MERN Stack Node.js React AI Powered License

✈️ 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!

About

AI-powered group travel planning platform built with MERN stack that generates smart itineraries, manages group preferences, predicts budgets, and simplifies trip coordination.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors