# CLAUDE.md

## Local dev server

`app.py` runs a Gradio app on port 7860. When launching it locally to test changes
(`uv run python app.py` in background), always kill that background process before
ending the session — do not leave it running after the conversation is done.

Before launching, check for and kill any stale instance first:

```bash
pgrep -af "python app.py"
kill <pids>
```

Data (`load_data()`) is fetched once at import time and cached for the process's
lifetime — restart the process to pick up new HF Hub data or code changes; a
browser refresh alone is not enough after a restart, and no restart is needed for
a plain browser refresh of unchanged code.