---
title: Echo (Private EchoPilot Agent)
emoji: 🫀
colorFrom: blue
colorTo: red
sdk: streamlit
sdk_version: "1.39.0"
app_file: app.py
pinned: false
private: true
---

# EchoPilot – Private Echocardiography Agent

This Hugging Face Space runs the EchoPilot Streamlit interface for cardiac ultrasound analysis (segmentation, measurements, disease prediction, view classification, reporting, and video generation).

## Usage
1. Open the Space (private link only).
2. Provide the echo video path and clinical question.
3. The ReAct agent orchestrates the available tools and responds with a structured summary.

## Secrets & Config
Configure the following in **Settings → Variables and secrets**:
- `OPENAI_API_KEY`
- `ECHO_INITIAL_MASK_PATH` (default mask prompt, optional)
- Any other environment variables from `config.py`

## Local Development
```bash
pip install -r requirements.txt
streamlit run streamlit_app.py
```

Please keep PHI and large datasets out of this Space; only the runnable code and lightweight assets are included. Weight files download at runtime or reside in the bundled `tool_repos/` directories.