Getting started
Use the hosted site with zero setup, or run the simulator locally.
The fastest way into Selection Room is the hosted site. Running locally is for developers who want the Python engine on their own machine.
Part A: Use the hosted site (default path)
Open www.selectionroom.org. No account, install, or API key is needed to browse.
Signed out, you can:
- Browse every run in the catalog with the run switcher in the header
- Explore Rankings, Bubble, Bracket, and team resumes
- Read the Validation dashboard and Model vs Committee comparison
- Compare already-generated scenarios in Scenario Lab
- Read these docs
Signing in with GitHub adds:
- Launching live analysis runs from the Run Analysis dialog
- Launching your own Scenario Lab reweight runs
Run launches have a per-user daily quota so the shared worker stays available for everyone. Browsing is never gated.
Tip
Start on the Dashboard, click any team name to open its resume drawer, then check Validation to see how the model compares to the real committee.
Part B: Run locally (for developers)
Get the simulator running on your machine with sample data. No CFBD API key is required for the first run.
1. Install
git clone https://github.com/XavierAgostino/cfp-selection-simulator.git
cd cfp-selection-simulator
make setupVerify your environment:
sroom doctorNote
A missing CFBD API key is fine for sample data. Doctor may warn but still pass.
2. Run sample data
make demoEquivalent:
sroom run --year 2025 --week 15 --sample3. Launch the web app
From the repo root:
make webOpen the local URL shown in the terminal. The setup wizard walks you through first-run configuration when pipeline data is missing.
4. Inspect outputs
sroom outputs --latestArtifacts land under data/output/ (rankings, fields, brackets, audits, manifests).