Skip to main content

​
بلا اعتماديات، فقط ثبّت

وولفيش تطبيق Electron مستقل بالكامل. لا حاجة لـ Node.js أو Python أو Docker. فقط ثبّت وشغّل.

​
المتطلبات المسبقة

مزوّد LLM (مطلوب واحد على الأقل)

يحتاج وولفيش مزوّد LLM واحد على الأقل للتفكير والاستجابة. يمكنك استخدام مزودي السحابة، أو نماذج محلية عبر Ollama، أو كليهما:ستضبط هذه في إعدادات وولفيش بعد التثبيت. تختار نموذج دماغك صراحةً — مزوّد سحابي أو Ollama المحلي — وهو من يعمل. لا يوجد احتياطي تلقائي بينهما. يمكنك استخدام مزودي السحابة فقط، أو العمل محليًا بالكامل باختيار Ollama نموذجَ دماغك.
Ollama يتيح لك تشغيل نماذج مفتوحة المصدر بالكامل على جهازك دون أي اعتماد على الإنترنت. يتكامل وولفيش معه مباشرة وسيساعدك في اختيار وتنزيل نموذج. لا حاجة لأوامر في الطرفية.Ollama ليس مطلوبًا — يمكنك استخدام وولفيش مع مزودي السحابة فقط (DeepSeek أو Claude أو OpenAI). لكن إن أردت العمل دون اتصال أو تفضّل إبقاء كل الاستدلال محليًا، ثبّت Ollama.
المهام الوكيلية الموثوقة (استخدام أدوات متعدد الخطوات) تتطلب نماذج كبيرة — 70B+ معامل (Llama 3 70B، Qwen 2.5 72B، DeepSeek-V2). تشغيلها يحتاج 48GB+ ذاكرة أو بطاقة GPU متقدمة. النماذج الأصغر (7B–14B) تعمل للمحادثات البسيطة لكنها تكافح مع سير عمل استدعاء الأدوات المعقد. راجع دليل تكامل Ollama للتفاصيل.
لقدرة computer-use، سيطلب macOS منك منح أذ��نات الوصول وتسجيل الشاشة. هذه مطلوبة فقط إذا أردت أن يتفاعل وولفيش مع شاشتك.

​
التنزيل

أسرع طريقٍ على أي منصة هو سكربت التثبيت — يختار الملف الصحيح لنظامك، ويتحقق منه، ويضع أمر الطرفية wolffish على PATH لديك:
أو ثبّت يدويًا:
نزّل أحدث ملف .dmg من صفحة التنزيل.
  1. افتح ملف .dmg
  2. اسحب وولفيش إلى مجلد التطبيقات
  3. شغّل وولفيش من مجلد التطبيقات
عند التشغيل الأول، قد يحذّر macOS من مطور غير معرَّف. انقر بزر الفأرة الأيمن على التطبيق واختر “فتح” لتجاوز ذلك.
أتُثبّت على خادمٍ بلا شاشة؟ أمر التثبيت نفسه يعمل على جهازٍ لا واجهة عرض له — متحقَّق منه من طرفٍ إلى طرف على Ubuntu 24.04 — وصفحة النشر على خادم تغطي خدمة الخلفية والتشغيل التلقائي واقتران هاتفك واجهةً.

​
ما المضمّن

لا تحتاج لتثبيت أي شيء آخر. Electron يضمّن Node.js وChromium داخلياً. يأتي التطبيق مع:
  • بيئة التشغيل (Node.js + Chromium)
  • أكثر من 20 قدرة مدمجة
  • SQLite (فهرس البحث FTS5)
  • جميع محولات القنوات (سطح المكتب، Telegram، WhatsApp)

​
المتطلبات حسب نظام التشغيل

أدوات النظام مثل ffmpeg وgit ليست متطلبات مسبقة. عندما تحتاج قدرة لأداة، يكتشف وولفيش أنها مفقودة ويعرض تثبيتها لك (عبر مدير حزم نظامك)، بموافقتك. الوكيل يدير التبعيات أثناء التشغيل.

​
البناء من المصدر

البناء من المصدر مخصص للمساهمين فقط. المستخدمون العاديون يجب أن يستخدموا المثبّتات الجاهزة أعلاه.
يتطلب البناء من المصدر Node.js 20+ وnpm. الوحدات الأصلية (better-sqlite3) تُجمّع أثناء npm install عبر electron-rebuild.

​
التحقق من التثبيت

عند التشغيل الأول، ينشئ وولفيش المجلد ~/.wolffish/workspace/ مع ملفات التكوين الافتراضية. ستوجّهك عملية الإعداد خلال اختيار نموذج والبدء. للتحقق من أن كل شيء يعمل:
  1. اتبع توجيهات الإعداد لاختيار وتنزيل نموذج
  2. أرسل رسالة تجريبية مثل “مرحباً، ماذا يمكنك أن تفعل؟”
  3. ينبغي أن ترى رداً متدفقاً
إذا لم يُكتشف Ollama، سيعرض عليك وولفيش إرشادك خلال تثبيته — أو يمكنك التخطي واستخدام مزودي السحابة بدلاً منه.

​
إلغاء التثبيت

جميع بيانات المستخدم موجودة في ~/.wolffish/. لإلغاء التثبيت بالكامل:
  1. احذف التطبيق
  2. أزل مجلد البيانات: rm -rf ~/.wolffish/