README.md

metadata

title: MedCaseAgent
emoji: 📄
colorFrom: gray
colorTo: gray
sdk: static
app_file: index.html
license: cc-by-nc-4.0
short_description: Clinical case reports · Corpus, benchmark, and agent code

MedCaseAgent

From Multimodal Clinical Evidence to Rare Disease Case Reports

Open project page

The project page brings together the three research resources:

• MedCase-Bench: 584 structured clinical input records for evaluating case-report generation.
• MedCase-150K: a large corpus of clinical case-report metadata, including rare-disease reports.
• MedCaseAgent code: preprocessing, Planner–Writer–Editor report-generation inference, and the disease retrieval index.

See each repository for its release scope and license. The code's CC BY-NC 4.0 license restricts commercial use; source publications retain their own licenses.

Free static deployment

The published Space uses React + TypeScript + Vite. It reads public JSON snapshots generated from the optional FastAPI backend. The frontend is compiled locally and its built files are uploaded to the Space root, alongside the source code. No hosted build, runtime server, model, token, or paid hardware is needed.

Requires Node.js 22.12+:

cd frontend
npm ci --include=dev
npm run build:static
npm run preview -- --host 127.0.0.1 --port 7860

Open http://127.0.0.1:7860. The introduction, teaser figure, and resource links work entirely in the browser.

Update the public content

Edit backend/app/content.py, then export the validated data and rebuild:

python -m venv .venv
.venv/bin/pip install -r backend/requirements.txt
.venv/bin/python scripts/export_static.py
cd frontend
npm run build:static

Commit the updated frontend/public/api/*.json along with the source. Only explicit public project and example models are exported; environment variables and credentials are never serialized.

To publish an update, upload the contents of frontend/dist/ to the root of the static Space, keeping the directory structure (index.html, assets/, api/, teaser.png, and teaser.pdf). Also upload the changed source files. Do not enable app_build_command: hosted builds may require account credits, while this precompiled deployment is free.

Optional FastAPI mode

The complete FastAPI backend remains available for future extensions. After installing the Python requirements, build without the static flag:

cd frontend
npm run build
cd ..
.venv/bin/python -m uvicorn app.main:app --app-dir backend --host 127.0.0.1 --port 7860

FastAPI serves the built React application and /api/project, /api/example, and /api/health on the same origin. API docs are at /docs. For frontend development, run FastAPI on port 8000 and npm run dev in frontend/; Vite proxies /api to port 8000.

The included Dockerfile supports this mode. A Docker Space may require a paid Hugging Face plan; the current published static Space does not use it.

Optional public environment variables used by the backend or export script:

Variable	Default	Purpose
HF_NAMESPACE	PediaMedAI	Account or organization hosting the two datasets.
CODE_URL	https://github.com/PediaMedAI/MedCaseAgent	Agent source repository.

To change static links, set these when running scripts/export_static.py and rebuild. No credential belongs in this repository or in the Space variables. The page does not copy the datasets, host model weights, or accept patient uploads.