Quickstart

Run Pipehealth locally and make your first provider search request.

Prerequisites

• Python 3.11+
• Docker (for local Postgres/PostGIS)

1) Install dependencies

python3 -m venv .venv
. .venv/bin/activate
pip install -e ".[dev]"

2) Start Postgres + PostGIS

docker compose up -d

3) Configure the database URL

export DATABASE_URL=postgresql+asyncpg://postgres:postgres@localhost:5432/pipehealth

4) Run migrations + seed data

make migrate
python scripts/seed_providers.py

5) Start the API

make dev

API runs on http://localhost:7860 by default.

6) Make your first request

By coordinates:

curl "http://localhost:7860/v1/providers/search?lat=37.7749&lng=-122.4194&radius_miles=5&limit=5"

By city + filters:

curl "http://localhost:7860/v1/providers/search?location=San%20Francisco,CA&radius_miles=25&specialties=Anxiety&insurance=Aetna&telehealth_only=true&limit=5"

Next: read the provider search guide for filter details and response semantics.