---
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` إذا أردت توجيه الطلبات إلى سيرفر خارجي.

## ملاحظة مهمة
الواجهة الأمامية لا تحتوي على مفاتيح سرية. 
المفتاح يوضع فقط في السيرفر عبر المتغيرات البيئية.