doppelganger

doppelgänger

ปัญหา: ผู้ดูแลโอเพนซอร์ซใช้เวลามากในการจัดการปัญหาซ้ำ/ที่เกี่ยวข้อง (doppelgänger) ปัญหาและคำขอดึง
สารละลาย: Doppelgängerเปรียบเทียบปัญหาที่ส่งใหม่/PRS กับปัญหาที่มีอยู่เพื่อตั้งค่าสถานะการทำซ้ำ/ที่เกี่ยวข้อง (doppelgänger) โดยอัตโนมัติ/PRS

หัวข้อ: เวกเตอร์ DB, GitHub, โอเพ่นซอร์ส, การค้นหาการฝัง, RAG, คะแนนความคล้ายคลึงกัน

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 ที่เราพิจารณาว่า "คล้ายกัน") สามารถกำหนดค่าได้และสามารถตั้งค่าเป็นทศนิยมระหว่าง 0 ถึง 1 [1]

Doppelganger จะปิดปัญหาใด ๆ เมื่อระยะห่างของโคไซน์ d ระหว่างปัญหาที่ส่งใหม่และปัญหาที่คล้ายกันมากที่สุดมากกว่าเกณฑ์นี้ มิฉะนั้นหากปัญหาที่ส่งมาใหม่มากกว่า (SIMILARTY_THRESHOLD*0.5) มันจะแสดงความคิดเห็นที่เป็นประโยชน์ซึ่งระบุปัญหาที่คล้ายกันมากที่สุด/เกี่ยวข้อง

[1] ระยะทางโคไซน์

ปัญหาและคำขอดึงจะถูกเก็บไว้ในคอลเลกชัน Chromadb ต่อที่เก็บ

ข้อกำหนดเบื้องต้น

• Python 3.8+
• บัญชี GitHub
• เซิร์ฟเวอร์หรือแพลตฟอร์มโฮสติ้งเพื่อเรียกใช้แอพ (เช่น Heroku, DigitalOcean, AWS)
• โอลลา

คำแนะนำการตั้งค่า

1. สร้างแอพ GitHub

1. ไปที่การตั้งค่าบัญชี GitHub ของคุณ
2. คลิกที่ "การตั้งค่านักพัฒนาซอฟต์แวร์" ในแถบด้านซ้าย
3. เลือก "แอพ GitHub" และคลิก "แอป GitHub ใหม่"
4. กรอกข้อมูลที่จำเป็น:
   • ชื่อแอพ GitHub: เลือกชื่อที่ไม่ซ้ำกัน (เช่น "ปัญหาการตรวจสอบความคล้ายคลึงกัน"))
   • URL หน้าแรก: เว็บไซต์แอพของคุณหรือโปรไฟล์ GitHub ของคุณ
   • Webhook URL: 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. เรียกใช้แอปพลิเคชันในเครื่อง

เริ่มแอปพลิเคชันขวด:

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: การใช้เชลล์สคริปต์กับโดเมน 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. ปิดและแสดงความคิดเห็นเกี่ยวกับปัญหาและ PR ที่คล้ายกันอย่างมากเพื่อลดการทำซ้ำ

การกำหนดค่า

คุณสามารถปรับเกณฑ์ความคล้ายคลึงกันได้โดยการปรับเปลี่ยนตัวแปร SIMILARITY_THRESHOLD ในสคริปต์ ค่าเริ่มต้นถูกตั้งค่าเป็น 0.5

การแก้ไขปัญหา

• ตรวจสอบบันทึกเซิร์ฟเวอร์สำหรับข้อความแสดงข้อผิดพลาดใด ๆ
• ตรวจสอบให้แน่ใจว่าตัวแปรสภาพแวดล้อมทั้งหมดได้รับการตั้งค่าอย่างถูกต้อง
• ตรวจสอบว่าไฟล์ rsa.pem มีอยู่และจัดรูปแบบอย่างถูกต้อง

การบริจาค

ยินดีต้อนรับ! โปรดส่งคำขอดึง

ใบอนุญาต

โครงการนี้ได้รับใบอนุญาตภายใต้ใบอนุญาต MIT

ประวัติดาว