RareDx / src /api.py
sarra2002's picture
Démo RareDx
613af80 verified
Raw History Blame Contribute Delete
2.74 kB
"""REST API (FastAPI) around the system.
Run: uvicorn src.api:app --reload then open http://127.0.0.1:8000/docs
Never send real patient data: notes and symptoms are sent to a free external LLM API.
"""
from __future__ import annotations
from functools import lru_cache
from fastapi import FastAPI, HTTPException
from pydantic import BaseModel, Field
from .agent import QuestionAgent
from .system import DISCLAIMER, DiagnosticSystem, build_system
app = FastAPI(title="Rare disease diagnosis support (research)", description=DISCLAIMER, version="0.1.0")
@lru_cache(maxsize=1)
def get_system() -> DiagnosticSystem:
return build_system()
def get_agent() -> QuestionAgent:
return QuestionAgent(get_system())
class DiagnoseRequest(BaseModel):
codes: list[str] = Field(default_factory=list, description="HPO codes, e.g. HP:0001250")
note: str | None = Field(None, description="Free-text note (invented or public cases only)")
class UpdateRequest(BaseModel):
codes: list[str]
llm_sets: list[list[str]]
confirmed: list[str] = Field(default_factory=list)
excluded: list[str] = Field(default_factory=list)
@app.get("/health")
def health() -> dict:
return {"status": "ok", "disclaimer": DISCLAIMER}
@app.post("/diagnose")
def diagnose(req: DiagnoseRequest) -> dict:
system, agent = get_system(), get_agent()
understood = system.understand_note(req.note) if req.note else []
codes = list(dict.fromkeys(req.codes + [c for c, _, _ in understood]))
unknown = [c for c in codes if c not in system.kb.terms]
if unknown:
raise HTTPException(422, f"Unknown HPO codes: {unknown}")
if not codes:
raise HTTPException(422, "Give HPO codes or a note.")
d = system.diagnose(codes)
questions = agent.choose_questions(d.ranking, codes)
return {
"symptoms": [{"code": c, "name": system.kb.term_name(c)} for c in codes],
"to_verify": [{"code": c, "name": n, "similarity": round(s, 2)} for c, n, s in understood
if s < system.settings.to_verify_threshold],
"metabolic_share": d.metabolic_share,
"ranking": system.explain(d.ranking, codes),
"questions": [{"code": q, "name": system.kb.term_name(q), "lab": system.kb.is_metabolic(q)} for q in questions],
"llm_sets": [sorted(s) for s in d.llm_sets],
"disclaimer": DISCLAIMER,
}
@app.post("/update")
def update(req: UpdateRequest) -> dict:
system, agent = get_system(), get_agent()
ranking = agent.update(req.codes, [set(s) for s in req.llm_sets], req.confirmed, req.excluded)
codes = list(dict.fromkeys(req.codes + req.confirmed))
return {"ranking": system.explain(ranking, codes), "disclaimer": DISCLAIMER}