User Request
    |
[AI] Travel Planning Manager --- parses request into structured params
    |
[API] 4 services fetch in parallel (no AI, pure HTTP)
    |--- Flights: Amadeus + SerpApi (fallback)
    |--- Accommodation: Booking.com + Airbnb
    |--- Activities: Google Places + Viator + Yelp
    |--- Logistics: Google Maps + OpenWeatherMap + Currency + Country Info
    |
[AI] Travel Knowledge Expert --- RAG for cultural/visa/practical info
    |
[AI] Itinerary Compiler --- synthesizes ALL real data into day-by-day plan
    |
Final Itinerary (with real prices, real hotels, booking links)

# Clone the project
cd "Multi Agent AI Travel Agent"

# Create and activate virtual environment
python -m venv venv
source venv/bin/activate  # macOS/Linux
# or: venv\Scripts\activate  # Windows

# Install dependencies
pip install -r requirements.txt

# Set up environment
cp .env.example .env
# Edit .env and add your API keys

uvicorn backend.app:app --host 0.0.0.0 --port 8000 --reload --reload-exclude "venv/*" --reload-exclude "data/*"

cd frontend
npm install
npm run dev

python main.py

backend/
├── app.py                          # FastAPI entry point
├── config/
│   └── settings.py                 # All API keys & service URLs
├── api/
│   ├── routes.py                   # REST endpoints
│   └── websocket.py                # WebSocket + progress updates
├── services/                       # Pure API calls, NO AI
│   ├── flights/
│   │   ├── amadeus.py              # Amadeus API (primary)
│   │   ├── serpapi.py              # SerpApi Google Flights (fallback)
│   │   └── service.py              # FlightService coordinator
│   ├── accommodation/
│   │   ├── booking.py              # Booking.com via RapidAPI
│   │   ├── airbnb.py              # Airbnb via RapidAPI
│   │   └── service.py             # AccommodationService coordinator
│   ├── activities/
│   │   ├── google_places.py        # Attractions & restaurants
│   │   ├── viator.py              # Bookable tours
│   │   ├── yelp.py                # Dining recommendations
│   │   └── service.py             # ActivityService coordinator
│   ├── logistics/
│   │   ├── google_maps.py         # Directions & routes
│   │   ├── weather.py             # OpenWeatherMap
│   │   ├── currency.py            # Exchange rates
│   │   ├── country_info.py        # REST Countries + Travelbriefing
│   │   └── service.py             # LogisticsService coordinator
│   └── knowledge/
│       └── rag.py                 # ChromaDB RAG
├── agents/                         # Only 3 AI agents
│   ├── llm.py                     # Gemini LLM factory
│   ├── definitions.py             # Travel Manager, Knowledge Expert, Compiler
│   ├── tasks.py                   # Task definitions
│   └── tools.py                   # CrewAI tool wrapper (RAG only)
├── crew/
│   └── orchestrator.py            # Main pipeline
├── models/
│   └── schemas.py                 # Normalized Pydantic models
frontend/                           # React + Vite UI
data/
├── travel_knowledge/              # RAG documents (.txt)
└── chroma_db/                     # Vector store (auto-generated)
main.py                             # CLI entry point