title: CXR Orchestrator
emoji: 🫁
colorFrom: indigo
colorTo: gray
sdk: docker
app_port: 7860
pinned: false
short_description: Chest X-ray interpretation, localization & overlays
CXR Orchestrator — Hugging Face Docker Space
A Chainlit chat frontend for the chest-X-ray agent. Attach a CXR to a message and ask for a read; the agent triages the image, reasons over it with NV-Reason-CXR-3B (via an MCP server), localizes findings, and can author an interactive HTML overlay that opens in a right-hand dashboard panel. Optional ElevenLabs voice narrates the impression inline.
Follow-up questions in the same chat reuse the loaded image and any findings or visualizations already produced — no need to re-attach.
How it works
Per chat session the app opens the reasoning MCP connection and provisions one
UnixLocalSandboxClient workspace (staging the cxr-overlay skill), keeping both
alive for the session. Each turn runs one agent turn; any HTML the agent writes to
the sandbox output/ directory is collected and surfaced as a selector button +
the right-hand panel (plus a downloadable file). If the sandbox can't be
provisioned, the app falls back to the base agent for a text-only read.
The agent is the model-driven SandboxAgent (shell + filesystem). The sandbox
capabilities are ordinary function tools, so it runs on Claude via LiteLLM.
Repo layout (Space root)
Dockerfile
app.py
requirements.txt
README.md <- this file (HF Docker Space header)
chainlit.md
.chainlit/config.toml
public/elements/OverlayFrame.jsx
cxr_agents/ tools/ skills/ models/ sandbox/
Secrets (Space → Settings → Secrets)
| Name | Required | Purpose |
|---|---|---|
ANTHROPIC_API_KEY |
yes | Claude (orchestrator, via LiteLLM) |
ELEVENLABS_API_KEY |
no | Voice narration (a free key works) |
CXR_REASON_MCP_URL |
no | Override the reasoning MCP URL |
ELEVENLABS_VOICE_ID |
no | Default voice (name or raw ID) |
Disclaimer
Decision support only — not a diagnostic device. Always confirm findings with a qualified radiologist.