Soc Ops

Social Bingo game for in-person mixers. Find people who match the questions and get 5 in a row!

🎮 Play the Game • 📚 View Lab Guide

---

📚 Lab Guide

Part	Title
00	Overview & Checklist
01	Setup & Context Engineering
02	Design-First Frontend
03	Custom Quiz Master
04	Multi-Agent Development

📝 Lab guides are also available in the .lab/ folder for offline reading.

---

Prerequisites

• Python 3.13 or higher
• uv package manager

Setup

uv sync

Run

uv run uvicorn app.main:app --reload

Then open http://localhost:8000 in your browser.

Test

uv run pytest

Lint

uv run ruff check .
uv run ruff format .

Deploys automatically to GitHub Pages on push to main.