Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 
 
 
 
 

Repository files navigation

🌴 AI-Powered Travel Planner

An intelligent travel planning application that uses AI to help you plan your perfect trip. Simply describe your travel plans using voice or text, and get personalized recommendations for flights, hotels, car rentals, and attractions.

✨ Features

  • ✍️ Text Input: Type your travel requirements in natural language
  • 🤖 AI Processing: Uses OpenAI GPT-4 to understand and extract trip details
  • 🔍 Real-time Search: Searches for flights, hotels, and car rentals using Tavily API
  • 📋 Comprehensive Plans: Generates detailed itineraries with budget estimates
  • 🎯 Smart Recommendations: Suggests points of interest and activities
  • 🖥️ UI Built with Streamlit: A clean and interactive web interface powered by https://streamlit.io/

🚀 How to Use

Text Input

  1. Type your travel information in the text boxes
  2. Click "🎯 Plan My Trip from Text"

🔧 Technology Stack

  • Frontend: Streamlit - https://streamlit.io/
  • AI Models:
    • OpenAI GPT-4 for natural language processing and trip planning
  • Search APIs:
    • Tavily API for real-time travel information
  • Backend: Python with various libraries for data processing

🔑 Required API Keys

To run this application, you need the following API keys:

  1. Tavily API Key (TAVILY_API_KEY)

    • Sign up at Tavily.com
    • Used for real-time travel search
  2. OpenAI API Key (OPENAI_API_KEY)

    • Get from OpenAI Platform
    • Used for AI processing and Whisper transcription

Setting API Keys in Hugging Face Spaces

  1. Go to your Space settings
  2. Click on "Variables and secrets"
  3. Add the API keys as secrets:
    • TAVILY_API_KEY
    • OPENAI_API_KEY

📁 Project Structure

├── app.py # Main application including streamlit ├── requirements.txt # Python dependencies ├── README.md # This file └── .env files (local) # Environment variables (not included in deployment) ├── TAVILY_API_KEY.env ├── OPENAI_API_KEY.env

🛠️ Local Development

  1. Clone the repository

  2. Install dependencies:

    pip install -r requirements.txt
    
  3. Create .env files with your API keys

  4. Run:

python app.py

🌐 Deployment on Hugging Face

  • Fork this repository
  • Create a new Hugging Face Space
  • Connect your GitHub repository
  • Set the required API keys in Space settings
  • The app will automatically deploy

⚠️ Important Notes

  • This app requires active API keys to function
  • Transcription and AI processing require OpenAI credits
  • Search functionality requires Tavily API access
  • Some features may be rate-limited based on your API plan

🤝 Contributing

Feel free to submit issues, feature requests, or pull requests to improve this application.

📄 License

This project is open source and available under the MIT License.

Happy Travels! 🌍✈️

About

GenAI generates creative, personalized day-by-day itineraries, while Agentic AI autonomously refines predictions by integrating real-time data from Tavily on flights, hotels, and points of interest.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages