دليل Augur: تركيب واستخدام نظام تحليل استثماري متعدد الوكلاء مفتوح المصدر
🦉 Augur — 多智能体投资分析系统。13位虚拟投资大师独立分析，加权共识机制，Bloomberg风格Web仪表盘。
خريطة الصفحة
اختر القسم الذي تحتاجه الآن
- ما هو Augur؟
- من يحتاج Augur ومن لا؟
- المميزات الرئيسية
- المتطلبات الأساسية
- تركيب Augur خطوة بخطوة (Git clone + Docker)
- شرح ملف .env والمتغيرات المطلوبة
- تشغيل الواجهة الرسومية (Dashboard)
- تشغيل روبوت Telegram
- أخطاء شائعة وحلولها
- استخدامات عملية: تحليل سهم حقيقي
- هل يستحق Augur التجربة؟
- بدائل Augur
قبل أن تطبق
الفكرة التي تمنع التسرع
تعتقد أن تحليل الأسهم بالذكاء الاصطناعي يحتاج منصات مدفوعة أو خبرة عميقة؟ Augur يثبت العكس: 18 خبيرًا افتراضيًا يعملون مجانًا على جهازك.
أسئلة التشخيص السريع
قبل أن تطبق، اعرف أين تقف بالضبط
- هل لديك Docker و Docker Compose مثبتان على جهازك؟
- هل حصلت على مفتاح API صالح لـ LLM (مثل OpenAI)؟
- هل أنت على دراية بأساسيات سطر الأوامر؟
- هل تريد تحليل أسهم سعودية (TADAWUL) أم أمريكية؟
- هل تحتاج إلى تشغيل روبوت Telegram أم فقط الواجهة الرسومية؟
- هل واجهت مشكلة في تشغيل Dashboard على localhost:8000؟
- هل تبحث عن أداة تحليل أساسي أم فني؟
نظام التشغيل: Input → Process → Output
لوحة قياس النجاح
لا تعتمد على الانطباع؛ اختر مؤشراً تراجعه
تحليل الأسهم بشكل شامل يتطلب خبرة في التحليل الأساسي والفني، وفهم مؤشرات الاقتصاد الكلي، ومتابعة أخبار الشركات. Augur يقدم حلًا مختلفًا: 18 وكيل ذكاء اصطناعي يمثلون كبار المستثمرين (مثل وارن بافيت وراي داليو) يحللون السهم من زوايا متعددة ويخرجون بتوصية موحدة.
في هذا الدليل العملي، ستتعلم تركيب Augur على جهازك باستخدام Docker، وتشغيل الواجهة الرسومية وروبوت Telegram، وتحليل سهم حقيقي مثل أرامكو (2222) أو Apple (AAPL). كل الخطوات قابلة للتطبيق على نظام Linux أو Windows مع Docker.
ما هو Augur؟
Augur هو نظام تحليل استثماري متعدد الوكلاء (Multi-Agent Investment Analysis System) مفتوح المصدر، مكتوب بلغة Python. يقوم بمحاكاة 18 خبيرًا استثماريًا مشهورًا (مثل وارن بافيت، بنجامين جراهام، بيتر لينش، راي داليو) لتحليل أي سهم مدرج. كل خبير يطبق منهجيته الخاصة (مثل استثمار القيمة، النمو، الكلي) ثم تُدمج النتائج في توصية واحدة مع نسبة ثقة.
المشروع مرخص تحت MIT، مما يعني أنه مجاني تمامًا للاستخدام الشخصي والتجاري. يمكن تشغيله محليًا أو على سيرفر خاص، مما يمنحك تحكمًا كاملاً في بياناتك.
من يحتاج Augur ومن لا؟
هذا النظام مناسب لـ:
- مطور عربي يريد تجربة أنظمة AI متعددة الوكلاء في مجال المال
- مستثمر فردي يبحث عن أداة تحليل إضافية مجانية
- باحث في الذكاء الاصطناعي التطبيقي
لا يناسب:
- من يريد توصيات استثمارية مضمونة (Augur أداة تحليل وليس مستشارًا ماليًا)
- غير الملمين بأساسيات سطر الأوامر و Docker
- من يبحث عن تحليل فني متقدم (يركز على التحليل الأساسي)
المميزات الرئيسية
- 18 وكيل خبير بمنهجيات مختلفة
- آلية إجماع موزون مع Kelly Criterion لحساب حجم المركز
- واجهة ويب على شكل Dashboard (Bloomberg-style)
- روبوتات Telegram، Slack، WeChat، Lark
- دعم MCP (Model Context Protocol) للتكامل مع Claude وغيره
- مفتوح المصدر (MIT) ومجاني
المتطلبات الأساسية
- نظام تشغيل: Linux (موصى به) أو Windows مع WSL2
- Docker و Docker Compose مثبتين
- Python 3.8+ (للتثبيت بدون Docker)
- مفتاح API لـ LLM (مثل OpenAI أو Anthropic) – راجع ملف .env
- ذاكرة عشوائية 4GB RAM على الأقل
تركيب Augur خطوة بخطوة (Git clone + Docker)
الطريقة الموصى بها هي استخدام Docker Compose، لأنها تضمن تشغيل جميع المكونات دون تعارض.
- استنساخ المستودع:
git clone https://GitHub.com/BruceLanLan/augur.git && cd augur - إنشاء ملف .env (انظر القسم التالي)
- تشغيل Dashboard:
docker compose up -d dashboard - الوصول للواجهة: افتح المتصفح على
http://localhost:8000
إذا أردت تشغيل روبوت Telegram:
- تأكد من تعيين
TELEGRAM_TOKENفي .env - شغل الأمر:
docker compose --profile telegram up -d
شرح ملف .env والمتغيرات المطلوبة
أنشئ ملفًا باسم .env في المجلد الرئيسي للمشروع، وأضف المتغيرات التالية (القيم بين قوسين هي أمثلة):
# مفتاح API لـ LLM (مطلوب)
OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
# أو ANTHROPIC_API_KEY إذا كنت تستخدم Claude
# توكن بوت Telegram (اختياري)
TELEGRAM_TOKEN=1234567890:ABCdefGHIjklmNOPqrStuVWXyz
# إعدادات أخرى (اختياري)
AUGUR_PORT=8000
ملاحظة: المتغيرات الفعلية قد تختلف حسب إصدار Augur. راجع ملف .env.example في المستودع إن وجد.
تشغيل الواجهة الرسومية (Dashboard)
بعد تشغيل الأمر docker compose up -d dashboard، انتظر حتى تظهر الحاويات (يمكنك التحقق بـ docker ps). ثم افتح http://localhost:8000. ستظهر واجهة تشبه Bloomberg Terminal، يمكنك إدخال رمز السهم (مثل AAPL) والضغط على Analyze.
تشغيل روبوت Telegram
لتفعيل البوت:
- أنشئ بوتًا عبر BotFather واحصل على التوكن
- أضف
TELEGRAM_TOKENإلى ملف .env - شغل الأمر:
docker compose --profile telegram up -d - أرسل رمز السهم للبوت (مثل AAPL) وستصلك النتائج
أخطاء شائعة وحلولها
استخدامات عملية: تحليل سهم حقيقي
مثال: تحليل سهم أرامكو السعودية (TADAWUL: 2222.SR)
- افتح Dashboard على localhost:8000
- أدخل
2222.SRفي حقل البحث - اضغط Analyze
- انتظر حتى يكمل 18 وكيل التحليل (قد يستغرق دقيقة)
- شاهد النتائج: توصية كل خبير، الإجماع، ونسبة الثقة
مثال آخر: تحليل Apple (AAPL) بنفس الطريقة.
هل يستحق Augur التجربة؟
نعم، إذا كنت مطورًا أو مستثمرًا يريد أداة تحليل إضافية مجانية ومفتوحة المصدر. لكنه ليس بديلاً عن مستشار مالي، ولا يضمن أرباحًا. استخدمه كأداة مساعدة مع مصادر أخرى.
بدائل Augur
- FinBERT: نموذج لتحليل المشاعر المالية، لكنه ليس متعدد الوكلاء
- StockNews API: خدمة مدفوعة لتحليل الأخبار
- Yahoo Finance API: بيانات مالية مجانية لكن بدون تحليل
أسئلة شائعة
هل Augur مجاني؟
نعم، المشروع مفتوح المصدر برخصة MIT. تحتاج فقط لتوفير مفاتيح API للـ LLM.
ما هي متطلبات التشغيل (RAM, CPU)؟
4GB RAM و CPU ثنائي النواة كافٍ للتجربة. يفضل 8GB للاستخدام المكثف.
هل يمكن استخدام Augur لتحليل الأسهم السعودية؟
نعم، طالما أن السهم مدرج في TADAWUL وله رمز مثل 2222.SR. لكن دقة التحليل تعتمد على جودة البيانات المتاحة للـ LLM.
ما هي مفاتيح API المطلوبة؟
مفتاح OpenAI (أو Anthropic) هو الأساس. اختياريًا Telegram token للبوت.
كيف أضيف محللين جدد؟
يتطلب تعديل كود Python، غير موصى به للمبتدئين. يمكنك تعديل أوزان المحللين الحاليين عبر الإعدادات.
هل يدعم Augur التحليل الفني؟
لا، يركز على التحليل الأساسي (القيمة، النمو، المخاطرة). يمكنك إضافة بيانات فنية يدويًا.
ماذا أفعل إذا لم يعمل Dashboard؟
تأكد من تشغيل Docker، وأعد تشغيل الحاوية، وتحقق من السجلات بـ docker logs augur-dashboard.
هل يمكن استخدام Augur بدون Docker؟
نعم، عبر تثبيت Python مباشرة: pip install -e ".[data]" ثم تشغيل augur dashboard. لكن Docker أسهل وأقل عرضة للمشاكل.
Playbook التطبيق
خطوات عملية مرتبة من التشخيص إلى النتيجة
استنساخ المستودع
لماذا؟ للحصول على كود Augur على جهازك
كيف؟ git clone https://github.com/BruceLanLan/augur.git && cd augur
الناتج: مجلد augur يحتوي على ملفات المشروع
إنشاء ملف .env
لماذا؟ لتزويد Augur بمفاتيح API والإعدادات
كيف؟ انسخ .env.example إلى .env وعدّل القيم (OPENAI_API_KEY إلزامي)
الناتج: ملف .env صالح
تشغيل Dashboard
لماذا؟ لبدء الواجهة الرسومية لتحليل الأسهم
كيف؟ docker compose up -d dashboard
الناتج: حاوية dashboard تعمل على المنفذ 8000
فتح الواجهة
لماذا؟ للوصول إلى Dashboard وتحليل سهم
كيف؟ افتح المتصفح على http://localhost:8000
الناتج: واجهة Bloomberg-style جاهزة
تحليل سهم
لماذا؟ لتجربة التحليل متعدد الوكلاء
كيف؟ أدخل رمز السهم (مثل AAPL أو 2222.SR) واضغط Analyze
الناتج: توصية موحدة مع نسبة ثقة
قوالب جاهزة للنسخ
حوّل القراءة إلى تنفيذ سريع
OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx AUGUR_PORT=8000
docker compose up -d dashboard
docker compose --profile telegram up -d
مصفوفة الأخطاء
اعرف أين يتعثر الناس وكيف تتجنب ذلك
شجرة القرار
ماذا تفعل حسب حالتك؟
إذا: إذا كنت تريد تحليل سهم سعودي
إذن: استخدم الرمز 2222.SR (أرامكو) أو أي رمز TADAWUL
إذا: إذا واجهت مشكلة في Dashboard
إذن: تحقق من سجلات الحاوية: docker logs augur-dashboard
إذا: إذا لم يكن لديك Docker
إذن: ثبّت Python مباشرة: pip install -e ".[data]" ثم augur dashboard
خطة تطبيق 7 أيام
جدول صغير يمنع التسويف
- اليوم 1: تثبيت Docker و git clone
- اليوم 2: إنشاء ملف .env بمفتاح OpenAI
- اليوم 3: تشغيل Dashboard واختبار localhost:8000
- اليوم 4: تحليل سهم AAPL ومراجعة النتائج
- اليوم 5: تحليل سهم سعودي 2222.SR
- اليوم 6: تشغيل Telegram bot (اختياري)
- اليوم 7: مقارنة النتائج مع تحليلك الخاص
حقائق سريعة تحفظها
نقاط مختصرة ترجع لها لاحقاً
1. Augur يحاكي 18 خبيرًا استثماريًا مثل بافيت وجراهام.
2. يستخدم Kelly Criterion لحساب حجم المركز.
3. الواجهة تشبه Bloomberg Terminal.
4. يدعم روبوتات Telegram و Slack و WeChat.
5. مرخص تحت MIT ومجاني تمامًا.
6. يتطلب 4GB RAM و CPU ثنائي النواة.
7. يمكن تشغيله بدون Docker عبر Python مباشرة.
8. لا يدعم التحليل الفني، فقط الأساسي.
9. دقة التحليل تعتمد على جودة بيانات LLM.
أسئلة شائعة
إجابات مباشرة على ما يبحث عنه الزائر
مصطلحات سريعة
تعريفات مختصرة تمنع الالتباس
نظام متعدد الوكلاء: مجموعة من وكلاء الذكاء الاصطناعي يعملون معًا لحل مشكلة.
معيار كيلي: صيغة رياضية لتحديد حجم الرهان الأمثل لتعظيم النمو على المدى الطويل.
Model Context Protocol: بروتوكول لتكامل النماذج اللغوية مع أدوات خارجية.
أداة لتعريف وتشغيل تطبيقات Docker متعددة الحاويات.
أسئلة مرتبطة يبحث عنها الناس
استخدمها كمسارات متابعة داخل نفس الموضوع
لماذا هذا المرجع يتجاوز الموضوع نفسه؟
تحول القارئ: من قارئ يبحث عن أداة تحليل أسهم مجانية إلى مستخدم قادر على تركيب Augur وتشغيله وتحليل الأسهم بنفسه
- نظم متعددة الوكلاء في الروبوتات
- تحليل المشاعر في وسائل التواصل
- إدارة المحافظ الاستثمارية
كيف تستخدم هذا المرجع لاحقاً؟
القيمة الحقيقية تظهر عند العودة والتطبيق
لا تتعامل معه كمقال يُقرأ مرة واحدة. استخدمه كلوحة تشغيل: ارجع للتشخيص عند ظهور المشكلة، وللقوالب عند التطبيق، ولمؤشرات القياس عند المراجعة.
Augur أداة قوية ومجانية لتحليل الأسهم بأسلوب متعدد الوكلاء. باتباع هذا الدليل، يمكنك تركيبها وتشغيلها في أقل من 30 دقيقة. تذكر أنها أداة مساعدة وليست بديلاً عن البحث الشخصي أو الاستشارة المالية المهنية. جربها على أسهم تعرفها، وقارن النتائج مع تحليلك الخاص.
إذا واجهت أي مشكلة، راجع قسم الأخطاء الشائعة أو ابحث في Issues على GitHub. شارك تجربتك مع المجتمع العربي لتطوير المحتوى التقني.
خطة تحديث هذا الدليل
حتى يبقى المرجع صالحاً مع الوقت
- تحقق من تحديثات المستودع على GitHub أسبوعيًا.
- تحديث مفاتيح API إذا انتهت صلاحيتها.
- مراجعة قائمة المحللين إذا أضاف المشروع وكلاء جدد.
- تحديث ملف .env عند إضافة متغيرات جديدة.
التعليقات (0)
لا توجد تعليقات بعد. كن أول من يبدأ النقاش 👇