الانتقال إلى المحتوى الرئيسي

Documentation Index

Fetch the complete documentation index at: https://docs.wolffi.sh/llms.txt

Use this file to discover all available pages before exploring further.

التثبيت

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

Node.js (مطلوب)

إضافات قدرات Wolffish هي ملفات .mjs تنفَّذ في بيئة تشغيل Node.js. ثبّت Node.js 20+ من nodejs.org أو عبر مدير إصدارات مثل nvm أو fnm.
node --version   # يجب أن يكون v20.0.0 أو أعلى

Ollama (مطلوب)

يعتمد Wolffish على Ollama للاستدلال المحلي على نماذج اللغة الكبيرة — وهذا ليس اختياريًا. ثبّته من ollama.com.بعد التثبيت، نزّل نموذجًا:
ollama pull gemma3:4b
يكتشف Wolffish وجود Ollama تلقائيًا عند التشغيل ولن يعمل بدونه.
للحصول على ردود بجودة أعلى، أعدّ مفاتيح API لأحدهما أو كليهما:ستضبط هذه المفاتيح في إعدادات Wolffish بعد التثبيت. يحسّن مزودو السحابة الجودة لكنهم يتدرجون إلى Ollama عند الفشل.

التنزيل

نزّل أحدث ملف .dmg من صفحة الإصدارات.
  1. افتح ملف .dmg
  2. اسحب Wolffish إلى مجلد التطبيقات
  3. شغّل Wolffish من مجلد التطبيقات
عند التشغيل الأول، قد يحذّر macOS من مطور غير معرَّف. انقر بزر الفأرة الأيمن على التطبيق واختر “فتح” لتجاوز ذلك.

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

git clone https://github.com/younesalturkey/wolffish.git
cd wolffish
npm install
npm run dev
يتطلب البناء من المصدر Node.js 20+ وnpm. سيتم تجميع الوحدات الأصلية (better-sqlite3) أثناء npm install عبر electron-rebuild.

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

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