Day in Our Data · Saturday, October 3, 2026, 11 a.m. to 3 p.m.

Get started

Two ways to take part. Pick a track, get set up in about 15 minutes, and spend the rest of the day on Oak Park's data. AI tools are welcome, and so is a project that uses none.

Before you arrive

None of this is required. Each item saves you ten minutes at your table.

  • Charge your laptop and bring the charger. A tablet works for the browser workspace, but a keyboard helps.
  • Skim the 15 starter projects and pick two you would enjoy.
  • Track B only: make a free GitHub account and, if you like, install Claude Code (below) at home, where the Wi-Fi is not shared with 40 other people. Track A needs neither.

Pick your track

Both tracks end in the same place: an entry on this site. They differ in how much you set up. If you are not sure, take Track A.

Track A · Zero setup · Recommended

The Civic Spark browser workspace

A ready-made coding environment built for this event. It runs in your browser, the starter projects are already loaded, and you cannot break anything. No GitHub account needed: download your project as a zip and attach it to your entry.

Track B · Your own tools

Your laptop, your editor, your workflow

Claude Code in your terminal or editor, Claude Code on the web, Python or Jupyter, or plain Git with no AI at all. Your work lives in a GitHub repository you link from your entry.

Track A: the Civic Spark workspace

  1. Open the workspace and sign in

    Go to https://day-in-our-data.fly.dev/ and create an account with any email address you can check.

  2. Enter your key before you start a session

    Open the Agent tab and paste your key first. If you start a session before entering a key, the agent has nothing to run on. Your table host hands you the GLM key at check-in.

    For GLM, paste the event key. For Claude, paste your own Claude token and pick Opus as the model.

  3. Say hello to the agent

    Type a plain-English request in the Agent tab. Try: List the starter projects in this workspace and tell me which one a beginner could finish in two hours.

  4. Optional: use the terminal instead

    Prefer typing commands? In the Terminal tab, run opencode for the GLM agent, or claude for Claude Code after you have entered your Claude token.

    opencode     # GLM agent in the terminal
    claude       # Claude Code in the terminal
  5. Save your work as a zip

    Before you leave, and before you enter your project, download your project from the workspace as a zip. That zip is your copy: it is what you attach to your entry, and it outlasts the workspace. Can't find the download option? Ask a table host.

  6. Optional: share a preview link

    If you built a web page, the workspace can show you a preview link. Open it in a private browser window first: if it loads without signing in, paste it into your entry as your demo link.

    A preview link only works while your workspace is running. Voters open links after building ends, so the zip is what counts. A screenshot in the zip helps too.

Track B: your own tools

Track B assumes a free GitHub account: your repository is how teammates share work and how you link it from your entry. Pick whichever tool below suits you.

Most control

Claude Code in your terminal or editor

Runs on your own files. Install steps are below. Works inside VS Code, Cursor, and JetBrains IDEs too: see where to code.

No install

Claude Code on the web or desktop

Use claude.ai/code in the browser, or the Code tab of the Claude desktop app. Needs a Pro, Max, Team, Enterprise, or Console account; the event credits apply to a Console account. Connect GitHub when asked and pick your team's repository.

Your usual stack

Python, Jupyter, R, or no AI at all

Clone or download the event repository for the starter projects and cached data, and work however you normally do. Commit to your team repository as you go.

Track B: install Claude Code on your laptop

