Roameo is an advanced AI-powered travel planning web application that leverages multiple LLM providers (Google Gemini & Groq) to create personalized, optimized travel itineraries. Built with React, Supabase, and modern web technologies, it features smart budgeting, real driving time estimation via OSRM, overnight travel detection, interactive maps, real-time AI chat, and a comprehensive booking system.
🌐 Live Demo: https://roameo-rz80.onrender.com
- AI-Powered Itinerary Generation — Create detailed day-by-day schedules tailored to your destination, duration, and preferences
- Multi-LLM Support — Powered by Google Gemini and Groq (Llama 3, Mixtral) for fast, intelligent responses
- Real Driving Times (OSRM) — Actual road-based travel duration via Open Source Routing Machine, with localStorage caching and auto-geocoding
- Overnight Travel Detection — Budget/mid-tier routes 6–16h automatically detected as overnight bus/train, eliminating unnecessary travel days
- Per-Person Budget Planning — Budget-aware trip plans showing per-person/day costs, with solo vs group activity generation
- Smart Budget Allocation — Category-wise breakdown (transport, accommodation, activities) with per-person derived values
- Interactive Maps — Real-time route visualization with Leaflet, walking/driving directions via OpenRouteService
- AI Travel Companion — Real-time chat with an AI assistant for travel tips, cultural insights, and recommendations
- Destination Discovery — Explore curated destinations with detailed info, weather, and local highlights
- Hotel & Flight Booking — Integrated booking system with search, comparison, and management
- PDF Export — Download beautifully formatted itineraries as PDF documents
- Dark/Light Mode — Fully themed UI with smooth transitions
- Authentication — Secure auth via Supabase (Email/Password + Google OAuth)
- Responsive Design — Optimized for desktop, tablet, and mobile screens
Roameo follows a modern client-side architecture with a Supabase backend and AI orchestration layer:
graph TD
A[User] --> B[React Frontend]
B --> C[Supabase Auth]
B --> D[Supabase Database]
B --> E[AI Engine]
E --> F[Google Gemini API]
E --> G[Groq API]
B --> H[Map Services]
H --> I[OpenRouteService]
H --> J[Leaflet / OSM]
B --> K[Booking Engine]
subgraph Backend
C
D
end
subgraph AI Providers
F
G
end
subgraph Maps
I
J
end
style A fill:#f9f,stroke:#333
style B fill:#61dafb,stroke:#333
style D fill:#3ECF8E,stroke:#333
style E fill:#ff6b6b,stroke:#333
-
Planning Engine (
engine/)- Trip Orchestrator — Coordinates all planning phases: timeline, budget, transport, and AI generation
- Trip Duration Planner — Feasibility check using OSRM real driving times with overnight travel detection
- Travel Timeline Builder — Creates structural TRAVEL/EXPLORE day segments with overnight arrival metadata
- Budget Allocator — Envelope-based allocation with per-person derived values for UI and LLM
- Route Time API (
api/routeTime.js) — OSRM wrapper with Nominatim geocoding fallback and 30-day localStorage cache
-
AI Engine (
services/ai/)- Multi-provider LLM orchestration (Gemini + Groq)
- Prompt engineering with solo/group traveler rules and per-person budget constraints
- Structured JSON parsing of AI responses
- Fallback logic between providers
-
Itinerary Generator (
store/itineraryStore.js)- Creates optimized daily schedules with time slots
- Handles multi-day trip planning
- Activity management (add, edit, delete, reorder)
-
Budget Manager (
store/budgetStore.js)- Real-time expense tracking per trip (per-person view)
- Category-wise breakdown (food, transport, accommodation, activities)
- Multi-currency support with conversion
- AI-powered budget analysis and recommendations
-
Booking System (
store/bookingStore.js)- Hotel and flight search integration
- Booking management and status tracking
- Scoring algorithm for optimal recommendations
-
Transport Engine (
utils/transportEngine.js)- Distance-tier estimation with smart transport mode selection
- Overnight bus/train detection for budget-tier long routes
- Envelope-aware cost calculation with downgrade ladder
-
Map & Route Engine (
components/map/)- Interactive Leaflet maps with custom markers
- Route visualization via OpenRouteService
- Walking/driving/cycling directions
- Activity highlight and focus controls
-
AI Companion (
components/companion/)- Context-aware travel chat assistant
- Cultural tips, safety alerts, local recommendations
- Conversation history management
- Multi-Agent AI System — Specialized prompts for planning, budgeting, and recommendations
- Natural Language Understanding — Parse complex travel requests and preferences
- Destination Research — Discover hidden gems and popular attractions
- Smart Itinerary Generation — Create realistic, well-paced daily schedules
- Budget-Aware Planning — Plans optimized for Low, Mid, High, or Luxury budgets
- Real-time Map Integration — Visualize routes with turn-by-turn directions
- Drag & Drop — Reorder activities within your itinerary
- Safety Alerts — AI-driven warnings for potentially dangerous activities or locations
- Web Share — Share generated itineraries with friends and family
- PDF Export — Download itineraries as beautifully formatted PDF documents
| Provider | Models | Use Case |
|---|---|---|
| Google Gemini | Gemini 1.5 Flash, Gemini Pro | Primary itinerary generation |
| Groq | Llama 3 70B, Mixtral 8x7B | Fast inference, fallback provider |
User Input → AI Engine → Structured Itinerary → Map Rendering
↓ ↓
Budget Analysis Supabase Storage
↓ ↓
Recommendations Trip Management
- Node.js 18+
- npm (Node Package Manager)
- A Supabase project (free tier works)
- API keys for Google Gemini and/or Groq
-
Clone the repository:
git clone https://github.com/K007-K/AI-Travel-Assistant.git cd AI-Travel-Assistant -
Install dependencies:
cd frontend npm install -
Set up environment variables: Create a
.envfile in thefrontend/directory:# Supabase VITE_SUPABASE_URL=your_supabase_project_url VITE_SUPABASE_ANON_KEY=your_supabase_anon_key # AI Providers VITE_GEMINI_API_KEY=your_gemini_api_key VITE_GROQ_API_KEY=your_groq_api_key # Maps VITE_ORS_API_KEY=your_openrouteservice_api_key # App Config VITE_APP_NAME=Roameo VITE_APP_VERSION=1.0.0 VITE_TRANSLATION_API_URL=https://libretranslate.de
-
Set up Supabase:
- Create a new project at supabase.com
- Run the SQL migrations in
backend/supabase/migrations/via the SQL Editor - Enable Google OAuth (optional) under Authentication → Providers
-
Start the development server:
npm run dev
The app will be available at
http://localhost:5173
| Variable | Required | Description |
|---|---|---|
VITE_SUPABASE_URL |
✅ | Supabase project URL |
VITE_SUPABASE_ANON_KEY |
✅ | Supabase anonymous key |
VITE_GEMINI_API_KEY |
✅ | Google Gemini API key |
VITE_GROQ_API_KEY |
⚡ | Groq API key (fallback AI provider) |
VITE_ORS_API_KEY |
⚡ | OpenRouteService key (for map routes) |
VITE_TRANSLATION_API_URL |
❌ | LibreTranslate endpoint |
VITE_APP_NAME |
❌ | App display name (default: Roameo) |
The following tables are required (migrations in
backend/supabase/migrations/):
profiles— User profiles and preferencestrips— Trip data with itinerariesbookings— Hotel/flight booking recordscost_events— Budget tracking entries
| Category | Technology |
|---|---|
| Frontend | React 18, Vite 5, Tailwind CSS 3 |
| State Management | Zustand |
| Backend / Auth | Supabase (PostgreSQL, Auth, RLS) |
| AI / LLM | Google Gemini API, Groq SDK |
| Maps | Leaflet, React-Leaflet, OpenRouteService |
| Animations | Framer Motion |
| Icons | Lucide React |
| PDF Export | jsPDF |
| Deployment | Docker, Nginx, Render |
AI-Travel-Assistant/
├── frontend/ # React client application
│ ├── src/
│ │ ├── api/ # External API wrappers
│ │ │ ├── routeTime.js # OSRM driving times + geocoding + cache
│ │ │ ├── geocode.js # Geocoding API
│ │ │ ├── places.js # Places/destinations API
│ │ │ └── weather.js # Weather data API
│ │ ├── engine/ # Core planning engine
│ │ │ ├── tripOrchestrator.js # Main orchestration pipeline
│ │ │ ├── tripDurationPlanner.js # Feasibility + overnight detection
│ │ │ ├── travelTimelineBuilder.js # TRAVEL/EXPLORE day segmentation
│ │ │ ├── budgetAllocator.js # Envelope-based budget allocation
│ │ │ └── feasibilityGuard.js # Input validation
│ │ ├── components/
│ │ │ ├── ai/ # AI chat components
│ │ │ ├── companion/ # AI travel companion
│ │ │ ├── features/ # Feature-specific components
│ │ │ ├── home/ # Landing page & dashboard
│ │ │ ├── layout/ # Navbar, footer, protected routes
│ │ │ ├── map/ # Map, markers, route layers
│ │ │ └── ui/ # Reusable UI components
│ │ ├── hooks/ # Custom React hooks
│ │ ├── lib/ # Supabase client setup
│ │ ├── pages/ # Route-level page components
│ │ ├── services/
│ │ │ └── ai/ # AI service layer (Gemini, Groq)
│ │ ├── store/ # Zustand state stores
│ │ ├── utils/ # Utility functions
│ │ │ └── transportEngine.js # Distance + transport mode + overnight
│ │ └── App.jsx # Root component & routing
│ ├── tests/ # Vitest unit tests (160+ tests)
│ ├── public/ # Static assets
│ ├── Dockerfile # Multi-stage Docker build
│ ├── nginx.conf.template # Nginx SPA configuration
│ └── package.json # Dependencies & scripts
├── backend/
│ └── supabase/
│ ├── functions/ # Edge functions
│ │ └── itinerary-generator/ # LLM prompt engineering
│ └── migrations/ # SQL migration files
├── render.yaml # Render deployment config
├── docker-compose.yml # Local container orchestration
└── README.md # This file
cd frontend
npm install
npm run devdocker-compose up --buildAccess the app at http://localhost:3000
The app is deployed on Render using Docker:
- Connect your GitHub repository to Render
- Set the environment variables in the Render dashboard
- Deploy — Render will build the Docker image and serve via Nginx
Live URL: https://roameo-rz80.onrender.com
cd frontend && npx vitest run # 160+ tests across 10 filesTo explore the app without signing up:
Email: demo@roameo.com
Password: demo1234
- Create a Trip — Go to My Trips → Create Vizag → Tirupati, 1 day, budget, 2 people
- Duration Check — Observe overnight travel detection (0 travel days for 9.4h route)
- Generate Itinerary — AI generates group activities with per-person costs
- Budget Planning — Set per-person budget, see group total in financial summary
- Discover — Browse curated destinations on the Discover page
- AI Chat — Ask the AI companion for travel recommendations
- Bookings — Search and compare hotels for your destination
We welcome contributions! Here's how you can help:
- 🍴 Fork the repository
- 🌿 Create a feature branch (
git checkout -b feature/amazing-feature) - 💾 Commit your changes (
git commit -m 'Add some amazing feature') - 🔄 Push to the branch (
git push origin feature/amazing-feature) - ✨ Open a Pull Request
git clone https://github.com/K007-K/AI-Travel-Assistant.git
cd AI-Travel-Assistant/frontend
npm install
npm run devThis project is licensed under the MIT License - see the LICENSE file for details.
- React — UI framework
- Supabase — Backend, auth, and database
- Google Gemini — Primary AI provider
- Groq — High-performance LLM inference
- Leaflet — Interactive maps
- OpenRouteService — Routing and directions
- Tailwind CSS — Utility-first CSS
- Framer Motion — Animations
- Render — Cloud deployment
Made with ❤️ by K Karthik