| name | deploy-huggingface |
| description | Deploy web app to HuggingFace Spaces, check deployment status, verify HF Space logs. Use when deploying the web app, checking HF logs, or troubleshooting HuggingFace Spaces. |
| allowed-tools | Bash, Read |
| disable-model-invocation | true |
Deploy to HuggingFace Spaces
Pipeline
git tag v1.0.0 โ GitHub Actions (deploy-huggingface.yml) โ 2 HF Spaces (public + admin)
Pre-Deployment
Run /verify before deploying.
Triggering
git tag -a v1.0.0 -m "Release version 1.0.0"
git push origin v1.0.0
Or use /release <version> for full release flow.
Monitoring
Checking HF Logs
./scripts/check-hf-space-logs.sh
Requires secrets.env with HF_TOKEN (copy from secrets.env.example).
Manual check:
curl -H "Authorization: Bearer $HF_TOKEN" \
https://huggingface.co/api/spaces/mpolatcan/ccbell-sound-generator
curl https://mpolatcan-ccbell-sound-generator.hf.space/api/health
Required Secrets
| Secret | Description |
|---|
HF_TOKEN | HuggingFace API token (write access) |
HF_USERNAME | HuggingFace username |
Rollback
git tag -d v1.0.0 && git push origin :refs/tags/v1.0.0
