Skip to content

sblrm/travelease

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

15 Commits
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐ŸŒŸ TravelEase - AI Travel Management System

An intelligent travel management platform combining Laravel 11 with AI-powered assistance

TravelEase Banner

PHP Laravel Python Flask Google AI


๐ŸŽฏ Project Overview

TravelEase adalah sistem manajemen perjalanan berbasis AI yang menggabungkan teknologi web modern dengan kecerdasan buatan untuk memberikan pengalaman travel planning yang seamless dan personal.

๐Ÿ—๏ธ Architecture Highlights

graph TB
    A[๐ŸŒ Laravel Frontend] --> B[๐Ÿ“ก HTTP API]
    B --> C[๐Ÿ Flask Backend]
    C --> D[๐Ÿค– Google Gemini AI]
    C --> E[๐Ÿ“Š Travel Dataset]
    A --> F[๐Ÿ—บ๏ธ Maps Integration]
    A --> G[๐Ÿ’พ SQLite Database]
Loading

๐Ÿ“ Project Structure

  • Maps/: Aplikasi web Laravel 11 (frontend dan API)
  • TravelEase/: Backend Python dengan Flask API dan integrasi Gemini AI

โœจ Key Features

๐ŸŽซ Travel Management

  • Interactive travel package booking
  • Route planning & navigation
  • Cost estimation tools
  • Travel history tracking

๐Ÿค– AI-Powered Assistant

  • Natural language travel queries
  • Personalized recommendations
  • Indonesian language support
  • Context-aware responses

Travel Features

๐Ÿ“ฑ Additional Features

  • ๐Ÿ—บ๏ธ Travel location management
  • ๐Ÿค– AI-powered travel assistant (Gemini)
  • ๐Ÿ“ฑ Responsive mobile design
  • ๐ŸŽซ Travel package booking
  • ๐Ÿ“ Location-based services

๐Ÿž๏ธ Featured Destinations

๐Ÿ›๏ธ Yogyakarta ๐Ÿ๏ธ Bali ๐ŸŒ‹ Lombok ๐Ÿ‰ Labuan Bajo
Yogyakarta Bali Lombok Labuan Bajo
Historic Cultural Hub Tropical Paradise Adventure Island Dragon Island Gateway

๐Ÿ—บ๏ธ Premium Travel Packages

Travel Packages

Available Routes:

  • ๐ŸšŒ Jakarta โ†” Yogyakarta (3D2N) - from Rp 850K
  • โœˆ๏ธ Jakarta โ†” Bali (4D3N) - from Rp 1.8M
  • ๐Ÿ”๏ธ Bali โ†” Lombok (3D2N) - from Rp 1.2M
  • ๐ŸŒŠ Lombok โ†” Labuan Bajo (5D4N) - from Rp 2.5M

๐Ÿ› ๏ธ Tech Stack

Frontend & Backend

Laravel PHP Blade Vite

AI & Data Processing

Python Flask Google AI

Database & Tools

SQLite Composer Jupyter


๐Ÿš€ Quick Start

Prerequisites

  • PHP 8.2+
  • Python 3.11+
  • Composer
  • XAMPP atau web server lainnya

Installation

๐Ÿ”ง Setup Instructions

1. Laravel Setup (Maps/)

cd Maps
composer install
cp .env.example .env
php artisan key:generate
php artisan migrate
php artisan serve

2. Python Setup (TravelEase/)

cd TravelEase
# Install dependencies via Jupyter notebook atau manual:
pip install transformers torch PyPDF2 pandas datasets google-generativeai requests flask python-dotenv

3. Environment Configuration

PowerShell (temporary):

$env:GEMINI_API_KEY = "your-api-key-here"

Atau buat file .env di TravelEase/:

GEMINI_API_KEY=your-api-key-here
GEMINI_MODEL=gemini-2.5-pro

4. Running the Application

  1. Start Laravel (terminal 1):
cd Maps
php artisan serve
  1. Start Python Flask API (terminal 2):
cd TravelEase
python TravelAPI.py
  1. Access: http://127.0.0.1:8000

API Integration

Laravel berkomunikasi dengan Flask server via HTTP:

  • Flask Endpoint: http://127.0.0.1:5000/chat
  • Method: POST
  • Data: JSON dengan field query

Security Notes

  • JANGAN commit file .env ke Git
  • API keys disimpan di environment variables
  • Database menggunakan SQLite untuk development

๐ŸŽจ User Interface Showcase

๐Ÿ’ฌ AI Chatbot Interface

Chatbot

๐Ÿ—บ๏ธ Route Planning

Route Planning

๐Ÿ“Š Travel Dashboard

Dashboard


๐Ÿค– AI Integration

Intelligent Travel Assistant

# TravelEase/TravelGPT.py - Core AI Logic
class ChatGenerator:
    def __init__(self, gemini_api_key: str):
        genai.configure(api_key=gemini_api_key)
        self.model = genai.GenerativeModel(
            "gemini-2.5-pro",
            system_instruction="Travel assistant with Indonesian language support"
        )

AI Features:

  • ๐Ÿง  Context-aware responses using travel dataset
  • ๐Ÿ‡ฎ๐Ÿ‡ฉ Native Indonesian language processing
  • ๐Ÿ’ฌ Natural conversation flow
  • โšก Real-time query processing

Why This Project?

๐Ÿ’ก Innovation Highlights

๐Ÿ”„ Dual-Stack Architecture

Seamless integration between Laravel web framework and Python AI backend

๐Ÿค– AI-First Approach

Context-aware travel assistant using Google's latest Gemini AI

๐Ÿ‡ฎ๐Ÿ‡ฉ Localized Experience

Full Indonesian language support with cultural context

๐Ÿ“Š Project Metrics

  • ๐Ÿ—๏ธ Architecture: Dual-stack (Laravel + Python)
  • ๐ŸŒ Routes: 12+ web routes with Indonesian naming
  • ๐ŸŽจ Views: 15+ Blade templates with inline styling
  • ๐Ÿค– AI Integration: Google Gemini 2.5 Pro
  • ๐Ÿ“ฆ Travel Packages: 5+ destination combinations

๐Ÿš€ Future Roadmap

  • ๐Ÿ“ฑ Mobile App Development (Flutter/React Native)
  • ๐Ÿ’ณ Payment Gateway Integration
  • ๐Ÿ“ Real-time Location Tracking
  • ๐Ÿ”” Push Notifications
  • ๐Ÿ“ˆ Analytics Dashboard
  • ๐ŸŒ Multi-language Support

๐Ÿ‘จโ€๐Ÿ’ป About Developer

Sabilillah Ramaniya Widodo (@sblrm)

Cloud & Cyber Enthusiast

GitHub Email LinkedIn

๐ŸŒŸ Star this repository if you found it interesting!

Built with โค๏ธ by Sabilillah Ramaniya Widodo

Combining passion for travel with cutting-edge technology

Profile Views


๐Ÿ“„ License

All rights reserved by Sabilillah Ramaniya Widodo.

About

Platform digital yang memudahkan pengguna dalam merencanakan dan memesan perjalanan.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors