Skip to content

Repository files navigation

Bar & Pub Hopping Guide 🍻

A smart application that helps you plan the perfect bar-hopping route in any city. Find the shortest walking path between venues while considering your preferences for distance and number of stops.

Features

  • City-Specific Search: Search for venues in any city

  • Smart Route Planning:

    • Finds the shortest walking path between venues
    • Uses actual walking routes (not straight lines)
    • Ignores traffic rules for pedestrians
    • Considers maximum walking distance between venues
  • AI-Enhanced Information:

    • Realistic venue reviews
    • Happy hour times and specials
    • Drink price predictions
    • Casual, authentic descriptions
  • Interactive Map:

    • Visual route display
    • Numbered venue markers
    • Walking path visualization
    • Distance calculations
  • Customizable Options:

    • Choose number of venues (2-10)
    • Set maximum walking distance
    • Select starting venue
    • Toggle AI enhancements

Setup

  1. Install Python dependencies:
pip install -r requirements.txt
  1. Install Ollama from https://ollama.ai/

  2. Pull the Mistral model:

ollama pull mistral
  1. Run the application:
streamlit run app.py

Usage

  1. Enter your city name
  2. Choose your starting venue
  3. Set your preferences:
    • Number of venues to visit
    • Maximum walking distance between venues
    • Enable/disable AI enhancements
  4. Click "Find Route" to generate your bar-hopping plan

Technical Details

  • Built with Streamlit for the frontend
  • Uses OpenStreetMap for venue data
  • OSRM for walking route calculations
  • Ollama with Mistral model for AI enhancements
  • Geopy for geocoding and distance calculations

Requirements

  • Python 3.7+
  • Streamlit
  • Folium
  • Geopy
  • Requests
  • Ollama (for AI features)

Notes

  • The application uses OpenStreetMap data, so venue information depends on what's available in the database
  • Walking routes are calculated using actual paths, not straight lines
  • AI enhancements are optional and require Ollama to be running locally
  • Happy hour times and prices are AI-generated predictions

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages