Skip to content

Get Started

gtfs-io is a Python library for reading, writing, and validating GTFS (General Transit Feed Specification) data.

Pre-alpha

The public API is being sketched; most methods are currently stubs that raise NotImplementedError. Expect breaking changes.

Installation

uv add gtfs-io

pip install gtfs-io

Quick example

from gtfs_io import Feed

feed = Feed.load("gtfs.zip")
stop = feed.stop("ABC123")
issues = feed.validate()

Where to next?

  • I/O — read and write GTFS archives.
  • Models — typed data classes for GTFS entities.
  • Validation — check a feed for spec compliance.
  • Views — derived, query-friendly views over a feed.
  • Feed — the top-level [Feed][gtfs_io.Feed] entry point.