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 workshop/ folder for offline reading.

---

Prerequisites

• Python 3.13 or higher
• uv package manager

Setup

uv sync

Devcontainer / Codespaces

This repository includes a preconfigured devcontainer at .devcontainer/devcontainer.json.

• Local VS Code: Reopen the repo in container when prompted
• GitHub Codespaces: In your own repository created from this template, click Code → Codespaces → Create codespace on main

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.