skill md

.claude/skills/hf-space-sandbox/SKILL.md

@@ -0,0 +1,71 @@
+---
+name: hf-sandbox
+description: Run remote workloads on Hugging Face Spaces via SSH using Dev Mode. Use when executing Python scripts, training models, or running compute-intensive tasks on remote GPU hardware.
+---
+
+# HF Space Dev Mode Sandbox
+
+Run scripts on remote GPU hardware via SSH. Requires HF Pro/Enterprise subscription.
+
+## Create Space
+
+```bash
+uv run scripts/sandbox.py create user/sandbox
+uv run scripts/sandbox.py create user/sandbox --hardware t4-small --sleep-time 3600 --private
+```
+
+## SSH Access
+
+```bash
+ssh USERNAME-SPACENAME@ssh.hf.space
+```
+
+For example, for space `burtenshaw/sandbox`, use:
+```bash
+ssh burtenshaw-sandbox@ssh.hf.space
+```
+
+Add your SSH key at https://huggingface.co/settings/keys first.
+
+## Run uv Scripts
+
+```bash
+# Remote execution
+ssh USERNAME-SPACENAME@ssh.hf.space "uv run --with requests python -c 'import requests; print(requests.get(\"https://httpbin.org/get\").status_code)'"
+
+# Copy and run
+scp script.py USERNAME-SPACENAME@ssh.hf.space:/app/
+ssh USERNAME-SPACENAME@ssh.hf.space "cd /app && uv run script.py"
+
+# Background job
+ssh USERNAME-SPACENAME@ssh.hf.space "cd /data && nohup uv run train.py > train.log 2>&1 &"
+ssh USERNAME-SPACENAME@ssh.hf.space "tail -f /data/train.log"
+```
+
+## uv Script Format (PEP 723)
+
+```python
+#!/usr/bin/env -S uv run --script
+# /// script
+# requires-python = ">=3.11"
+# dependencies = ["transformers", "torch"]
+# ///
+
+from transformers import pipeline
+print(pipeline("sentiment-analysis")("Hello!"))
+```
+
+## Space Management
+
+```bash
+uv run scripts/sandbox.py status user/sandbox
+uv run scripts/sandbox.py start user/sandbox
+uv run scripts/sandbox.py stop user/sandbox
+uv run scripts/sandbox.py hardware user/sandbox t4-medium
+uv run scripts/sandbox.py hardware user/sandbox a10g-small --sleep-time 3600
+uv run scripts/sandbox.py wait user/sandbox
+```
+
+**Hardware:** `cpu-basic`, `cpu-upgrade`, `t4-small`, `t4-medium`, `a10g-small`, `a10g-large`, `a100-large`
+
+Fetch this for up to date information: https://huggingface.co/docs/hub/en/spaces-overview