swarm: Command for Claude Code

/deploy_demo

Deploy (or update) the Streamlit interactive demo to Hugging Face Spaces.

Usage

/deploy_demo — full rebuild and push /deploy_demo --check — just check if the Space is running and on the latest code

Context

The demo app lives at examples/demo/ in the main repo but the HF Space at Swarm-AI-Research/swarm-sandbox uses a flat layout (/app/ root). This command handles the path rewriting that breaks every time you push manually.

Space URL: https://Swarm-AI-Research-swarm-sandbox.hf.space Space repo: https://huggingface.co/spaces/Swarm-AI-Research/swarm-sandbox

Behavior

--check mode

1. Check health endpoint:

   curl -s -o /dev/null -w "%{http_code}" https://Swarm-AI-Research-swarm-sandbox.hf.space/_stcore/health
   

2. Check runtime status and deployed SHA:

   curl -s -H "Authorization: Bearer $(cat ~/.cache/huggingface/token)" \
     "https://huggingface.co/api/spaces/Swarm-AI-Research/swarm-sandbox/runtime"
   

3. Report: stage (RUNNING/BUILDING/ERROR), deployed SHA, health status.

Full deploy (default)

Step 1: Prepare staging directory

STAGE=$(mktemp -d)

Copy the required files from the main repo:

cp examples/demo/app.py "$STAGE/app.py"
cp -r examples/demo/pages "$STAGE/pages"
cp -r examples/demo/utils "$STAGE/utils"
cp -r swarm "$STAGE/swarm"
cp -r scenarios "$STAGE/scenarios"
cp pyproject.toml "$STAGE/pyproject.toml"
mkdir -p "$STAGE/.streamlit"
cp .streamlit/config.toml "$STAGE/.streamlit/config.toml"

Clean pycache:

find "$STAGE" -type d -name __pycache__ -exec rm -rf {} + 2>/dev/null
find "$STAGE" -name "*.pyc" -delete 2>/dev/null

Step 2: Rewrite paths for flat layout

The main repo has examples/demo/app.py (3 levels deep) but the Space has app.py at root. Fix PROJECT_ROOT in all files:

app.py: Path(__file__).resolve().parent (1 parent — app.py is at Space root)

utils/simulation.py: Path(__file__).resolve().parent.parent (2 parents — utils/ is one level down)