whatisgithub

What is new-york-city-budget?

betanyc/new-york-city-budget — explained in plain English

Analysis updated 2026-05-18

19PythonAudience · pm founderComplexity · 2/5LicenseSetup · easy

In one sentence

A dataset and set of Python tools that turn NYC Council's official PDF budget documents into clean, checked spreadsheet data anyone can search or analyze.

Mindmap

mindmap
  root((repo))
    What it does
      Extracts NYC budget PDFs
      Reconciles totals
      Publishes clean CSVs
    Tech stack
      Python parsers
      GitHub Pages viz
      Prototype MCP server
    Use cases
      Explore funding live
      Analyze in spreadsheet
      Join via EIN
    Audience
      Journalists
      Researchers
      Residents
    Data
      Schedule C
      Terms and conditions
      Capital projects

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Explore NYC Council discretionary funding by year through the live GitHub Pages web page without installing anything.

USE CASE 2

Download reconciled CSV budget data to analyze city spending in a spreadsheet or notebook.

USE CASE 3

Join the data to other public records using the tax ID (EIN) field included with each award.

USE CASE 4

Query the underlying budget data programmatically through the prototype MCP server.

What is it built with?

PythonCSVGitHub PagesTypeScriptSQLite

How does it compare?

betanyc/new-york-city-budget16nic/comfyui-agnes-ai6c696e68/gpt_signup_hybrid
Stars191919
LanguagePythonPythonPython
Setup difficultyeasymoderatehard
Complexity2/52/54/5
Audiencepm foundervibe coderdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

The live web explorer needs no setup, regenerating the CSVs from source PDFs requires running the Python parsers described in code/PARSING.md.

MIT for the code and extracted data: use, modify, and share freely with attribution. Original source PDFs stay copyrighted by the City of New York.

So what is it?

This project takes New York City's official budget documents and turns them into clean, usable data. City budgets are published as long PDF files that are hard to search or analyze, so this repository extracts the numbers into spreadsheet-style CSV files that anyone can open, sort, or join with other data. The project is built by BetaNYC, a civic organization focused on open data and government transparency in New York. It covers the city's discretionary funding schedule, reporting requirements, and capital project changes for fiscal years 2025 through 2027, plus older records going back to 2009. Every dollar amount was pulled out using Python scripts that read the text inside the PDFs with pattern matching, not by hand and not by an AI reading the numbers, and each total is checked against the printed total in the original document. There is also a live web page, built with GitHub Pages, where anyone can explore the discretionary funding data without installing anything. The repository is organized into folders for the original source PDFs, the extracted CSV data by year, the parser code, a small prototype server that lets AI tools query the data directly, and the visualization behind the live web page. The source budget documents themselves stay the property of the City of New York, since they are official government publications reproduced here for public reference. The parser code, the extracted data files, and the written analysis are released under the MIT license, meaning they can be reused freely as long as BetaNYC is credited. The code that extracts and checks the data was built with the AI assistant Claude. Because everything is checked against the government's own printed totals, this dataset is meant to be something journalists, researchers, community groups, and everyday residents can trust and use to ask real questions about how the city spends public money.

Copy-paste prompts

Prompt 1
Help me load the schedule_c CSV files from this repo into a spreadsheet and total spending by category.
Prompt 2
Explain how the Python parsers extract numbers from the NYC budget PDFs and check them against printed totals.
Prompt 3
Show me how to set up and run the prototype MCP server so an AI client can query this budget data.
Prompt 4
Walk me through the repository layout so I know where the source PDFs, extracted CSVs, and parser code each live.
Prompt 5
How would I combine the expense-funding-disclosure spreadsheets with the parsed Schedule C data for a full history?

Frequently asked questions

What is new-york-city-budget?

A dataset and set of Python tools that turn NYC Council's official PDF budget documents into clean, checked spreadsheet data anyone can search or analyze.

What language is new-york-city-budget written in?

Mainly Python. The stack also includes Python, CSV, GitHub Pages.

What license does new-york-city-budget use?

MIT for the code and extracted data: use, modify, and share freely with attribution. Original source PDFs stay copyrighted by the City of New York.

How hard is new-york-city-budget to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is new-york-city-budget for?

Mainly pm founder.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.