إذا كنت مطوراً عربياً وتبحث عن أداة تمنحك تحكماً دقيقاً في وكلاء AI دون الحاجة لمراقبتهم طوال الوقت، فـ Fabro هو ما تحتاجه. هذا الدليل يشرح لك ما هو Fabro، كيف تثبته (مع العلم أن README غير واضح، لذا الخطوات تقريبية)، وكيف تستخدمه في مشاريعك الواقعية في السوق السعودي والخليجي.

سنكون صريحين: Fabro ليس للمبتدئين، ويتطلب خبرة في Docker وRust ومفاتيح API. لكن إذا كنت مستعداً، فهذا الدليل سيوفر لك الوقت ويجنبك الأخطاء الشائعة.

ما هو Fabro؟ (مصنع البرمجيات المظلم)

Fabro هو أداة مفتوحة المصدر (MIT) تتيح لك تعريف عملية تطوير البرمجيات كرسم بياني (graph) وتفويض تنفيذه لوكلاء AI. الفكرة: بدلاً من أن تراقب الوكيل في كل خطوة، تحدد أنت نقاط القرار المهمة وتترك الباقي للوكيل. هذا يقلل من الفوضى ويزيد الثقة في المخرجات.

من يحتاج Fabro ومن لا؟

يناسبك إذا: مطور متوسط إلى متقدم، لديك مشروع برمجي معقد، تريد أتمتة أجزاء منه دون فقدان السيطرة. لا يناسبك إذا: مبتدئ، لا تعرف Docker أو Rust، أو تبحث عن أداة جاهزة بدون إعداد.

المميزات الرئيسية

• تحكم دقيق في سير العمل عبر رسم بياني
• نقاط تدخل بشري مدمجة
• مفتوح المصدر (MIT)
• متكامل مع Claude Code
• مكتوب بلغة Rust (أداء عالٍ)

المتطلبات الأساسية

• نظام تشغيل: Linux أو macOS (Windows عبر WSL2)
• Docker مثبت
• Rust وCargo مثبتان
• مفتاح API لـ Claude (Anthropic)
• معرفة أساسية بـ YAML/JSON

خطوات التركيب التقريبية

تنبيه: README الرسمي غير واضح، الخطوات أدناه تقريبية بناءً على بنية المشروع وقد تتغير.

1. استنساخ المستودع: git clone https://github.com/fabro-sh/fabro.git
2. الدخول إلى المجلد: cd fabro
3. تثبيت التبعيات: cargo build --release (قد يستغرق وقتاً)
4. إعداد ملف .env (انظر القالب أدناه)
5. تشغيل Fabro: ./target/release/fabro أو cargo run

شرح ملف .env والمتغيرات المطلوبة

أنشئ ملف .env في جذر المشروع بالمحتوى التالي (استبدل القيم بمفاتيحك):

ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxx
FABRO_WORKFLOW_DIR=./workflows
FABRO_LOG_LEVEL=info

• ANTHROPIC_API_KEY: مفتاح API من Anthropic (Claude). احصل عليه من console.anthropic.com.
• FABRO_WORKFLOW_DIR: المجلد الذي يحتوي على ملفات سير العمل (YAML/JSON).
• FABRO_LOG_LEVEL: مستوى التسجيل (debug, info, warn, error).

تشغيل Fabro لأول مرة

بعد إعداد .env، شغّل cargo run. إذا ظهر خطأ، تأكد من تثبيت Docker وRust بشكل صحيح. أول تشغيل قد يستغرق وقتاً لتحميل التبعيات.

أخطاء شائعة وحلولها

استخدامات عملية: مثال من السوق السعودي

مثال: شركة ناشئة سعودية تريد أتمتة مراجعة الكود. يمكن تعريف سير عمل يتضمن: (1) تحليل المتطلبات، (2) كتابة الكود، (3) مراجعة بشرية، (4) اختبارات آلية. باستخدام Fabro، يرسل الوكيل الكود للمراجعة البشرية فقط في الخطوة 3، مما يوفر وقت المطورين.

هل يستحق Fabro التجربة؟ (تقييم موضوعي)

المميزات: تحكم دقيق، مفتوح المصدر، أداء عالٍ. العيوب: README غير واضح، منحنى تعلم حاد، يتطلب مفاتيح API مدفوعة، مجتمع صغير حالياً. الخلاصة: مناسب للمطورين المتقدمين الذين يريدون تجربة أداة واعدة، لكن ليس للمشاريع الإنتاجية بعد.

بدائل Fabro: مقارنة سريعة

أسئلة شائعة (FAQ)

هل Fabro مجاني؟

نعم، الأداة مفتوحة المصدر ومجانية، لكنك ستحتاج لمفتاح API لـ Claude (مدفوع).

ما هي لغات البرمجة التي يدعمها؟

يدعم أي لغة يمكن لـ Claude التعامل معها، لكنه مكتوب بلغة Rust.

هل يمكن استخدامه مع نماذج AI غير Claude؟

حالياً يدعم Claude فقط، لكن قد تتوسع الخيارات مستقبلاً.

ما الفرق بين Fabro وCrewAI؟

CrewAI يركز على فريق وكلاء متعاونين، بينما Fabro يركز على سير عمل محدد بنقاط تدخل بشري.

هل Fabro مناسب للمبتدئين؟

لا، يتطلب خبرة في Docker وRust ومفاتيح API.

كيف أحصل على مفتاح API لـ Claude؟

سجّل في console.anthropic.com واحصل على مفتاح (قد يتطلب بطاقة ائتمان).

هل يدعم اللغة العربية في الأوامر؟

نظرياً نعم، لكن التجربة محدودة.

ماذا أفعل إذا واجهت خطأ في التثبيت؟

راجع قسم الأخطاء الشائعة أعلاه، أو ابحث في Issues على GitHub.

خاتمة: الخطوات التالية

Fabro أداة واعدة لكنها لا تزال في مراحلها المبكرة. إذا كنت مطوراً متقدماً وتبحث عن تحكم دقيق في وكلاء AI، جربها على مشروع جانبي. وإذا واجهت مشاكل، شاركها في مجتمع Discord. المستقبل يبدو مشرقاً لهذه الأداة.