🧠 AI Travel Planner (Laravel + Neuron)

An AI-powered conversational travel planner built with Laravel 11 and Neuron AI.
The application guides users through a chat-style interface to collect trip details and generates a complete travel guide using a multi-agent AI architecture.

This project is designed as a learning-focused, architecture-first implementation, not a clone of any demo.

---

✨ Features

• 💬 Chat-style conversational UI (Bootstrap + Blade)
• 🤖 Multi-agent AI architecture
  • Planner Agent (data extraction)
  • Writer Agent (human-friendly travel guide)
• 🧩 Coordinator pattern for agent orchestration
• 🌐 OpenRouter integration (OpenAI-compatible provider)
• 📄 Markdown-rendered AI responses
• 🧠 Session-based conversation state machine
• 🧼 Clean separation of UI, logic, and AI layers

---

🏗️ Architecture Overview

🏗️ Architecture Overview

The application follows a clean, layered architecture where the UI is completely decoupled from AI logic.

Flow

1. Browser (Chat UI)

   • User interacts through a chat-style interface built with Bootstrap.

2. Laravel Controller

   • Manages conversation state.
   • Collects user inputs (from city, destination, days, budget).

3. TravelCoordinator

   • Acts as the orchestration layer.
   • Controls which AI agent runs and in what order.

4. AI Agents (Neuron)

   • TravelPlannerAgent
     • Extracts structured travel data (flights, trains, hotels, attractions).
   • TravelWriterAgent
     • Converts raw data into a readable, user-friendly travel guide.

The UI layer never communicates directly with AI agents, making the system modular, testable, and easy to extend.

The UI has no direct knowledge of AI agents, making the system clean, testable, and extensible.

---

🛠️ Tech Stack

• Laravel 11
• Neuron AI (PHP)
• OpenRouter (OpenAI-compatible provider)
• Bootstrap 5
• Blade Templates
• League CommonMark (Markdown rendering)

---

🚀 How It Works

1. User interacts via a chat interface
2. System asks:
   • From city
   • Destination
   • Number of days
   • Budget level
3. Planner Agent extracts structured travel data (flights, trains, hotels, attractions)
4. Writer Agent converts raw data into a clean, readable travel guide
5. Final result is rendered in chat using Markdown formatting

---

📸 Screenshots

Chat Conversation Flow

Generated Travel Plan

---

🧪 Local Setup

git clone https://github.com/YOUR_USERNAME/ai-travel-planner.git
cd ai-travel-planner

composer install
cp .env.example .env
php artisan key:generate