Pgai Patient Voice Bot — Data skill for Claude Code

Patient voice bot — Pretty Good AI test harness

A voice bot that **calls** Pretty Good AI's test line and role-plays patients to test their AI receptionist. Python + LiveKit Agents in pipeline mode: separate STT, LLM and TTS, no speech-to-speech model, no hosted voice platform.

• 14 patient personas in `scenarios/` as editable YAML
• Stereo recordings in `recordings/` — far end on channel 0, our patient on channel 1, so overlaps are audible and measurable. One call per scenario; the other 22 calls from tuning and accent passes are in `recordings/extra/`, including call-01, the pre-tuning baseline kept as the "before" case (see CHANGELOG.md)
• Timestamped transcripts in `transcripts/`
• Findings in `BUG_REPORT.md`, generated then hand-reviewed
• Design rationale in `ARCHITECTURE.md`, iteration log in `CHANGELOG.md`
• Diagrams: `docs/overview-simple.svg` for a general audience, `docs/architecture.svg` for the technical flow

**It only ever dials +1-805-439-8008.** The number is a hardcoded constant in [`src/config.py`](src/config.py), not read from the environment and not overridable by a flag. `assert_allowed_number()` guards the single code path that can dial, and `preflight.py` asserts there is exactly one `add_sip_participant` call site in the tree and that the literal appears nowhere else.

Setup

1. Install

Python 3.10–3.13 (developed and tested on 3.13).

**On Windows, clone somewhere short** such as `C:\dev\pgai`. Some dependency filenames are long enough that a deep clone path breaks `pip install` with `OSError: [Errno 2] No such file or directory` — that is Windows' 260-character limit, not a broken package. Enabling Long Path support also fixes it.

python -m venv .venv

.venv/Scripts/python.exe -m pi