🗺️ PathSeeker

AI-powered travel discovery & trip planning app for India

PathSeeker helps you explore nearby attractions, plan trips with real transport options, and connect with fellow travellers — all on an interactive map.

---

Features

• ** Interactive Map** — Leaflet + OpenStreetMap with live location
• ** AI Chat** — Ask about nearby gems, hidden waterfalls, temples & more (powered by Gemini)
• ** Trip Planner** — AI generates a full itinerary with transport costs, timing, and booking tips
• ** Saved Places** — Bookmark spots with personal notes
• ** Community Hub** — Join travel groups, share posts, get local tips
• ** Offline Access** — Download trip plans for use without internet
• ** Live Weather** — Real-time weather overlay on the map
• ** Auth System** — Register/login with per-user preferences

---

Quick Start

1. Clone the repo

git clone https://github.com/YOUR_USERNAME/PathSeeker.git
cd PathSeeker

2. Create a virtual environment

python -m venv venv
source venv/bin/activate        # Linux/Mac
venv\Scripts\activate           # Windows

3. Install dependencies

pip install -r requirements.txt

4. Set up environment variables

cp .env.example .env
# Edit .env and add your API keys

You'll need:

• Gemini API key → Google AI Studio
• Groq API key (optional, fallback LLM) → console.groq.com
• OpenTripMap API key (optional) → opentripmap.io

5. Run the app

python app.py

Open http://localhost:5000 in your browser.

---

🗂️ Project Structure

PathSeeker/
├── app.py              # Flask backend — all API routes
├── ai.py               # AI layer — Gemini chat, trip planning, intent classification
├── weather.py          # Weather API integration
├── templates/
│   └── map.html        # Full frontend (HTML + CSS + JS, single file)
├── requirements.txt
├── .env.example        # Template for environment variables
└── .gitignore

---

Environment Variables

Variable	Description
GEMINI_API_KEY	Google Gemini API key (required)
GROQ_API_KEY	Groq LLM key (optional fallback)
OPENTRIPMAP_API_KEY	OpenTripMap key (optional, enriches POI data)
SECRET_KEY	Flask session secret (auto-generated if not set)

---

Tech Stack

Layer	Technology
Backend	Python, Flask
Frontend	Vanilla JS, Leaflet.js
Map Data	OpenStreetMap, Overpass API
AI	Google Gemini (via google-genai)
Geocoding	Nominatim (OpenStreetMap)
Database	SQLite (local, per-user)

---

📸 Screenshots

can view the results in asserts folder

Map View

Login Page

Trip Planner

Dashboard

---

Contributing

Pull requests are welcome! For major changes, please open an issue first.

---

License

MIT License — feel free to use and modify.

---

Built with for exploring India