HobbyPromoter

Created for Hacklahoma 2025

Product Overview

This is an app designed for users that are unsure what they're interested in to find and recommend hobbies for them. It does this by asking the user a series of questions in which we will then ask ChatGPT what it recommends based on the user's responses. Once it has decided what hobbies the user might like, the user can click on the one of their choice and get the description of the hobby and ChatGPT's opinion on if the user should get into it. The user can also ask ChatGPT questions about the hobby, like how they can get into the hobby and what the hobby requires.

Prerequisite Installations

Python3 - 3.13.1

1. Go to https://www.python.org and download the correct version for your device.
2. Once downloaded, open the file and follow the pop-up instructions.
3. To ensure it is properly downloaded, launch cmd prompt and type in "python --version". It should show that you have it downloaded by showing the current version installed.

React - 19.0

1. Got to https://react.dev/learn/installation

Git - 2.43.0.windows.1 | 2.48.1 (MacOS)

1. Go to https://git-scm.com/downloads and download the correct version for your device.
2. Once downloaded, open the file and follow the pop-up instructions.
3. To ensure it is properly downloaded, launch cmd prompt and type in "git --version". It should show that you have it downloaded by showing the current version installed.

NextJS - 15.1.7

1. Go to https://nextjs.org

Packages

OpenAI: 1.63.0

Python-dotenv 1.01

annotated-types 0.7.0

anyio 4.8.0

blinker 1.9.0

certifi 2025.1.31

click 8.1.8

distro 1.9.0

Flask 3.1.0

Flask-Cors 5.0.0

h11 0.14.0

httpcore 1.0.7

httpx 0.28.1

idna 3.10

itsdangerous 2.2.0

Jinja2 3.1.5

jiter 0.8.2

MarkupSafe 3.0.2

pydantic 2.10.6

pydantic_core 2.27.2

sniffio 1.3.1

tqdm 4.67.1

typing_extensions 4.12.2

Werkzeug 3.1.3

Project Installation

1. Clone the project to a local installation using git clone through SSH or HTTPS.
2. Create a Python virtual environment within the project BackEnd directory.
   python -m venv env (Windows)
   python3 -m venv env (MacOS/Linux)
3. Activate the virtual environment.
   env\Scripts\activate.bat or env\Scripts\activate (Windows)
   source env/bin/activate (MacOS/Linux)
4. Install required packages according to requirements.txt while the environment is active.
   pip install -r requirements.txt
5. Deactivate the virtual environment when done.
   deactivate

Project Execution

1. Create the dev build for the React project while in Frontend/hobby-finder npm run dev
2. Run the Python flask server while in Backend python -u [path-to-backend]/sever.py