Overview
What it does
- Checks Steve’s List, the plain-text page at stevelist.com/list, every hour, and ingests it whenever it has changed
- Parses each listing: its date, lineup and venue, and its details (prices, age restrictions, times, and
flags:
*recommended,$will sell out, etc.) - Enriches new venues with Google Maps Places (address, lat/lng, place ID), takes new bands’ genres, links and members from MusicBrainz, Last.fm and Discogs (the List only names a band), takes each band’s photo from Wikimedia Commons, Discogs or its Bandcamp page, and keeps only image URLs and links that work
- Stores shows, bands, venues, and acts in SQLite (Alembic-managed schema)
- Indexes band and show embeddings in FAISS for Similar Bands (Ollama
nomic-embed-text) - Exports the data to static JSON and builds an Astro static site, with a band-or-venue search and region, genre, date, price, age and free-only filters, all running in the browser
- Emails each new edition’s Alerts: the Upcoming Shows that match each person’s Saved Filters (Supabase and Resend)
- Serves a Strawberry GraphQL API over FastAPI, for local development only
Stack
| Layer | Tech |
|---|---|
| Backend | Python 3.12, FastAPI, Strawberry GraphQL |
| ORM / migrations | SQLAlchemy 2, Alembic |
| Database | SQLite (kept on the data branch in production) |
| Enrichment | Venues: Google Maps Places API. Bands: MusicBrainz, Last.fm and Discogs (genres, links, members), with photos from Wikimedia Commons, Discogs or Bandcamp. Claude Haiku 4.5 only for the manual venue re-enrichment job |
| Genre filter | Ollama tev1:0.8b, judging once whether a tag that isn’t on MusicBrainz’s genre list is a genre |
| Embeddings | Ollama nomic-embed-text (dim=768) |
| Vector search | FAISS IndexIDMap(IndexFlatL2) |
| Photo focal points | OpenCV’s YuNet face detector (opencv-python-headless; the model, face_detection_yunet_2023mar.onnx from the OpenCV Zoo, is MIT-licensed and vendored in backend/app/ingestion/yunet/ with its licence) |
| Source | Steve’s List as he publishes it: plain text at https://stevelist.com/list, checked hourly |
| Frontend | Astro static site with React islands, Tailwind; Vitest, React Testing Library, MSW, Playwright |
| Docs | Starlight (Astro’s docs framework), with Pagefind search and Mermaid diagrams |
| Hosting | GitHub Pages, built and deployed by GitHub Actions |
Design: DESIGN.md describes the site’s design system: the colour tokens (defined in
frontend/src/styles/tokens.css, switching with the system’s light/dark setting), the Figtree typeface, the type
scale and the component styles. Use the semantic tokens (bg-surface, text-ink-muted, text-link, …) rather than
palette classes or dark: variants; a test keeps DESIGN.md and the stylesheet in sync.