Skip to content


Folders and files

Last commit message
Last commit date

Latest commit



7 Commits

Repository files navigation

Team Me0w

Every day public transit networks (PTNs) play a critical role in the lives of millions of people. Because of their importance, one developing trend is the use of numerical graph methods in order to examine different aspects of a PTN, such as equity, transit frequency, and vulnerability. Our team hopes to help public transit planners by providing a free, user-friendly web application for analyzing PTNs based on publicly available GTFS data. Besides providing users with the ability to build aggregate networks from multiple transit types (e.g., combining Caltrain, BART, and Muni), Transitcat also makes it easy to visualize them and understand real-world usability through the use of isochrone maps. We're just three cat lovers hoping to improve the world, one public transit stop at a time.

Getting Transitcat Running

You'll need to follow these steps once to set up the project:

  1. Download a local copy of this entire repository. Be sure to follow the instructions for setting up your directory structure.
  2. Install Postgres on your machine. An easy way to do this is using Homebrew with the command brew install postgres.
  3. In your Terminal, run the commmand postgres -D /usr/local/var/postgres to start Postgres.
  4. In a new Terminal tab/window, open the Postgres prompt by typing psql. Next create your user using the username and password of your choice by typing CREATE USER sample_user WITH PASSWORD 'sample_password';. Finish by typing CREATE DATABASE transitcat WITH OWNER sample_user;, which creates a database called transitcat and gives your user access. Exit by typing /q.
  5. Update your file so that Transitcat can find your database. Scroll down to the section that says:
    "default": {
    "ENGINE": "django.db.backends.postgresql_psycopg2",

Replace "YOUR_USERNAME_HERE" and "YOUR_PASSWORD_HERE" with the values you assigned to your Postgres user.

  1. Navigate to the directory containing and run the following command: python migrate.
  2. Apply for free, personal API keys for Yelp and Google Maps.
  • Add your Yelp API key to Do so by scrolling down to the section that says:
# TODO: Uncomment the line below and add your Yelp API key.
# HEADERS={"Authorization":"Bearer YOUR_KEY_HERE"}
<script async defer

Now every time you want to run Transitcat, simply do the following:

  1. In your Terminal, run the commmand postgres -D /usr/local/var/postgres.
  2. In a new Terminal tab/window, navigate to the directory containing and run the following command: python runserver.
  3. Point your web browser to, and you're off!

Team Members

Member Photograph Email
Aaron Aquino (aaron33) Aaron Aquino
Tracey Lin (traceyl) Tracey Lin
Erik Raucher (eraucher) Erik Raucher


A tool for public transit planners to help them visualize and better understand their networks.






No releases published


No packages published