doppelganger

Doppelgänger

مشكلة: يقضي محفوظون المصدر المفتوح الكثير من الوقت في إدارة المشكلات المكررة/ذات الصلة (Doppelgänger) وطلبات السحب
حل: يقارن Doppelgänger المشكلات المقدمة حديثًا/PRS ضد القضايا الحالية لإعلام تلقائيًا مكررة/ذات صلة (Doppelgänger)/PRS

الموضوعات: ناقل DB ، Github ، مفتوح المصدر ، البحث التضمين ، خرقة ، درجات التشابه

screen.recording.2024-04-27.at.4.57.11.pm.mov

هذا التطبيق عبارة عن تطبيق GitHub يقارن تلقائيًا المشكلات التي تم افتتاحها حديثًا مع القضايا الحالية ، والإغلاق والتعليق على المشكلات المتشابهة للغاية لتقليل الازدواجية. بالإضافة إلى ذلك ، يعلق على ملاحظات على PRS بناءً على العنوان والوصف للنقاط التي يجب مراعاتها.

وثائق Doppelganger

كيف تعمل

يتم تحويل كل issue['title'] والمسألة issue['body'] إلى تمثيل متجه باستخدام Minilm-L6-V2 .

يتم استمرار كل ناقل في chromadb ويقوم بالبحث عن التشابه باستخدام بحث تشابه جيب التمام المدمج في chromadb. جنبا إلى جنب مع كل متجه هي issue_id و issue['title'] المخزنة باستخدام حجة metadata Chromadb.

SIMILARITY_THRESHOLD d

ستقوم Doppelganger بإغلاق أي مشكلة عندما تكون مسافة جيب التمام d بين القضية المقدمة حديثًا والمسألة الأكثر تشابهًا من هذه العتبة. خلاف ذلك ، إذا كانت المشكلة المقدمة حديثًا أكبر من (Similarty_threshold*0.5) ، فستترك تعليقًا مفيدًا يشير إلى القضية الأكثر تشابهًا/ذات الصلة.

[1] مسافة جيب التمام

يتم تخزين المشكلات وطلبات السحب في مجموعات chromadb لكل مستودع.

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

• بيثون 3.8+
• حساب github
• خادم أو منصة استضافة لتشغيل التطبيق (على سبيل المثال ، Heroku ، Digitalocean ، AWS)
• أولاما

تعليمات الإعداد

1. إنشاء تطبيق github

