Skip to content

riyonp23/AttractionFinder

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

68 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

AttractionFinder

A constraint-based travel recommendation engine that generates optimized itineraries from user-defined parameters.

Python FBLA

πŸ… 5th Place β€” 2022 FBLA State Competition


πŸ“Œ Overview

Planning travel is time-consuming β€” cross-referencing budget constraints, weather conditions, and local attractions manually is tedious and error-prone. AttractionFinder automates this by taking a user's budget and weather preferences and generating a ranked, optimized list of nearby attractions that fit their criteria.

The core algorithm parses and categorizes regional attraction datasets, applying constraint-based filtering to distinguish local hidden gems from well-known tourist destinations β€” achieving 95% classification accuracy.


✨ Features

Feature Description
πŸ’° Budget Filtering Filters attractions based on user-defined budget constraints
🌀️ Weather Awareness Adjusts recommendations based on current or preferred weather parameters
πŸ—ΊοΈ Itinerary Generation Produces ranked, optimized travel plans from combined constraints
πŸ” Smart Categorization Distinguishes local gems from major tourist hubs with 95% accuracy
πŸ–₯️ Cross-Platform Runs on Windows 10/11, Linux, and macOS

πŸ› οΈ Tech Stack

Technology Purpose
Python 3.5+ Core recommendation engine (~745 lines)
CustomTkinter Desktop GUI
Data filtering algorithms Constraint-based itinerary optimization

Key Engineering: Implemented advanced data filtering and parsing algorithms to categorize regional attraction datasets. The constraint engine chains budget, weather, and location parameters into a single optimized recommendation pass.


πŸš€ Getting Started

Prerequisites

  • Windows 10/11, Linux, or macOS
  • Stable internet connection
  • 25 MB disk space, 2 GB RAM

Installation

# 1. Download and extract the ZIP
# 2. Ensure the assets/ folder is in the same directory as the executable
# 3. Run the executable
"Attraction Finder.exe"

πŸ“ Project Structure

AttractionFinder/
β”œβ”€β”€ assets/                          # UI assets, icons, images
β”œβ”€β”€ sources/                         # Python source code (~745 lines)
β”œβ”€β”€ Attraction Finder.exe            # Compiled executable
└── Attraction Finder Documentation.pdf  # Full project documentation

πŸ† Competition

Built for the 2022 FBLA State Competition, earning 5th Place out of competing student development teams statewide. Full project documentation is included in the repo.


πŸ‘€ Author

Riyon Praveen β€” Computer Science Student, University of South Florida

LinkedIn GitHub

About

πŸ… 5th Place 2022 FBLA State β€” Constraint-based travel recommendation engine in Python. Filters attractions by budget and weather parameters, generating optimized itineraries with 95% classification accuracy.

Resources

Stars

Watchers

Forks

Contributors

Languages