MTAtabase 0.2.0

MTA GTFS parser and database system that bypasses the need for API feeds

MTAtabase

A Python library for parsing realtime MTA subway data and matching it against static GTFS schedules with no API key required.

Overview

Most MTA data tools require you to register for an API key and hit live endpoints to get realtime train information. MTAtabase parses an archive of MTA data feeds and correlates them with static GTFS schedule files locally, with no API credentials needed.

Third-party realtime data is sourced from subwaydata.nyc.

Features

• Parse MTA realtime train data without an API key
• Match live trip updates to static GTFS schedule data
• Works offline once data is fetched
• Built on pandas for easy data manipulation
• Includes a bundled schema for GTFS data structures

Requirements

• Python 3.13+
• uv (recommended) or pip

Installation

With pip

pip install MTAtabase

From source

git clone https://github.com/pacmanboss256/mtatabase.git
cd mtatabase
uv sync

Usage

from MTAtabase import MTAtabase

# Initialize the database
db = MTAtabase(subway_data_path,gtfs_path)

Project Structure

mtatabase/
├── mtatabase/      # Core library source
├── data/           # subwaydata.nyc data
├── gtfs/			# GTFS files
├── schema/         # Project schema definitions
└── pyproject.toml

Data Sources

• Realtime data: subwaydata.nyc — a third-party archive of MTA subway feeds
• Static GTFS: MTA's published schedule files (stops, routes, trips, etc.)

License

This project is licensed under the GNU General Public License v3.0.

---

This project is not affiliated with or endorsed by the Metropolitan Transportation Authority (MTA).