Skip to content
This repository was archived by the owner on Jul 6, 2025. It is now read-only.

tschm/secretsanta

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🎅 Secret Santa

CodeFactor Renovate enabled Maintenance Release GitHub release (latest by date) License: MIT Python 3.10+ GitHub Pages

🎁 About

A simple yet effective Secret Santa generator application built with Marimo. This tool helps organize gift exchanges by randomly pairing participants from two different groups.

✨ Features

  • 🎯 Create random pairings between two groups
  • 🔄 Shuffle names for truly random assignments
  • 🖥️ Clean, interactive web interface
  • 🚀 Easy to use with simple text input

🚀 Getting Started

📋 Prerequisites

  • Python 3.10+
  • Marimo package (installed automatically via pyproject.toml)

🔧 Installation

# Clone the repository
git clone https://github.com/tschm/secretsanta.git
cd secretsanta

# Install dependencies
make install

🎮 Running the Application

# Start the Marimo app
make app

🎄 How to Use

  1. Enter comma-separated names for the first group
  2. Enter comma-separated names for the second group
  3. The app will automatically shuffle and display the results
  4. Use these pairings for your Secret Santa gift exchange

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

Contributors 4

  •  
  •  
  •  
  •