appimepp/OpenSIN-Code-Security

1# 🚨 HUGGING FACE SPACE HARDWARE RULE (PRIORITY -7 — ABSOLUT, KEINE AUSNAHMEN) 🚨2 3**ABSOLUTES VERBOT: KEINE GPU/ZeroGPU SPACES FÜR A2A AGENT RUNTIMES!**4 5## WARUM6 7- HF Free Tier erlaubt UNBEGRENZT CPU-Basic Spaces gleichzeitig ($0)8- GPU/ZeroGPU Spaces haben Quota-Limit (8x) und benötigen Payment9- Alle Agent Spaces MÜSSEN auf CPU-Basic laufen10 11## PFLICHTEN12 131. **JEDES HF Space MUSS auf `cpu-basic` Hardware konfiguriert sein**142. **NIEMALS** GPU, ZeroGPU, oder paid Hardware für Agent Runtimes153. **IMMER** Keep-Alive-Ping alle 5 Minuten (verhindert 48h Sleep)16 17## PFLICHT-DATEIEN FÜR JEDES HF SPACE18 19Jedes HF Space MUSS diese Dateien enthalten:20 211. **Dockerfile** — Node.js/Python Container Definition222. **A2A Server** — Express/FastAPI mit A2A Protocol (`server.js` oder `app.py`)233. **Agent Logic** — Die eigentliche Agenten-Funktionalität244. **Health Endpoint** — `/health` Endpoint für Monitoring255. **A2A Card** — `/.well-known/agent-card.json` für Agent Discovery26 27## KORREKTE SPACE ERSTELLUNG28 29```bash30# 1. Space erstellen31curl -X POST https://huggingface.co/api/repos/create \32  -H "Authorization: Bearer $HF_TOKEN" \33  -H "Content-Type: application/json" \34  -d '{"name": "sin-my-agent", "type": "space", "sdk": "docker"}'35 36# 2. Hardware auf CPU-Basic setzen37curl -X POST https://huggingface.co/api/spaces/{owner}/{space}/hardware \38  -H "Authorization: Bearer $HF_TOKEN" \39  -H "Content-Type: application/json" \40  -d '{"flavor": "cpu-basic"}'41 42# 3. Dockerfile + Code deployen (via git push)43git clone https://huggingface.co/spaces/{owner}/{space}44cp Dockerfile server.js package.json .well-known/agent-card.json {space}/45cd {space} && git add . && git commit -m "deploy agent" && git push46```47 48## KEEP-ALIVE PFLICHT49 50Jedes Space MUSS Keep-Alive-Ping haben (alle 5min) um 48h Sleep zu verhindern.51 52## KOSTEN53 54| Hardware | Kosten | Max gleichzeitig |55|----------|--------|-----------------|56| cpu-basic | **$0** | **UNBEGRENZT** |57| zerogpu | FREE | 8 pro Account |58| gpu (T4) | $288/Mo | Unbegrenzt (Payment) |59 60**FAZIT: CPU-Basic = $0, UNBEGRENZT Spaces!**61 62Siehe auch: [Global Dev Docs HF Space Hardware Standard](https://github.com/OpenSIN-AI/Global-Dev-Docs-Standard/blob/main/standards/hf-space-hardware.md)63