Claude Code runs on macOS 13+, Windows 10 (1809) or later, and most Linux distributions, with 4 GB of memory or more. You do not need administrator rights.

  1. Open a terminal

    Mac: press Cmd+Space, type Terminal, press Enter. Windows: press the Windows key, type PowerShell, press Enter. Linux: you know where it is.

  2. Run the installer for your system

    Copy the one line for your system, paste it into the terminal, press Enter.

    # macOS, Linux, or WSL
    curl -fsSL https://claude.ai/install.sh | bash
    
    # Windows PowerShell
    irm https://claude.ai/install.ps1 | iex
    
    # Or with a package manager
    brew install --cask claude-code        # macOS Homebrew
    winget install Anthropic.ClaudeCode    # Windows

    Windows: installing Git for Windows is optional but lets Claude Code use Git Bash. If you see 'irm' is not recognized, you are in CMD, not PowerShell.

  3. Check it worked

    Close the terminal, open a new one, and run the version check. If it says claude is not found, open a fresh terminal once more, then ask a table host.

    claude --version     # prints a version number
    claude doctor        # checks your install and settings
  4. Get the event data and start Claude

    Download the event repository, move into it, and start Claude Code. The first run opens your browser to sign in.

    git clone https://github.com/oak-park-cisc/Oak_Park_Day_in_our_Data
    cd Oak_Park_Day_in_our_Data
    claude

    No git? Download the repository as a ZIP from GitHub (green Code button, then Download ZIP), unzip it, and cd into the folder.

  5. Optional: use it inside your editor

    Install the Claude Code extension for VS Code (it also works in Cursor), or the plugin for JetBrains IDEs. See where to code for the trade-offs.

Your first 15 minutes

Same steps on both tracks, whichever agent you use. Type these in plain English. You do not need to know any code.

  1. Let it read the project

    Run /init. Claude reads the files and writes a CLAUDE.md: notes it will reread at the start of every session.

  2. Ask for a tour

    Explain what is in this project like I have never coded before. What data is here and what could I make with it?

  3. Plan before you build

    Press Shift+Tab until the mode shows plan. Claude now researches and proposes a plan without changing any files. Say Plan a simple map for starter project 11 (the urban forest). Read the plan, push back, then switch out of plan mode and say Go.

  4. See it running

    Show me how to open what you just built. Claude will give you a command, a file to open, or a link.

  5. Keep your data steps in files

    Put every step that changes the data in a script or notebook, not just in this chat, and tell me which file does what. A result nobody can rerun is hard to trust, and the judges check for it.

Write your README

Start this by 2:00. Your README is how the AI judging panel understands your project: it reads your entry and your README, not your code or your app. Use these five headings, one short paragraph each.

The five README headings and what each one answers
HeadingWhat to write
The questionWhat resident question does this answer, and who asks it?
The dataWhich datasets you used, where they came from, and what they do not cover.
How we got the numbersEach step from the raw file to your result: filtered, joined, counted, charted. Say which script or spreadsheet does it, and where AI helped.
How to use itHow to open it or read it, in plain words.
Status and next stepsWhat works, what does not yet, and what someone should do on Monday.
Paste this to your agent
Write README.md for this project using exactly these five headings:
The question, The data, How we got the numbers, How to use it,
Status and next steps. Only describe what is really in these files.
List every data file we used and every step that changes the numbers.
Keep it under one page.
  • Track A: the workspace starts you with a placeholder README.md. Replace it; the placeholder counts as no README. It then travels inside your zip.
  • Track B: put README.md at the top level of your repository.
  • No code, no agent? Write the five headings by hand in a document and upload it with your entry.
  • Read it before you submit. Delete anything that is not true: the judges can only score what the README says.
  • No README at all is fine. The panel then scores your written entry alone.

Enter your project

Every team enters on this site, once, using the entry form. Nothing else to fill in anywhere.

What each track puts in the entry form
FieldTrack A (workspace)Track B (your own tools)
Written answersRequiredRequired
How you got from the raw data to the resultRequired: a few plain sentencesRequired: a few plain sentences
Repository linkLeave blankYour GitHub repository
Live demo linkOptional: your preview link, if it opens signed outOptional: anywhere public
UploadYour project zip (up to 8 MB)Optional: a chart, CSV, PDF, or zip

Ground rules for AI tools today

  • Keys and tokens are passwords. Never paste one into a file you commit, a public chat, a screenshot, or your showcase entry. If one leaks, tell a table host so it can be revoked.
  • Public data only. Do not give the AI confidential or personal information.
  • Check what the AI tells you. Open the chart, read the numbers, ask How do you know that? Label prototypes as prototypes.
  • Never let the AI make up data. Numbers should come from a data file through a step you can rerun, not typed in by a model.
  • Record your sources. The README's The data heading is where they go.
  • Nothing made today is an official Village product or position.