KevinIsInCoding Claude Sonnet 4.6 commited on
Commit
e7279ce
Β·
1 Parent(s): 73de926

Update README with phase explanations, EAP section, and hot-reload command

Browse files

Documents the diagnosis/onset distinction, trial phase meanings, EAP
compassionate use pathway, and the `gradio app.py` hot-reload workflow.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Files changed (1) hide show
  1. README.md +26 -2
README.md CHANGED
@@ -123,10 +123,24 @@ Beacon is a conversational AI assistant that helps patients with rare diseases f
123
 
124
  ## How it works
125
 
126
- 1. **Intake agent** (Claude Sonnet) β€” interviews the patient conversationally to collect disease, age, symptom onset, location, and optional benchmark scores.
127
- 2. **Research agent** (Claude Opus) β€” searches ClinicalTrials.gov via the official v2 API, retrying with synonyms or wider radii if results are sparse, then outputs a ranked trial report with eligibility notes and next steps.
128
  3. **LangGraph** orchestrates the two-node pipeline (intake β†’ research).
129
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
130
  ## Project setup
131
 
132
  ### Prerequisites
@@ -173,6 +187,16 @@ ANTHROPIC_API_KEY=your_anthropic_api_key_here
173
  uv run python app.py
174
  ```
175
 
 
 
 
 
 
 
 
 
 
 
176
  ## Configuration
177
 
178
  | Environment variable | Default | Description |
 
123
 
124
  ## How it works
125
 
126
+ 1. **Intake agent** (Claude Sonnet) β€” interviews the patient conversationally to collect disease, age, symptom onset date, formal diagnosis date, location, preferred trial phases, and whether they are interested in Expanded Access Programs (EAP / compassionate use).
127
+ 2. **Research agent** (Claude Opus) β€” searches ClinicalTrials.gov via the official v2 API for clinical trials and/or EAP listings, retrying with synonyms or wider radii if results are sparse, then outputs a ranked report with eligibility notes and next steps.
128
  3. **LangGraph** orchestrates the two-node pipeline (intake β†’ research).
129
 
130
+ ### Clinical trial phases explained
131
+
132
+ | Phase | Focus | Typical size |
133
+ |---|---|---|
134
+ | **Early Phase 1** | First-in-human safety; tiny doses | ~10–15 people |
135
+ | **Phase 1** | Safe dosage range and side effects | 20–80 people |
136
+ | **Phase 2** | Does it work? Continued safety | 100–300 people |
137
+ | **Phase 3** | vs. standard of care; required for FDA approval | 1,000–3,000 people |
138
+ | **Phase 4** | Post-approval long-term surveillance | Varies |
139
+
140
+ ### Expanded Access Programs (EAP)
141
+
142
+ EAP (also called compassionate use) allows patients who do not qualify for or cannot access a clinical trial to receive an investigational drug or device outside of a formal trial. The treatment is not yet FDA-approved; a physician must submit the EAP request to the drug sponsor and obtain FDA authorization. Beacon can search for available EAP listings alongside clinical trials.
143
+
144
  ## Project setup
145
 
146
  ### Prerequisites
 
187
  uv run python app.py
188
  ```
189
 
190
+ #### Hot-reload during development
191
+
192
+ Use the `gradio` CLI to automatically reload the app whenever you save a file β€” no manual restart needed:
193
+
194
+ ```bash
195
+ uv run gradio app.py
196
+ ```
197
+
198
+ > **Note:** Active user sessions are reset on each reload.
199
+
200
  ## Configuration
201
 
202
  | Environment variable | Default | Description |