hackathon-roulette / README.md
blackboxanalytics's picture
Deploy Hackathon Roulette
a4c66c6 verified
|
Raw
History Blame Contribute Delete
1.31 kB
---
title: Hackathon Roulette
emoji: 🎰
colorFrom: purple
colorTo: blue
sdk: gradio
sdk_version: 6.16.0
app_file: app.py
pinned: false
short_description: Spin to discover hidden gems from the Build Small Hackathon
---
# 🎰 Hackathon Roulette
Hundreds of projects ship during the **Build Small Hackathon** β€” and most of
them never get seen because everyone scrolls the same first page. This is a
slot machine for the whole submission pool: pull the lever and get a random
project you haven't seen yet.
## What it does
- **Indexes every submission** in the hackathon org, live from the Hub.
- **Auto-categorizes** each project into 12 topic buckets (games, voice,
health, dev tools, creative, agents, and more) so you can browse by theme.
- **Roulette** β€” one button serves up a random project you haven't viewed,
remembering what you've already seen for the session (no database needed).
- **Browse mode** β€” open any category and scan the most-liked projects.
- Each result shows the name, description, category, official track badge,
likes, and a direct link to the Space.
## Run locally
```bash
pip install -r requirements.txt
python app.py
```
The app pulls submissions straight from the Hub at startup β€” no API keys, no
configuration. Drop it on a Hugging Face Space and it just runs.