Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


Project history

Philadelphia is among the cities hardest hit by the opioid crisis. Medication-assisted treatment (MAT), particularly buprenorphine, is identified as “the gold standard of care” for opioid use disorder.

In early 2020, several local tech communities partnered with public health organizations to host a seven-week data hackathon, right before the COVID-19 pandemic shut down in-person gatherings. Team 8 responded to the orientation request from Health Federation’s Opioid Response Program: “Can you help us identify what buprenorphine access really looks like in Philadelphia?” by mapping public data on availability and need.

We discovered that information about MAT availability is rich but scattered. Each key source left out some listings from the others, and a substantial percentage of provider listings were out of date.

Current priorities


We want to reduce the human costs of inaccurate and dispersed data. Red Xs below mark dead ends: listings where treatment seekers might give up from disappointment or frustration. Blue icons show examples where searchers would miss out on key treatment options, depending on which source they used:

Accuracy map for 2020


  • Help the helpers! Examples: People who answer the substance-abuse hotline, help with emergency room discharge, help with post-prison reentry, other referral networks ...


Make it easier for helpers to find relevant options for people seeking MAT, and waste less time with unreliable information.

  • Centralize relevant site listings
  • Correct legacy errors / false positives
  • Organize search & filter options by relevant priorities (user feedback especially wanted here!)
  • Facilitate frequent updates:

Updates map for 2020Q3

Data sources and pipeline

At the national level, SAMHSA (the Substance Abuse and Mental Health Services Administration) maintains several search tools with different details. At the local level, DBHIDS (Philadelphia’s Department of Behavioral Health and Individual disAbility Services) offers an MAT page with a “Treatment Availability Database” PDF updated 2–3x weekly for bed availability but far less frequently for other changing details.

After the hackathon, we focused first on identifying how Health Federation could contact individual providers about buprenorphine waiver training (parts 2 & 4 in below diagram). In 2021, our project has shifted to mapping sites that offer any MAT medication, with filters and info popups for other relevant factors (parts 1 & 3):

Data paths

For data update components and sequence, see blue numbers (sans serif). For data access setup, see red numbers (serif).

Pipeline components

Tech stack

  • Django 3.1
  • PostgreSQL 9.6.3
  • pgadmin 4.23
  • R Shiny
  • Figma => HTML5, CSS3 ...

How to use

Start virtualenv and run pipenv shell to use virtual environment. Contact the team at to get access to the Django application and the PostgreSQL database.


No description, website, or topics provided.






No releases published


No packages published