fortuneluckpredictor 1.0.0

Fortune & luck predictor. Returns lucky numbers, fortunes, and horoscope-like results.

Fortune Luck Predictor

A Python package that returns lucky numbers, fortunes, and horoscope-like results.

Team

• Pranathi Chinthalapani — [e-mail] (GitHub)
• Sam Rawdon — [e-mail] (GitHub)
• May Zhou — [e-mail] (GitHub)
• Hanjun Deng — [e-mail] (GitHub)
• William Chan — [e-mail] (GitHub)

What is it?

Fortune Luck Predictor provides:

• Fortunes: Random fortune cookie-style messages
• Future Predictions: Predicts career, marriage age, number of kids, and success level
• Day Predictions: Get day-specific fortunes for any day of the week
• Compatibility Scores: Calculate compatibility between two names
• Lucky Numbers: Generate weighted lucky numbers based on the current date and time

Installation

From PyPI:

pip install fortuneluckpredictor

From source:

git clone https://github.com/swe-students-fall2025/3-python-package-team_boreal.git
cd 3-python-package-team_boreal
pip install -e .

How to Run

Interactive Mode

Run the package as a module:

python -m fortuneluckpredictor

Or if you need to set PYTHONPATH:

PYTHONPATH=src python -m fortuneluckpredictor

This launches an interactive menu with all available functions.

Using as a Package

Import and use the functions in your Python code:

from fortuneluckpredictor.fortune import get_fortune
from fortuneluckpredictor.futurePredictions import futurePrediction
from fortuneluckpredictor.predictDay import predict_day
from fortuneluckpredictor.compatibility_score import compatibility_score
from fortuneluckpredictor.luckyNumber import get_lucky_number

# Get a fortune
print(get_fortune())

# Predict your future
print(futurePrediction("Alice"))

# Predict a day
print(predict_day("Monday"))

# Check compatibility
print(compatibility_score("Alice", "Bob"))

# Get a lucky number
print(get_lucky_number((1, 100)))

Development

Set up the development environment:

pipenv install --dev
pipenv shell
pip install -e .

Run tests:

pytest tests/

Links

• GitHub: https://github.com/swe-students-fall2025/3-python-package-team_boreal
• PyPI: https://pypi.org/project/fortuneluckpredictor/