10000 GitHub - TheoDepr/Secret-Santa-Generator: A cheerful Streamlit web app designed to make organizing Secret Santa gift exchanges easy and fun! Add participants, set custom pairing constraints, and generate a festive gift-giving loop where everyone is matched fairly.
[go: up one dir, main page]
More Web Proxy on the site http://driver.im/
Skip to content

A cheerful Streamlit web app designed to make organizing Secret Santa gift exchanges easy and fun! Add participants, set custom pairing constraints, and generate a festive gift-giving loop where everyone is matched fairly.

Notifications You must be signed in to change notification settings

TheoDepr/Secret-Santa-Generator

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 

Repository files navigation

🎅 Secret Santa Pair Generator

A festive web application built with Streamlit that helps organize Secret Santa gift exchanges by generating random pairs while respecting pairing constraints.

🎄 Features

  • Simple and intuitive interface
  • Add multiple participants
  • Set pairing constraints (prevent specific pairs from being matched)
  • Generates random pairs while ensuring:
    • No one gets themselves
    • All constraints are respected
    • Creates a complete circle of gift-giving
  • Festive UI with Christmas themed styling

🚀 Getting Started

Prerequisites

  • Python 3.7+
  • pip

Installation

  1. Clone the repository

  2. Install required packages:

    python -m venv venv
    source venv/bin/activate
    pip install streamlit numpy
  3. Run the application:

    streamlit run app.py

About

A cheerful Streamlit web app designed to make organizing Secret Santa gift exchanges easy and fun! Add participants, set custom pairing constraints, and generate a festive gift-giving loop where everyone is matched fairly.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

0