| --- |
| title: THE Z AI/AGENT |
| emoji: 🤖 |
| colorFrom: indigo |
| colorTo: purple |
| sdk: gradio |
| sdk_version: "4.44.1" |
| app_file: app.py |
| pinned: false |
| --- |
| |
| # THE Z AI/AGENT |
|
|
| واجهة ذكاء اصطناعي متعددة الأوضاع مبنية للنشر على Hugging Face Spaces. |
| # THE Z AI/AGENT — Hugging Face + itch.io package |
|
|
| هذا المشروع يحتوي على: |
| - `index.html` واجهة دردشة جاهزة |
| - `prompts/system_prompt.js` البرومبت الأساسي |
| - `prompts/coder_prompt.js` برومبت البرمجة الضخم |
| - `prompts/tier_prompts.js` أوضاع MINI / NORMAL / PRO / MAX |
| - `notifications.js` نظام الإشعارات |
| - `app.py` سيرفر Python لنشره على Hugging Face |
| - `requirements.txt` التبعيات |
| - `Dockerfile` للنشر بالحاوية |
|
|
| ## التشغيل محلياً |
| 1. ثبّت المتطلبات: |
| ```bash |
| pip install -r requirements.txt |
| ``` |
| 2. شغّل السيرفر: |
| ```bash |
| python app.py |
| ``` |
| 3. افتح: |
| `http://127.0.0.1:7860` |
|
|
| ## متغيرات البيئة |
| اختر واحداً من المزودين: |
|
|
| ### Groq |
| - `GROQ_API_KEY` |
| - `GROQ_MODEL` (اختياري) |
| - `GROQ_BASE_URL` (اختياري) |
|
|
| ### OpenRouter |
| - `OPENROUTER_API_KEY` |
| - `OPENROUTER_MODEL` (اختياري) |
| - `OPENROUTER_BASE_URL` (اختياري) |
| - `OPENROUTER_SITE_URL` (اختياري) |
| - `OPENROUTER_SITE_NAME` (اختياري) |
|
|
| ## النشر على Hugging Face Spaces |
| - اختر Space من نوع **Python**. |
| - ارفع الملفات كما هي. |
| - أضف المتغير السري في Settings. |
| - اترك `app.py` كملف التشغيل الرئيسي. |
|
|
| ## النشر على itch.io |
| - ارفع `index.html` مع مجلد `prompts/` و `notifications.js`. |
| - اضبط `window.ZAI_API_URL` داخل `index.html` إذا أردت توجيه الطلبات إلى سيرفر خارجي. |
|
|
| ## ملاحظة مهمة |
| الواجهة الأمامية لا تحتوي على مفاتيح سرية. |
| المفتاح يوضع فقط في السيرفر عبر المتغيرات البيئية. |
