AI Travel Agent

ntelligent travel planning assistant powered by AI that creates personalized travel plans using Apify and Google's Gemini model.

Overview

AI Travel Agent is an Apify actor that leverages AI to generate comprehensive travel plans based on user inputs. The agent searches for and recommends:

• Attractions and points of interest from TripAdvisor
• Accommodations from Airbnb and Booking.com
• Restaurants from Google Maps

The agent creates a complete travel plan with a day-by-day itinerary, accommodation options, restaurant recommendations, and detailed activity suggestions.

Features

• Personalized Travel Plans: Generate custom travel plans based on destination, dates, budget, and preferences
• Smart Recommendations: Find the best attractions, accommodations, and restaurants using real data from popular travel sites
• Comprehensive Itineraries: Get day-by-day schedules with specific activities, times, and locations
• Budget-Aware Planning: All recommendations respect your specified budget constraints

Input Parameters

• location (required): Destination for your travel plan (e.g., "Ponta Delgada, Azores")
• start_date: The start date of your trip in YYYY-MM-DD format
• end_date: The end date of your trip in YYYY-MM-DD format
• budget: Your total budget for the trip
• people: Number of people traveling (default: 2)
• notes: Any special requests or preferences for your trip

Example Input

{
  "location": "Ponta Delgada, Azores",
  "start_date": "2025-07-27",
  "end_date": "2025-08-03",
  "budget": 1000,
  "people": 2,
  "notes": "We love nature."
}

Output

The actor outputs a structured travel plan with:

• Destination details
• Accommodation options with names, addresses, and booking information
• Restaurant recommendations with cuisine types, price ranges, and ratings
• Day-by-day itinerary with activities, times, and locations

Architecture

The project uses the following components:

• Pydantic AI: Structured data modeling and AI agent framework
• Google Gemini: Advanced LLM for understanding requests and generating travel plans
• Apify SDK: Integration with Apify platform for web scraping and data processing
• External Actors: Utilizes specialized Apify actors for data collection from TripAdvisor, Airbnb, Booking.com, and Google Maps

Dependencies

• apify: Apify SDK for Python
• apify-client: Client for the Apify API
• python-dotenv: For loading environment variables
• pydantic: Data validation and modeling
• pydantic-ai: AI agent framework built on top of Pydantic

Development

Project Structure

ai-travel-agent/
├── .actor/                # Apify actor configuration
│   ├── actor.json         # Actor metadata
│   ├── Dockerfile         # Docker configuration
│   └── input_schema.json  # Input schema definition
├── src/                   # Source code
│   ├── __init__.py
│   ├── __main__.py        # Entry point
│   ├── main.py            # Main application logic
│   ├── models.py          # Data models
│   ├── prompts.py         # System prompts
│   └── tools.py           # Integration tools for external services
├── storage/               # Local storage
├── .env                   # Environment variables
├── .gitignore
├── README.md
└── requirements.txt       # Project dependencies

Adding New Functionality

To extend the agent with additional data sources:

1. Create a new tool function in tools.py
2. Add the tool to the agent configuration in main.py
3. Update the data models in models.py if necessary

License

This project is licensed under the MIT License