شو بيعمل DeerFlow بالضبط؟
بيوصفوه «SuperAgent harness»: مش نموذج، هيكل بيشغّل النموذج اللي بتختاره (Claude عندنا) مع:
الريبو: github.com/bytedance/deer-flow، الموقع deerflow.tech. النسخة الثانية طلعت بداية 2026 وهي اللي بنحكي عنها.
بدك Docker مركّب (Docker Desktop بيكفي). بدون Docker في طريقة محلية بالقسم 2.
الطريقة الأسهل: جملة وحدة لـ Claude Code
الريبو نفسه كاتب جملة لمساعدات البرمجة. افتح Claude Code بالمجلد اللي بدك تركّب فيه، والصقها حرفياً:
Help me clone DeerFlow if needed, then bootstrap it for local development by following https://raw.githubusercontent.com/bytedance/deer-flow/main/Install.md
- Claude بيقرأ ملف التركيب من الريبو، بيستنسخ المستودع لو مش موجود، وبيختار Docker لو لاقيه عندك.
- Claude بيجهّز ملفات الإعداد وبيسحب صورة الـ sandbox، وبعدها بيوقف وبيقلك بالضبط الأمر الجاي وأي مفاتيح ناقصة (ما بيفترض إن عندك مفاتيح).
- إنت بتحط مفتاح Anthropic (القسم 3)، وبتشغّل الأمر اللي قلّك عليه (غالباً make docker-start)، وبتفتح الواجهة.
بدك تحكي بالعربي؟ عادي: «ركّب لي DeerFlow حسب التعليمات بهالرابط، واستعمل Docker، ووقّف واسألني لما تحتاج مفتاح» والصق رابط Install.md نفسه بآخر الجملة.
الطريقة اليدوية: Docker (الموصى) أو محلي
1) استنسخ وشغّل معالج الإعداد:
git clone https://github.com/bytedance/deer-flow.git
cd deer-flow
make setup
make doctor
make setup معالج تفاعلي: بيسألك عن مزوّد النموذج (اختار Anthropic)، البحث على الويب (اختياري)، وصلاحيات التنفيذ (sandbox، أوامر bash، كتابة ملفات)، وبيكتب لك config.yaml و.env. وmake doctor بيفحص كل شي وبيعطيك تلميحات تصليح.
2أ) بـ Docker (الموصى، Compose 2.24 أو أحدث):
make docker-init
make docker-start
الأول بيسحب صورة الـ sandbox، والثاني بيشغّل كل شي. افتح http://localhost:2026. السجلات: make docker-logs. للإنتاج make up وmake down.
2ب) بدون Docker (محلي): بدك Node 22+، pnpm، uv، nginx:
make check
make install
make dev
نفس العنوان localhost:2026. بدون Docker ما في sandbox معزول، فالكود بيشتغل على جهازك مباشرة (make setup-sandbox اختياري بيضيفه).
اربطه بـ Claude
طريقتين، اختار وحدة:
أ) من الواجهة (زي الريل):
- إنت افتح الواجهة ← Settings ← Models.
- إنت اختار المزوّد Anthropic من القائمة الجاهزة، الصق API Key من console.anthropic.com، واكتب model ID: claude-sonnet-5-5 (أو claude-opus-5-5 للمهام الثقيلة).
- DeerFlow بيحفظه وبيصير متاح فوراً بقائمة النماذج. العناوين والتوثيق جاهزين من الـ preset، ما بتعدّل شي ثاني.
ب) من ملف الإعداد (للي بيحب يشوف كل شي): بـ config.yaml تحت models، ومفتاحك بملف .env كـ ANTHROPIC_API_KEY:
models:
- name: claude-sonnet-5-5
display_name: Claude Sonnet 5.5
use: langchain_anthropic:ChatAnthropic
model: claude-sonnet-5-5
api_key: $ANTHROPIC_API_KEY
max_tokens: 16000
context_window: 200000
supports_vision: true
بدك بحث ويب حقيقي؟ ضيف مفتاح محرّك بحث (مثلاً TAVILY_API_KEY) بـ .env، وبدونه بيشتغل على معرفة النموذج وأدوات الملفات بس.
ابدأ بمهمة مفهومة النتيجة، حتى تعرف تحكم عليه.
أول مهمة تجرّبها (وشو تتوقع)
المثال اللي بالريل، جاهز للصق بصندوق المحادثة:
ادرس سوق القهوة المختصة بالأردن: من هم اللاعبون الرئيسيون، نطاق الأسعار، شو بيطلب الزبائن بالمراجعات، وشو الفجوات.
اقترح خطة إطلاق لمحمصة صغيرة بعمّان (3 أشهر).
سلّمني: تقرير منظّم بالمصادر، جدول مقارنة، ورسم بياني واحد للأسعار. اسألني لو احتجت افتراضات.
- شو بتشوف: بيعرض خطة من خطوات، بيبدأ يبحث (بتشوف المصادر وهي بتتجمع)، بيكتب كود للجدول والرسم بالـ sandbox، وبالآخر بيعطيك الملفات. المهمة هاي بتاخد من 10 دقايق لنص ساعة حسب النموذج والبحث.
- بتقدر توقّفه وتصحّح: بأي لحظة اكتب له «ركّز على عمّان بس» أو «خلّي الأسعار بالدينار» وبيكمّل من مكانه.
- مهام ثانية بتنفع للبداية: «حوّل هالملف Excel لتقرير بصفحة ويب»، «اعمل مقارنة بين 5 أدوات X بجدول ومصادر»، «اكتب سكربت ينظّف هالبيانات وشغّله على الملف المرفق».
مهمة الريل توضيحية لنوع الشغل: النتيجة بتختلف حسب النموذج ومحرّك البحث، وراجع الأرقام قبل ما تبني عليها قرار.
شو بيكلّف فعلياً
| البند | الكلفة |
|---|---|
| DeerFlow نفسه | مجاني ومفتوح المصدر (MIT). بيشتغل على جهازك أو خادمك. |
| النموذج (Claude) | مدفوع حسب الاستهلاك عبر مفتاح الـ API. المهام الطويلة بتستهلك توكنز كثير لأنه بيقرأ صفحات وبيكرّر المحاولات: مهمة بحث متوسطة ممكن تكلّف من أقل من دولار لكم دولارات على Sonnet، وأكثر على Opus. |
| البحث على الويب | محرّكات البحث إلها خطط مجانية بعدد طلبات محدود، وبعدها مدفوع. |
| الجهاز | Docker Desktop + صورة الـ sandbox بدهم ذاكرة ومساحة (كم جيجا). لابتوب عادي بيكفي. |
نصيحة من تجربتي: حط حد إنفاق شهري بـ console.anthropic.com قبل ما تطلق مهمة بدها ساعات، وابدأ بمهام قصيرة لتشوف كم بتكلّف عندك.
أخطاء شائعة
| الغلطة | الصح |
|---|---|
| بتعطي الجملة لـ Claude Code بدون Docker | بيركّب محلي وبيطلب Node وpnpm وuv وnginx. ركّب Docker Desktop أول، وبعدها الجملة. |
| بتتخطى make doctor | هو اللي بيقلك ليش ما اشتغل (مفتاح ناقص، منفذ مشغول، Compose قديم). شغّله قبل ما تسأل. |
| مهمة أول يوم «ابني لي شركة» | مهمة واضحة النتيجة (تقرير، جدول، ملف). كل ما كان المخرج محدد، كل ما كان الوكيل أدق وأرخص. |
| بتعطيه صلاحيات كاملة على جهازك | خلّي الكود يشتغل بالـ sandbox (Docker). بالمحلي بدون sandbox، بيقدر يعدّل ملفاتك فعلاً. |
| بتبني على الأرقام بدون ما تفتح المصادر | التقرير فيه روابط لكل معلومة. افتح اللي بدك تعتمد عليه. الوكيل بيجمع، وإنت بتحكم. |
| بتترك مهمة طويلة بدون حد إنفاق | حد شهري بـ console.anthropic.com، ومتابعة من الواجهة أول مرتين. |