1. انتقل إلى إعدادات حساب github الخاص بك.
2. انقر على "إعدادات المطور" في الشريط الجانبي الأيسر.
3. حدد "تطبيقات GitHub" وانقر فوق "تطبيق GitHub جديد".
4. املأ المعلومات المطلوبة:
   • اسم تطبيق Github: اختر اسمًا فريدًا (على سبيل المثال ، "Cumping Charicity Checker")
   • عنوان URL للصفحة الرئيسية: موقع الويب الخاص بك أو ملف تعريف github الخاص بك
   • عنوان URL لـ WebHook: عنوان URL حيث سيتم تشغيل الخادم الخاص بك (على سبيل المثال ، https://your-server.com/webhook)
   • Webhook Secret: قم بإنشاء سر آمن وحفظه للاستخدام لاحقًا
5. تعيين الأذونات:
   • أذونات المستودع:
     • القضايا: اقرأ واكتب
     • طلبات السحب: اقرأ واكتب
     • Webhooks: القراءة فقط
   • اشترك في الأحداث:
     • مشاكل
     • طلب سحب
6. قم بإنشاء التطبيق ولاحظ معرف التطبيق
7. قم بإنشاء مفتاح خاص وقم بتنزيله (ستحتاج إلى هذا لاحقًا)

2. قم بإعداد بيئتك

1. استنساخ هذا المستودع:

    git clone https://github.com/dannyl1u/doppelganger.git
   cd doppelganger
   

2. تثبيت التبعيات:

    pip install -r requirements.txt
   

3. لإنشاء ملف .env جديد ، قم بتشغيل الأمر التالي في المحطة الخاصة بك:

cp .env.example .env

افتح ملف .env الذي تم إنشاؤه حديثًا وقم بتحديث المتغيرات التالية بقيمك الخاصة:
* APP_ID : استبدل your_app_id_here بمعرف التطبيق الفعلي.
* WEBHOOK_SECRET : استبدل your_webhook_secret_here بسر webhook الفعلي.
* OLLAMA_MODEL : استبدل your_chosen_llm_model_here باستخدام نموذج LLM المختار (على سبيل المثال "llama3.2"). ملاحظة: يجب أن يكون نموذجًا مدعومًا لـ Ollama (انظر: https://ollama.com/library للنماذج المدعومة)
* NGROK_DOMAIN : استبدل your_ngrok_domain_here بمجال ngrok الخاص بك إذا كان لديك واحد 4. ضع المفتاح الخاص الذي تم تنزيله في جذر المشروع وتسميته rsa.pem .

5. قم بتشغيل التطبيق محليًا

ابدأ تطبيق Flask:

python3 app.py

سيبدأ التطبيق تشغيل على http: // localhost: 4000

3. إعداد التبعيات ونشر (تعليمات Ngrok و Ollama)

سوف نستخدم ngrok لبساطتها

الخيار 1: عنوان URL العام الذي تم إنشاؤه في نافذة طرفية جديدة ، ابدأ NGROK لإنشاء نفق آمن لخادمك المحلي:

ngrok http 4000

سيقوم Ngrok بإنشاء عنوان URL العام (على سبيل المثال ، https://abc123.ngrok.io)

إلحاق /webhook إلى عنوان URL ، على سبيل المثال https://abc123.ngrok.io -> https://abc123.ngrok.io/webhook

في نافذة طرفية أخرى ، ابدأ Ollama

ollama run < an OLLAMA model here >

الخيار 2: استخدام البرنامج النصي Shell مع مجال NGROK الخاص بك

تأكد من تعيين متغيرات البيئة.

./run-dev.sh

4. تحديث إعدادات تطبيق Github

1. ارجع إلى إعدادات تطبيق GitHub.
2. قم بتحديث عنوان URL لـ WebHook للإشارة إلى تطبيقك المنشور (على سبيل المثال ، https://abc123.ngrok.io/webhook).

5. قم بتثبيت تطبيق Github

1. انتقل إلى صفحة إعدادات تطبيق GitHub الخاصة بك.
2. في قسم "تثبيت التطبيق" ، انقر فوق "تثبيت التطبيق" أو "إضافة التثبيت".
3. اختر الحساب الذي تريد تثبيت التطبيق.
4. حدد المستودع (أو المستودعات) حيث تريد استخدام التطبيق.
5. تأكيد التثبيت.

الاستخدام

بمجرد التثبيت ، سيقوم التطبيق تلقائيًا:

1. مراقبة المشكلات الجديدة و PRS في المستودعات المختارة.
2. قارن المشكلات الجديدة و PRS مع تلك الموجودة باستخدام التشابه الدلالي.
3. أغلق والتعليق على القضايا المتشابهة للغاية و PRS للحد من الازدواجية.

إعدادات

يمكنك ضبط عتبة التشابه عن طريق تعديل متغير SIMILARITY_THRESHOLD في البرنامج النصي. يتم تعيين الافتراضي على 0.5.

استكشاف الأخطاء وإصلاحها

• تحقق من سجلات الخادم لأي رسائل خطأ.
• تأكد من تعيين جميع متغيرات البيئة بشكل صحيح.
• تحقق من أن ملف rsa.pem موجود وتنسيقه بشكل صحيح.

المساهمة

المساهمات مرحب بها! لا تتردد في تقديم طلب سحب.

رخصة

هذا المشروع مرخص بموجب ترخيص معهد ماساتشوستس للتكنولوجيا.

تاريخ النجوم