Overview
The AI Travel Agent is a Streamlit-based application that automates the process of researching, planning, and organizing personalized travel itineraries. Using OpenAI’s GPT-4o and the Agno framework, it creates intelligent travel plans complete with activities, accommodations, and calendar integration.Features
Multi-Agent Architecture
- Researcher Agent: Generates search terms and finds relevant activities and accommodations using SerpAPI
- Planner Agent: Creates personalized itineraries based on research results and user preferences
Smart Itinerary Generation
- Customizable duration (1-30 days)
- Personalized recommendations for activities, dining, and accommodations
- Detailed day-by-day planning
Calendar Integration
- Export itineraries as .ics calendar files
- Compatible with Google Calendar, Apple Calendar, Outlook
- Each day appears as an all-day event with full details
Flexible Deployment
- Cloud version with OpenAI GPT-4o
- Local version with Ollama for privacy
- Web-based interface with Streamlit
How It Works
Research Phase
The Researcher agent generates search terms and queries SerpAPI for:
- Popular activities and attractions
- Accommodation options
- Dining recommendations
- Local experiences
Planning Phase
The Planner agent synthesizes research into a comprehensive itinerary:
- Day-by-day activity schedules
- Restaurant suggestions
- Accommodation recommendations
- Practical travel tips
Setup
Install Dependencies
streamlit- Web interfaceagno>=2.2.10- Agent frameworkopenai- OpenAI API integrationgoogle-search-results- SerpAPI for web searchicalendar- Calendar file generation
Get API Keys
OpenAI API Key:
- Sign up at OpenAI Platform
- Generate an API key from your dashboard
- Sign up at SerpAPI
- Get your API key for web search functionality
Usage
Generating an Itinerary
- Enter API Keys: Input your OpenAI and SerpAPI keys in the sidebar
- Specify Destination: Enter where you want to travel
- Set Duration: Choose the number of days (1-30)
- Generate: Click “Generate Itinerary” to start the planning process
- Download: Export your itinerary as a calendar file
Calendar Integration
After generating your itinerary:Import
Open the .ics file with your calendar application:
- Google Calendar: Import from Settings
- Apple Calendar: Double-click to import
- Outlook: File > Import
Code Example
Here’s the core agent configuration:Calendar File Generation
The app includes a sophisticated calendar generation system:Local vs Cloud Version
- Cloud (OpenAI)
- Local (Ollama)
File:
travel_agent.pyPros:- High-quality itineraries with GPT-4o
- Best performance and accuracy
- No local setup required
- Requires OpenAI API key (paid)
- Sends data to external APIs
Use Cases
Weekend Getaways
Weekend Getaways
Perfect for planning short 2-3 day trips with detailed hour-by-hour schedules
International Vacations
International Vacations
Generate comprehensive multi-week itineraries with cultural experiences and must-see attractions
Business Travel
Business Travel
Combine meetings with leisure activities and local dining recommendations
Group Travel
Group Travel
Plan activities suitable for families, friends, or corporate groups
Tips for Best Results
Calendar Sync: After importing to your calendar, the itinerary is available offline on all synced devices, perfect for international travel without data.
Troubleshooting
SerpAPI Rate Limits
SerpAPI Rate Limits
Free SerpAPI accounts have limited searches. Consider upgrading or spacing out requests if you hit limits.
Calendar Import Issues
Calendar Import Issues
Ensure your calendar app supports .ics files. Most modern calendar applications do, but some may require specific import steps.
Local Ollama Not Working
Local Ollama Not Working
Make sure Ollama is installed and running. Test with
ollama list to verify models are available.Next Steps
Explore More Agents
Check out other AI agent examples
GitHub Repository
View the complete source code
