| name | sparkstation-deploy |
| description | Safe deployment operations for Sparkstation. Profile switching with drain/health-check, rolling model updates, Docker image rebuilds, full stop/start, and rollback. Use when asked to "deploy", "switch profile", "restart sparkstation", "update model", "rebuild container", or "rollback". |
Sparkstation Deploy
Safe, verified deployment operations for Sparkstation.
Usage
python3 .pi/skills/sparkstation-deploy/scripts/deploy.py switch-profile image-indexing
python3 .pi/skills/sparkstation-deploy/scripts/deploy.py restart
python3 .pi/skills/sparkstation-deploy/scripts/deploy.py restart --profile openclaw
python3 .pi/skills/sparkstation-deploy/scripts/deploy.py stop
python3 .pi/skills/sparkstation-deploy/scripts/deploy.py start --profile dev
python3 .pi/skills/sparkstation-deploy/scripts/deploy.py rebuild clip
python3 .pi/skills/sparkstation-deploy/scripts/deploy.py verify
python3 .pi/skills/sparkstation-deploy/scripts/deploy.py switch-profile openclaw --dry-run
python3 .pi/skills/sparkstation-deploy/scripts/deploy.py full --profile image-indexing
Operations
switch-profile <name>
- Pre-flight: validate profile exists, check memory feasibility
- Stop all running models gracefully
- Stop supervisor and gateway
- Start supervisor with new profile
- Start gateway
- Wait for all models to be RUNNING
- Run integration health check
restart [--profile name]
Full stop/start cycle with optional profile change.
rebuild <backend>
Rebuild Docker image for clip/flux/species backend.
stop
Graceful shutdown: stop models, supervisor, gateway, verify containers are down.
start [--profile name]
Start supervisor + gateway, optionally with a profile.
verify
Check all expected models are RUNNING and responsive.
full --profile <name>
Complete pipeline: stop → rebuild (if needed) → start → verify.
Safety Features
- Pre-flight checks: Validates profile, memory, Docker images before any changes
- Ordered shutdown: Models stopped before supervisor
- Health verification: Waits for all models to be RUNNING after start
- Timeout protection: Fails gracefully if models don't start within 10 minutes
- Dry run: Preview operations without executing