mood-recommender 0.1.3

A package to suggest activities based on mood.

Team: chugthiskoolaid

Badges

Team members

• Jess Liang: GitHub
• Yukun Dong: GitHub
• Hao Yang: GitHub
• Yifan Zhang: GitHub

TABLE OF CONTENTS

1. Description
2. PyPI Page
3. Installation
4. Virtual Environment & Dependencies
5. Usage Examples
6. Contributing

Description

Mood Recommender is your ultimate boredom-busting, vibe-matching companion! 🎉 Whether you're feeling happy, stressed, bored, or just looking for something fun to do, this package has got you covered. Get personalized recommendations for activities, books, movies, and music based on your mood—because sometimes, all you need is the perfect song, a great read, or a wild adventure to turn your day around. Just tell us how you’re feeling, and we’ll do the rest. Let the good vibes roll! 😎🎶📖🎬

PyPI Page

You can find the package here: Mood-recommender

Installation

You can import the Mood Recommender package into your projects using pip. Below is how to install the package:

1. Install the package from PyPI

pip install mood-recommender

2. Import the functions in your Python code

from mood_suggester import recommend_activity, recommend_book, recommend_movie, recommend_music

Virtual Environment & Dependencies

1️⃣ Clone the Repository

git clone https://github.com/software-students-spring2025/3-python-package-chugthiskoolaid.git
cd 3-python-package-chugthiskoolaid

2️⃣ Create a Virtual Environment

python -m venv venv

For MacOS/Linux:

source venv/bin/activate

For Windows:

venv\Scripts\activate

3️⃣ Install Dependencies

pip install -r .github/workflows/requirements.txt

4️⃣ Run Tests

PYTHONPATH=$(pwd) pytest tests/

5️⃣ Build the Package

python setup.py sdist bdist_wheel

Usage Examples

For a detailed example of how to use this package, please refer to example.py, which contains comprehensive demonstrations of the available functions. Below is a brief overview of how each function can be used.

1. recommend_activity:

Feeling restless? Inspired? Maybe a little down? Not sure what to do? Let your emotions guide you! No worries—I have just the right activity to match your mood and help you make the most of your day!

How are you feeling now? (happy/sad/stressed/bored/motivated/angry): bored

🎉 activity: Solve a puzzle, play a board game, or try an escape room challenge

2. recommend_book:

Books have a unique way of reflecting and shaping our emotions. Whether you're feeling adventurous and craving an epic journey, or simply looking for a heartwarming story to lift your spirits, there’s a perfect book waiting for you. Tell me how you're feeling, and I'll recommend a story that resonates with your mood and transports you to the world you need most right now!

How are you feeling now? (happy/sad/stressed/bored/motivated/angry): happy

📖 book: The Hundred-Year-Old Man Who Climbed Out the Window and Disappeared – Jonas Jonasson

3. recommend_movie:

Looking for a movie that fits your emotions? Whether you're in the mood for action, romance, or something uplifting, I’ve got a perfect recommendation just for you!

How are you feeling now? (happy/sad/stressed/bored/motivated/angry): angry

🍽 movie: The Revenant

4. recommend_music:

Music speaks when words can’t. Every mood has a melody to match. Tell me how you're feeling, and I'll find the perfect song to match your vibe and emotions!

How are you feeling now? (happy/sad/stressed/bored/motivated/angry): bored

🎵 music: Young Folks - Peter Bjorn and John

Contributing

We welcome contributions! If you would like to improve Mood Recommender, follow these steps:

1️⃣ Fork the Repository

Click on the Fork button at the top-right corner of the repository page.

2️⃣ Clone the Repository

git clone https://github.com/software-students-spring2025/3-python-package-chugthiskoolaid.git
cd 3-python-package-chugthiskoolaid

3️⃣ Create a Virtual Environment

python -m venv venv

For MacOS/Linux:

source venv/bin/activate

For Windows:

venv\Scripts\activate

4️⃣ Install Dependencies

pip install -r .github/workflows/requirements.txt

5️⃣ Create a New Branch

git checkout -b feature-branch

6️⃣ Make Your Changes

git add .
git commit -m "Add new feature"

7️⃣ Push Changes

git push origin feature-branchs

8️⃣ Submit a Pull Request

Go to the original repository on GitHub. Click on Pull Requests > New Pull Request. Select your branch and submit a Pull Request (PR) for review.

📜 License

This project is licensed under the MIT License. See the LICENSE.txt file for details.