Love Machine ❤️🥠

A fun, colorful CLI party game in Python for stirring up tea.

• Very beautiful interface (uses the rich.console framework)
• Easy to use
• Maximum tea guaranteed
• Highly inclusive (even supports polyamorous relationships!)
• Super lightweight (entire app on 1 file)

By Morpheus

---

How to use

Requirements

• Python 3.14 or above (recommended)

Installation

1. Visit the repo page and select Code (green button) -> Download ZIP
2. Unzip the ZIP file
3. Open a new terminal window at the new folder, or run:

   cd <path/to/love_machine>

4. Install dependencies:

   python -m pip install --upgrade pip
   python -m pip install -r requirements.txt

Start app

Run:

cd <path/to/love_machine>
python love_machine.py

---

Gameplay

The main menu features 3 game modes:

Compatibiligram ⚖️

Enter two or more people's names (along with some other information). A random percentage will show up, displaying how compatible these people are.

Tips for party hosts:

• Append a space at the end of any name input to secretly trigger a high compatibility percentage (90-100%).
• Append a period (.) for a lower percentage (0-30%).
• Only the last usage of this secret percentage manipulation will be used. If a period is appended to the first name input, followed by appending a space to the second name input, the period used in the first input is ignored.

Match Finder 🔍

Enter someone's name, and the program will find the name of this person's soulmate, hinting at it by only giving the name's first letter (a random letter in the English alphabet).

Tips for party hosts:

• You can manipulate results by adding names to the SPECIAL_NAMES dictionary in love_machine.py (which can be found near line 314 of the file), like so:

  SPECIAL_NAMES: dict[str, str] = {
      "lowercased name": "ABC",
      "another name": "EFG",
  }

The program will choose a letter from the string after the colon when "finding" the person's match.

• The program checks if the name entered by the user is a substring of any one of the dictionary keys, so enter full names to be safe. Names are case-insensitive.

Fortune Cookies of Love 🥠

The program displays a random fortune cookie message from a preloaded list. Pronouns used in messages are optimized based on inputted information.

Tips for party hosts:

• These fortune cookies are not afraid to be offensive.

---

Contribute to this project

Read the Contributing Guidelines for more information.

---

License

This project is licensed under the MIT License.