README.md

metadata

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. ثبّت المتطلبات:

   pip install -r requirements.txt
   

2. شغّل السيرفر:

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

ملاحظة مهمة

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