Spaces:
Sleeping
Sleeping
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 filesDocuments 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>
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
|
| 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
|
| 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 |
|