Skip to content

An intelligent, LLM-powered chatbot that offers map-based services through natural language interaction. Users can ask for the best routes, nearby restaurants based on mood/sentiment, current weather updates, and distance calculations — all within a conversational interface.

Notifications You must be signed in to change notification settings

SpikyKat/smart-maps-chatbot

Repository files navigation

🗺️ Smart Maps ChatBot

Smart Maps ChatBot is an intelligent, interactive assistant built with Python, Streamlit, and Groq AI (GPT-based) that helps users get quick information about:

  • 🌦️ Weather forecasts
  • 🚦 Live traffic conditions
  • 🍽️ Food suggestions based on mood
  • 🧭 Distance between locations
  • 💬 Optional GPT-mode for conversational AI

📸 Preview

image


🚀 Features

✅ Rule-based assistant for fast map-based queries

✅ GPT toggle mode for natural chat using Groq API

✅ Mood-based food suggestions

✅ Custom UI with emojis, color-coded messages, and modern layout

✅ Clean interface using Streamlit


🧠 Technologies Used

  • Python 3.10+

  • Streamlit – UI framework

  • Groq API – GPT-level responses when enabled

  • OpenWeatherMap API – for weather (if used)

  • Google Maps (optional) – for distance/route links


📁 Project Structure

maps_chatbot/ │ ├── app.py # Streamlit frontend

├── chatbot_backend.py # Main logic and GPT integration

├── mapsbot.ipynb # Notebook for dev/testing

├── .env # API keys (not committed to Git)

├── requirements.txt # Python dependencies

├── README.md # Project documentation

└── .gitignore # Files to exclude from Git

⚙️ Setup Instructions

🔐 Step 1: Clone the Repo

git clone https://github.com/your-username/smart-maps-chatbot.git

cd smart-maps-chatbot

📦 Step 2: Set Up Virtual Environment

python -m venv venv

venv\Scripts\activate # On Windows

source venv/bin/activate # On Mac/Linux

pip install -r requirements.txt

🔑 Step 3: Add .env File

Create a .env file and add your API keys:

GROQ_API_KEY=your_groq_api_key_here

OPENWEATHER_API_KEY=your_openweathermap_key_here

▶️ Run the App streamlit run app.py

🌐 Deployment (Optional) You can deploy the app using:

Streamlit Cloud

Render

Heroku (with custom Procfile)

📣 Credits Created by SpikyKat

GPT-Powered by Groq

📜 License MIT License. Free to use, modify, and share.

About

An intelligent, LLM-powered chatbot that offers map-based services through natural language interaction. Users can ask for the best routes, nearby restaurants based on mood/sentiment, current weather updates, and distance calculations — all within a conversational interface.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published