Skip to main content

​
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.