HF-SPACE-RULE.md

🚨 HUGGING FACE SPACE HARDWARE RULE (PRIORITY -7 — ABSOLUT, KEINE AUSNAHMEN) 🚨

ABSOLUTES VERBOT: KEINE GPU/ZeroGPU SPACES FÜR A2A AGENT RUNTIMES!

WARUM

• HF Free Tier erlaubt UNBEGRENZT CPU-Basic Spaces gleichzeitig ($0)
• GPU/ZeroGPU Spaces haben Quota-Limit (8x) und benötigen Payment
• Alle Agent Spaces MÜSSEN auf CPU-Basic laufen

PFLICHTEN

1. JEDES HF Space MUSS auf cpu-basic Hardware konfiguriert sein
2. NIEMALS GPU, ZeroGPU, oder paid Hardware für Agent Runtimes
3. IMMER Keep-Alive-Ping alle 5 Minuten (verhindert 48h Sleep)

PFLICHT-DATEIEN FÜR JEDES HF SPACE

Jedes HF Space MUSS diese Dateien enthalten:

1. Dockerfile — Node.js/Python Container Definition
2. A2A Server — Express/FastAPI mit A2A Protocol (server.js oder app.py)
3. Agent Logic — Die eigentliche Agenten-Funktionalität
4. Health Endpoint — /health Endpoint für Monitoring
5. A2A Card — /.well-known/agent-card.json für Agent Discovery

KORREKTE SPACE ERSTELLUNG

# 1. Space erstellen
curl -X POST https://huggingface.co/api/repos/create \
  -H "Authorization: Bearer $HF_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "sin-my-agent", "type": "space", "sdk": "docker"}'

# 2. Hardware auf CPU-Basic setzen
curl -X POST https://huggingface.co/api/spaces/{owner}/{space}/hardware \
  -H "Authorization: Bearer $HF_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"flavor": "cpu-basic"}'

# 3. Dockerfile + Code deployen (via git push)
git clone https://huggingface.co/spaces/{owner}/{space}
cp Dockerfile server.js package.json .well-known/agent-card.json {space}/
cd {space} && git add . && git commit -m "deploy agent" && git push

KEEP-ALIVE PFLICHT

Jedes Space MUSS Keep-Alive-Ping haben (alle 5min) um 48h Sleep zu verhindern.

KOSTEN

Hardware	Kosten	Max gleichzeitig
cpu-basic	$0	UNBEGRENZT
zerogpu	FREE	8 pro Account
gpu (T4)	$288/Mo	Unbegrenzt (Payment)

FAZIT: CPU-Basic = $0, UNBEGRENZT Spaces!

Siehe auch: Global Dev Docs HF Space Hardware Standard