Skip to content

Latest commit

 

History

History
155 lines (83 loc) · 4.05 KB

README.md

File metadata and controls

155 lines (83 loc) · 4.05 KB

Tiri Ya Tiyara ✨

Tiri Ya Tiyara is an AI-powered trip planner designed to make exploring Lebanon an effortless and personalized experience. Whether you're a tourist visiting for the first time or a local looking for hidden gems, this project provides a platform to create, customize, and plan your perfect trip to some of Lebanon's most captivating destinations.

Features 🌍

🗺️ Destination Discovery

Explore Lebanon's breathtaking landscapes, historic landmarks, and cultural hotspots.

Popular destinations and off-the-beaten-path recommendations.

📓 Personalized Itineraries

Plan trips based on your interests, travel style, and budget.

Use AI to generate itineraries tailored to your preferences and duration of stay.

🌎 Multilingual Support

Interact in multiple languages, including English, Arabic, French, and more.

Built-in translation tools ensure inclusivity and ease of use.

🧱 AI-Powered Search

Retrieve relevant and personalized travel suggestions from a vector database.

Efficiently search and discover the best activities and places to visit.

🛊 Sleek and Intuitive Interface

Streamlit-powered front-end for a seamless user experience.

Aesthetic design and user-friendly navigation.

Technologies Used ⚙️

This project leverages modern tools and frameworks to provide a cutting-edge solution:

Back-End

  • Python: Main programming language for development.

  • LangChain: To handle AI integrations and workflows.

  • ChromaDB: A vector database for efficient similarity searches.

  • Google Generative AI Embeddings: For document embedding and intelligent recommendations.

Front-End

  • Streamlit: For a clean, interactive user interface.

Data Handling

  • pandas: For data manipulation and CSV file handling.

  • Deep Translator: For seamless multilingual support.

Installation 🔧

To get started, follow these steps:

1. Clone the Repository

https://github.com/MRIT03/TiriYaTiyara

2. Install Required Dependencies

Install all the required Python libraries:

  • pip install python-dotenv
  • pip install langchain
  • pip install langchain-google-genai
  • pip install langchain-core
  • pip install langchain_chroma
  • pip install langgraph
  • pip install chromadb
  • pip install langchain-community
  • pip install pypdf
  • pip install streamlit
  • pip install deep-translator
  • pip install pandas

3. Set Up Environment Variables

Create a .env file in the project directory and add your Google API key:

GOOGLE_API_KEY=your_google_api_key_here

4. Run the Application

Launch the Streamlit app with the following command:

streamlit run streamlit&tools.py

Usage 🎡

  • Discover Destinations: Use the "Plan My Trip" feature to select your destination, travel style, and budget.

  • Generate Itineraries: Let the AI suggest a personalized itinerary based on your inputs.

  • Explore: Dive into the suggestions and refine your plan.

  • Chat with Tiri: Use the chatbot feature to ask travel-related questions in your preferred language.

Future Enhancements 🌈

We are constantly looking to improve and expand Tiri Ya Tiyara. Planned updates include:

  • Integration with real-time weather data for each destination.

  • Support for hotel and restaurant recommendations.

  • Social sharing options to share your itinerary with friends.

  • Enhanced mapping features to visualize routes and locations.

Contributing 🚀

We welcome contributions to make Tiri Ya Tiyara even better! To contribute:

  • Fork the repository.

  • Create a feature branch.

  • Submit a pull request describing your changes.

Acknowledgments 🙏

Special thanks to:

  • The developers of LangChain, ChromaDB, and Streamlit for their incredible tools.

  • Google for providing robust APIs and embedding models.

  • Another Thanks to Google. Google ❤️

  • Dr Saab for his guidance.

  • Lebanon’s beautiful landscapes for inspiring this project.

License 🔒

This project is licensed under the MIT License. See the LICENSE file for more details.

Contact Us 📢

For questions, suggestions, or feedback, please reach out to us at:

Email: [email protected]

GitHub: MRIT03