CLAUDE.md

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:

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.