| --- |
| title: EHRAgent |
| emoji: "🏥" |
| colorFrom: blue |
| colorTo: green |
| sdk: docker |
| app_port: 7860 |
| pinned: false |
| short_description: SQL-grounded question answering over MIMIC-III/IV and eICU |
| --- |
| |
| # EHRAgent — backend |
|
|
| FastAPI backend for the [EHRAgent](https://github.com/suyccc/EHRAgent) chat |
| UI. Loads three EHRSQL benchmark databases (MIMIC-III, MIMIC-IV, eICU) |
| and answers natural-language questions by running an LLM tool-calling |
| loop with two read-only SQL tools (`get_schema`, `execute_sql`). |
|
|
| ## Strict BYOK |
|
|
| This Space **never reads** an OpenAI key from its environment. Every |
| `/api/ask` request must include an `X-OpenAI-Api-Key` header with the |
| caller's own key. Keys are not logged, persisted, or shared across |
| requests. |
|
|
| ## Endpoints |
|
|
| - `GET /api/health` |
| - `GET /api/config` → `{model, databases: [{id, label, ready}], byok_required: true}` |
| - `POST /api/ask` → body `{question, db, question_id?}`. **Required header:** |
| `X-OpenAI-Api-Key: sk-…`. |
|
|
| ## Frontend |
|
|
| The chat UI is a static Next.js export hosted separately (e.g. on GitHub |
| Pages). It points at this Space via `NEXT_PUBLIC_BACKEND_URL` at build |
| time. See the project repo for the source. |
|
|
