🚀 SolMate-AI ( 🌐Live Demo )

An AI-powered Daily Planner & Travel Companion

Craft your day, plan your travel, and stay informed — all with intelligent AI guidance.

---

Overview

Morning Buddy & AI-Powered Travel Planner is a personalized AI assistant that combines weather updates, news summaries, smart daily planning, and AI-powered travel itineraries using the Google Gemini API, OpenWeather API, NewsAPI, and SerpAPI.

It provides users with:

• Daily weather updates with practical suggestions
• Summarized news by topic or interest
• Personalized smart day planning
• AI-generated travel itineraries for any city

This project demonstrates real-world applications of AI for personal productivity and travel planning.

---

🛠 Features

1. Home Page – Morning Motivation

• Displays a random motivational quote each day
• Shows a beautiful morning image for visual inspiration
• Encourages users to start their day positively

2. Weather Updates

• Fetches current weather for any city using OpenWeather API
• Uses Gemini API to generate friendly, human-readable weather updates
• Includes:
  • Temperature (°C)
  • Feels-like temperature
  • Weather description, humidity, wind speed
  • Sunrise & sunset times
  • Practical suggestions: what to wear/carry

3. News Summaries by Interest

• Fetches top 5 latest news articles using NewsAPI
• Uses Gemini API to generate concise, clear summaries
• Users can filter news based on interests like technology, sports, health, etc.
• Displays news with images, titles, summaries, and links

4. Smart Daily Planner

• Generates personalized day plans for any city
• Considers:
  • Weather conditions
  • Local events
  • Recommended tourist attractions
  • Available time window of the user
• Outputs a chronological plan with suggestions for:
  • Morning, afternoon, and evening activities
  • Lunch/dinner recommendations
  • Indoor vs outdoor activity recommendations
• Uses Gemini API + OpenWeather + SerpAPI for accurate planning

5. AI-Powered Travel Planner

• Fully AI-powered travel assistant using Gemini API
• Users can input:
  • From city & destination city
  • Travel dates
  • Personal interests (e.g., sightseeing, food, adventure)
• Generates:
  • Detailed travel logistics: accommodations, visa info, transportation, cost of living, local events
  • Personalized city guide: attractions, food, events, tailored suggestions
  • Complete travel itinerary with daily plans, expenses, and tips
• Allows downloadable travel plans as .txt for offline use

---

🧩 Technologies Used

• Python 3.12
• Streamlit for interactive web interface
• Google Gemini API (gemini-2.5-flash) for text generation
• OpenWeather API for weather data
• NewsAPI for fetching news articles
• SerpAPI for local events
• dotenv for API key management
• Requests library for HTTP requests

---

⚡ How It Works

1. Weather & News Modules

   • Fetches raw JSON data from APIs
   • Gemini API converts data into friendly, readable output
   • Example: "It is 32°C in Dehradun, sunny with a slight breeze. Wear light cotton clothes and carry sunglasses."

2. Smart Daily Planner

   • Uses weather data + local events + recommended places
   • Gemini API generates chronologically ordered day plans
   • Suggests activities based on weather and time of day

3. Travel Planner

   • Combines location logistics and city guide info
   • Gemini API produces a full itinerary
   • Outputs daily plans, attractions, food spots, events, costs, and tips

🧩 Core Components

Component	Description
Frontend (Streamlit)	Collects user inputs (location, plan type, preferences) and displays the final itinerary and insights.
Weather Module	Fetches real-time weather and forecasts from OpenWeather API.
News Module	Uses NewsAPI to summarize relevant headlines or local updates.
Search Module	Uses SerpAPI or Gemini to find trending attractions, restaurants, or travel details.
Gemini AI Engine	Central intelligence — combines all fetched data, reasons about context, and generates coherent, customized daily or travel plans.
Output Layer	Formats and presents results in a visually appealing way for the user (cards, highlights, summaries).

⚙️ Data Flow Summary

1. User Input → API Fetches → Gemini Reasoning → Formatted Output → Streamlit UI

2. APIs act as data suppliers, Gemini acts as the brain, and Streamlit acts as the face.

---

📂 Project Structure

SolMate-AI/
│
├─ main.py # Core backend functions: weather, news, planner, Gemini API integrations
├─ app.py # Streamlit frontend for user interaction
├── assets/                        # Streamlit web interface
│   ├── appInterface_1.png            # e.g., weather info fetching  
│   ├── appInterface_2.png            # e.g., news info fetching & summarization
│   ├── appInterface_3.png            # e.g., day planner 
│   └── pipeline.png                  # working pipeline
├─ requirements.txt # Python dependencies
└─ README.md # Project documentation

---

🚀 Getting Started

1. Clone the Repository

git clone https://github.com/SannidhyaDas/SolMate-AI.git
cd SolMate-AI

2. Install Dependencies

pip install -r requirements.txt

3. Setup API Keys

Create a .env file with your keys:

GOOGLE_API_KEY=your_google_gemini_api_key
OPENWEATHER_API_KEY=your_openweather_api_key
NEWS_API_KEY=your_newsapi_key
SERPAPI_API_KEY=your_serpapi_api_key

4. Run the Application

streamlit run app.py

---

🌟 Example Use Cases

• 📚 Morning Routine Companion – Start your day with inspirational quotes, weather, and top news headlines.

• 🌤 City Weather & News Updates – Get real-time weather updates with actionable recommendations and news summaries.

• 🧾 Smart Planner for Daily Activities – Generate a personalized day plan based on weather, events, and recommended places.

• ✈️ AI Travel Planner – Create complete AI-powered itineraries for any city worldwide tailored to your interests.

💡 Acknowledgements

• Google Gemini API

• OpenWeather API

• NewsAPI

• SerpAPI

• Streamlit community for creating amazing interactive web apps

🔖 License

This project is open-source and free to use.

Feel free to modify and enhance it for personal or educational purposes.