Friday AI: دليل تركيب واستخدام وكيل الذكاء الاصطناعي الشخصي مفتوح المصدر
AI personal operations platform for supervised, evidence-backed automation.
خريطة الصفحة
اختر القسم الذي تحتاجه الآن
- ما هو Friday؟
- من يحتاج Friday؟
- المميزات الرئيسية
- المتطلبات الأساسية
- طريقة التركيب
- شرح ملف .env والمتغيرات
- تشغيل Friday لأول مرة
- أخطاء شائعة وحلولها
- استخدامات عملية
- هل يستحق التجربة؟
- بدائل مشابهة
- أسئلة شائعة
قبل أن تطبق
الفكرة التي تمنع التسرع
معظم أدوات الذكاء الاصطناعي السحابية تطلب منك التخلي عن بياناتك مقابل الراحة. Friday يعطيك التحكم الكامل: أنت من توافق على كل خطوة، والبيانات تبقى على جهازك.
أسئلة التشخيص السريع
قبل أن تطبق، اعرف أين تقف بالضبط
- هل لديك Node.js 18+ مثبت على جهازك؟
- هل تمتلك مفتاح OpenAI API صالح؟
- هل تفضل التثبيت عبر npm أم Docker؟
- هل جربت تشغيل الأمر 'friday' بعد التثبيت؟
- هل واجهت خطأ 'Cannot find module'؟
- هل تحتاج لاستخدام خدمات إضافية مثل Gmail أو Google Calendar؟
- هل تخطط لاستخدام Friday في بيئة إنتاج أم للتجربة فقط؟
نظام التشغيل: Input → Process → Output
لوحة قياس النجاح
لا تعتمد على الانطباع؛ اختر مؤشراً تراجعه
Friday هو وكيل ذكاء اصطناعي شخصي مفتوح المصدر، يعمل على جهازك الخاص، ويمنحك تحكماً كاملاً في المهام التي ينفذها. بدلاً من التفاعل مع شات بوت عادي، Friday يفهم هدفك، يخطط لتنفيذه، يستخدم أدوات مثل البريد الإلكتروني والتقويم، ويطلب موافقتك قبل كل خطوة. النتيجة: أتمتة آمنة وموثقة.
في هذا الدليل، ستتعلم كيفية تركيب Friday على جهازك باستخدام npm أو Docker، وتهيئته للعمل مع خدمات مثل Gmail وGoogle Calendar، وتشغيل أول مهمة له. سنغطي أيضاً الأخطاء الشائعة وكيفية تجنبها، ونقدم أمثلة عملية من واقع المطور العربي.
ما هو Friday؟
Friday هو منصة تشغيل شخصية للذكاء الاصطناعي، تركز على الأمان والتحكم البشري. يعمل محلياً (local-first)، ويدعم إضافة مفاتيح API خاصة بك (BYOK)، ويسجل أدلة على كل إجراء. الهدف: تحويل أهدافك إلى مهام منجزة مع إمكانية التراجع.
من يحتاج Friday؟
- مطور عربي يريد أتمتة مهام مثل إدارة الإيميلات أو جدولة المواعيد.
- صاحب مشروع صغير يحتاج مساعداً ذكياً يحترم خصوصية بياناته.
- صانع محتوى تقني يبحث عن أداة جديدة لشرحها لجمهوره.
المميزات الرئيسية
- محلي بالكامل: بياناتك لا تترك جهازك.
- الموافقة المسبقة: أنت من يوافق على كل خطوة.
- توثيق الأدلة: سجل كامل لكل إجراء.
- قابلية التوسع: إضافة أدوات جديدة بسهولة.
- دعم Docker و npm.
المتطلبات الأساسية
- Node.js 18+
- npm أو Docker
- مفتاح OpenAI API (أو أي مزود LLM مدعوم)
- نظام تشغيل: Windows, macOS, Linux
طريقة التركيب
التركيب عبر npm
npm install -g @thesongzhu/fridayالتركيب عبر Docker
git clone https://GitHub.com/thesongzhu/Friday.git
cd Friday
docker compose -f docker/docker-compose.yml up --buildشرح ملف .env والمتغيرات
أنشئ ملف .env في مجلد المشروع وأضف المتغيرات التالية (هذه هي المتغيرات المذكورة في README):
OPENAI_API_KEY=sk-...
# اختياري: مفاتيح لخدمات أخرى مثل Gmail, Calendarملاحظة: README لا يذكر متغيرات إضافية. إذا احتجت خدمات إضافية، راجع وثائق المشروع.
تشغيل Friday لأول مرة
بعد التثبيت، شغل الأمر:
fridayأو عبر Docker:
docker compose -f docker/docker-compose.yml upسيطلب منك Friday إدخال هدفك الأول. جرب: 'أرسل بريداً إلكترونياً لنفسك بعنوان اختبار'.
أخطاء شائعة وحلولها
استخدامات عملية
جدولة موعد في تقويم Google
قل: 'جدول اجتماع مع الفريق يوم الخميس الساعة 3 عصراً'. Friday سيطلب موافقتك ثم ينشئ الحدث.
الرد على إيميلات العمل
قل: 'رد على آخر إيميل من أحمد بقبول الاجتماع'. Friday سيعرض الرد للموافقة قبل الإرسال.
جمع بيانات من موقع ويب
قل: 'اجلب أسعار المنتجات من صفحة المتجر واحفظها في ملف'. Friday سينفذ المهمة ويعرض النتيجة.
هل يستحق التجربة؟
نعم، إذا كنت تبحث عن أتمتة آمنة وتحكم كامل. لكنه لا يزال مشروعاً حديثاً (أقل من 1000 نجمة)، لذا قد تواجه بعض الثغرات. مناسب للمطورين المتوسطين فما فوق.
بدائل مشابهة
أسئلة شائعة
هل Friday يدعم اللغة العربية؟
الواجهة بالإنكليزية، لكن يمكنه فهم الأوامر العربية إذا كان النموذج الأساسي (GPT) يدعمها. جرب واختبر.
ما الفرق بين Friday وAutoGPT؟
Friday يركز على التحكم البشري والأمان، بينما AutoGPT أكثر استقلالية.
هل يمكن استخدام Friday بدون إنترنت؟
Friday يحتاج اتصالاً بالإنترنت للتواصل مع API النموذج اللغوي. لكن يمكن تشغيله محلياً إذا استخدمت نموذجاً محلياً (غير مدعوم حالياً).
كيف أضيف أدوات جديدة؟
راجع وثائق المشروع على GitHub لمعرفة كيفية إضافة أدوات مخصصة.
هل Friday آمن للبيانات الحساسة؟
نعم، لأنه يعمل محلياً وتوافق على كل خطوة. لكن تأكد من عدم مشاركة مفتاح API مع الآخرين.
ما هي متطلبات النظام؟
أي نظام يدعم Node.js 18+ و Docker. ذاكرة RAM 4GB كحد أدنى.
هل Friday مجاني؟
المشروع مفتوح المصدر ومجاني، لكنك ستحتاج إلى مفتاح API من OpenAI (مدفوع حسب الاستخدام).
Playbook التطبيق
خطوات عملية مرتبة من التشخيص إلى النتيجة
تثبيت المتطلبات الأساسية
لماذا؟ Friday يعتمد على Node.js 18+ وDocker (اختياري) ومفتاح OpenAI API.
كيف؟ تحقق من إصدار Node.js باستخدام 'node -v'، وإذا لم يكن 18+ فقم بتثبيته من الموقع الرسمي. احصل على مفتاح OpenAI API من platform.openai.com.
الناتج: بيئة جاهزة للتثبيت.
تثبيت Friday عبر npm أو Docker
لماذا؟ npm أسرع للمستخدمين الفرديين، Docker أفضل للعزل والتكرار.
كيف؟ لـ npm: 'npm install -g @thesongzhu/friday'. لـ Docker: استنسخ المستودع ثم 'docker compose -f docker/docker-compose.yml up --build'.
الناتج: Friday مثبت وجاهز للتشغيل.
إعداد ملف .env
لماذا؟ Friday يحتاج لمفتاح API للتواصل مع النموذج اللغوي.
كيف؟ أنشئ ملف .env في مجلد المشروع وأضف 'OPENAI_API_KEY=sk-...' (استبدل بمفتاحك). أضف مفاتيح خدمات إضافية إذا لزم الأمر.
الناتج: Friday يمكنه الاتصال بـ OpenAI.
تشغيل Friday لأول مرة
لماذا؟ لتجربة الوكيل والتأكد من عمله.
كيف؟ شغل 'friday' في الطرفية (أو 'docker compose up' لـ Docker). سيطلب منك إدخال هدف، جرب 'أرسل بريداً إلكترونياً لنفسك بعنوان اختبار'.
الناتج: Friday ينفذ المهمة بعد موافقتك.
استكشاف الأخطاء وإصلاحها
لماذا؟ الأخطاء الشائعة قد تمنع التشغيل.
كيف؟ إذا ظهر خطأ 'Cannot find module'، شغل 'npm install' في مجلد المشروع. إذا ظهر 'API key not set'، تأكد من وجود OPENAI_API_KEY في .env. إذا فشل Docker build، حدث Docker.
الناتج: Friday يعمل بدون أخطاء.
قوالب جاهزة للنسخ
حوّل القراءة إلى تنفيذ سريع
OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx # أضف مفاتيح أخرى حسب الحاجة
git clone https://github.com/thesongzhu/Friday.git cd Friday docker compose -f docker/docker-compose.yml up --build
مصفوفة الأخطاء
اعرف أين يتعثر الناس وكيف تتجنب ذلك
شجرة القرار
ماذا تفعل حسب حالتك؟
إذا: إذا كنت تبحث عن أتمتة آمنة وتحكم كامل
إذن: Friday مناسب لك.
إذا: إذا كنت مطوراً مبتدئاً أو تفضل واجهة رسومية
إذن: قد يكون n8n أو AutoGPT خياراً أفضل.
إذا: إذا كنت بحاجة لاستخدام نموذج محلي بدون إنترنت
إذن: Friday لا يدعم ذلك حالياً، جرب LangChain مع نموذج محلي.
خطة تطبيق 7 أيام
جدول صغير يمنع التسويف
- اليوم 1: تثبيت المتطلبات و Friday
- اليوم 2: إعداد ملف .env وتشغيل أول مهمة
- اليوم 3: تجربة مهمة إرسال إيميل
- اليوم 4: تجربة مهمة جدولة تقويم
- اليوم 5: استكشاف الأخطاء الشائعة وحلها
- اليوم 6: تجربة مهمة جمع بيانات من موقع
- اليوم 7: تقييم التجربة واتخاذ قرار الاستمرار
حقائق سريعة تحفظها
نقاط مختصرة ترجع لها لاحقاً
1. Friday يعمل محلياً بالكامل، بياناتك لا تترك جهازك.
2. يتطلب Node.js 18+ ومفتاح OpenAI API.
3. يمكن تثبيته عبر npm أو Docker.
4. يدعم الموافقة المسبقة على كل خطوة.
5. يسجل أدلة على كل إجراء.
6. مناسب للمطورين المتوسطين فما فوق.
7. المشروع حديث (أقل من 1000 نجمة على GitHub).
8. الواجهة بالإنكليزية لكنه قد يفهم الأوامر العربية.
أسئلة شائعة
إجابات مباشرة على ما يبحث عنه الزائر
مصطلحات سريعة
تعريفات مختصرة تمنع الالتباس
برنامج يمكنه فهم الأهداف وتخطيط المهام وتنفيذها باستخدام أدوات، مع إشراف بشري.
البيانات والمعالجة تتم على جهاز المستخدم دون إرسالها إلى سحابة خارجية.
إمكانية استخدام مفتاح API الخاص بالمستخدم بدلاً من مفتاح افتراضي.
أسئلة مرتبطة يبحث عنها الناس
استخدمها كمسارات متابعة داخل نفس الموضوع
لماذا هذا المرجع يتجاوز الموضوع نفسه؟
تحول القارئ: من متلقٍ سلبي لأخبار التقنية إلى مستخدم نشط يجرب أدوات الذكاء الاصطناعي مفتوحة المصدر.
- أتمتة المهام باستخدام n8n
- إدارة الخوادم باستخدام Docker
- مقدمة في Node.js للمطورين العرب
كيف تستخدم هذا المرجع لاحقاً؟
القيمة الحقيقية تظهر عند العودة والتطبيق
لا تتعامل معه كمقال يُقرأ مرة واحدة. استخدمه كلوحة تشغيل: ارجع للتشخيص عند ظهور المشكلة، وللقوالب عند التطبيق، ولمؤشرات القياس عند المراجعة.
Friday يقدم نموذجاً مختلفاً لأتمتة المهام: أنت المسؤول، والوكيل ينفذ. جربه في مهمة بسيطة اليوم، وقرر بنفسك إذا كان يستحق أن يكون جزءاً من أدواتك اليومية. تذكر أن المشروع لا يزال في مراحله الأولى، لذا شارك ملاحظاتك مع المجتمع على GitHub.
خطة تحديث هذا الدليل
حتى يبقى المرجع صالحاً مع الوقت
- تحديث متطلبات Node.js عند إصدار إصدار جديد.
- مراجعة قائمة الأخطاء الشائعة كل شهر بناءً على تقارير المجتمع.
- إضافة أمثلة استخدام جديدة عند إضافة أدوات للمشروع.
- تحديث روابط GitHub إذا تغير المستودع.
التعليقات (0)
لا توجد تعليقات بعد. كن أول من يبدأ النقاش 👇