README.md

---
title: THE-Z-AI Linux System Server
emoji: 🖥️
colorFrom: blue
colorTo: blue
sdk: docker
app_file: app.py
pinned: false
---

# 🖥️ THE Z AI — Linux System Server (Server 2)

هذا هو **سيرفر 2** الخاص بمشروع THE Z AI.  
يتحكم فيه الذكاء الاصطناعي (سيرفر 1) لتنفيذ أوامر Linux بشكل كامل.

---

## 🔑 الإعداد

في إعدادات Hugging Face Space، أضف هذا الـ Secret:

| Key | Value |
|-----|-------|
| `LINUX_API_TOKEN` | (ضع token قوياً وسرياً) |

---

## 🔗 ربطه بالذكاء الاصطناعي (سيرفر 1)

في إعدادات **سيرفر 1** (سيرفر الذكاء الاصطناعي)، أضف هذين:

| Key | Value |
|-----|-------|
| `LINUX_SERVER_URL` | `https://YOUR-USERNAME-linux-server.hf.space` |
| `LINUX_API_TOKEN` | نفس التوكن الذي وضعته في سيرفر 2 |

---

## 📡 API Endpoints

| Method | Endpoint | الوصف |
|--------|----------|-------|
| GET | `/api/status` | حالة السيرفر |
| POST | `/api/execute` | تنفيذ أمر Terminal |
| GET | `/api/sysinfo` | معلومات النظام (CPU/RAM/Disk) |
| GET | `/api/files/list` | قائمة الملفات |
| GET | `/api/files/read` | قراءة محتوى ملف |
| POST | `/api/files/write` | كتابة ملف |
| POST | `/api/files/delete` | حذف ملف/مجلد |
| GET | `/api/files/download` | تنزيل ملف |
| POST | `/api/files/upload` | رفع ملف |
| POST | `/api/run/python` | تشغيل كود Python |
| POST | `/api/run/javascript` | تشغيل كود JavaScript |

---

## 🔒 الأمان

كل endpoint يتطلب هذا الـ Header:
```
X-API-Token: YOUR_TOKEN_HERE
```

---

**By THE ZYZ STUDIO** 🎯