الصفحة الرئيسية>المتعلقة بالبرمجة>شفرة المصدر الأخرى
تنزيل

إشعار الأرشيف: نوصيك بالتحقق من OpenContracts للحصول على إصدار أكثر حداثة من هذا التطبيق يدمج هذا الفرع 0.10* من Llamaindex مع Django + PgVector لاستخدام Postgres كمتجر Vector. لا يزال هذا دليلًا رائعًا على مفهوم كيفية بناء تطبيق يعمل بنظام Django مع استجابات البث من نموذج لغة كبير ، ولكن لا يتم الحفاظ عليه.

ليس لدي الوقت الكافي للحفاظ عليه ويحتاج إلى عدد من الترقيات ليكون جاهزًا للإنتاج. اسمحوا لي أن أعرف إذا كنت مهتمًا بتولي الصيانة.

دلفي

إطار بسيط لاستخدام llamaindex لإنشاء ونشر وكلاء LLM التي يمكن استخدامها لتحليل ومعالجة البيانات النصية من المستندات.

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

الحصول على الإعداد

كلمة تحذير / ملاحظة

يعتمد الإصدار الأولي لـ Delphic فقط على API Openai. نخطط بالكامل لدعم نماذج اللغة الكبيرة الأخرى (LLMS) ، سواء كانت مستضافة ذاتيًا أو مدعومة من قبل واجهة برمجة تطبيقات الطرف الثالث. ومع ذلك ، في الوقت الحالي ، اعتبارًا من أبريل 2023 ، تظل واجهة برمجة تطبيقات AI من الذكاء الاصطناعي هي الأكثر قدرة وأسهل للنشر. نظرًا لأن هذا الإطار يعتمد على Llamaindex وهو متوافق تمامًا مع Langchain ، فسيكون من السهل جدًا استخدام LLMs الأخرى. ومع ذلك ، في الوقت الحالي ، سيتم معالجة النص الخاص بك باستخدام Openai ، حتى لو كنت تستضيف هذه الأداة. إذا تمثل شروط الخدمة الخاصة بـ Openai مشكلة بالنسبة لك ، فإننا نترك ذلك لك لحلها. نحن لسنا مسؤولين عن أي مشكلات تصل من استخدامك لهذه الأداة و API Openai.

البدء محليا

فقط قم بتشغيل التطبيق

أسرع طريقة للاستيقاظ والتشغيل هي استنساخ هذا الريبو ثم نشر التطبيق محليًا.

ستحتاج إلى Docker و Docker Compans لمتابعة هذه التعليمات. يحتوي DigitaloCean ، إلى جانب كونه مضيفًا سحابيًا ممتازًا ، على بعض الإرشادات الأسهل للمتابعة حول إعدادها. يرجى التحقق منها هنا أو الذهاب إلى تعليمات Docker الرسمية.

  1. أولاً ، استنساخ الريبو: 
 git clone
  1. ثم ، تغيير إلى الدليل: 
 cd delphic
  1. لا تنس نسخ ملف Env Sample إلى. 
 mkdir -p ./.envs/.local/
cp -a ./docs/sample_envs/local/.frontend ./frontend
cp -a ./docs/sample_envs/local/.django ./.envs/.local
cp -a ./docs/sample_envs/local/.postgres ./.envs/.local

  1. ثم قم بتحديث تكوين .django الخاص بك التالي (ربما تريد تحرير .postgres أيضًا لمنح مستخدم قاعدة البيانات كلمة مرور فريدة) لتضمين مفتاح API Openai الخاص بك

  2. ثم ، قم ببناء صور Docker: 

 sudo docker-compose --profile fullstack -f local.yml build
  1. أخيرًا ، لإطلاق التطبيق ، اكتب: 
 sudo docker-compose --profile fullstack -f local.yml up

انتقل إلى localhost:3000 لرؤية الواجهة الأمامية.

أريد تطوير / تعديل الواجهة الأمامية

إذا كنت ترغب في تطوير الواجهة الأمامية بنشاط ، فإننا نقترح ألا تستخدم --profile=fullstack علامة لأن كل تغيير سيتطلب إعادة بناء حاوية كاملة. بدلاً من ذلك ، راجع بيئة التطوير بدلاً من الخطوة رقم 5 أعلاه ،

إنتاج الإنتاج

هذا يفترض أنك ترغب في إتاحة التطبيق للإنترنت في نوع من المجال المؤهل تمامًا مثل delphic.opensource.legal. من أجل القيام بذلك ، تحتاج إلى تحديث تكوينات زوجين.

TODO - أدخل الوثائق

باستخدام التطبيق

إعداد المستخدمين

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

لماذا قم بإعداد Django Superuser؟ لدى Django Superuser جميع الأذونات في التطبيق ويمكنه إدارة جميع جوانب النظام ، بما في ذلك إنشاء وتعديل وحذف المستخدمين والمجموعات والبيانات الأخرى. يتيح لك إعداد Superuser التحكم بالكامل في التطبيق وإدارته.

تحذير / إخلاء المسئولية

** في الوقت الحالي ، سيكون لأي مستخدم يتم تسجيل الدخول أذونات كاملة. نحن نخطط لتنفيذ وحدة التحكم في الوصول الأكثر دقة والقائمة على الأدوار التي قمنا بتطويرها من أجل OpenContracts ، ولكن ، في الوقت الحالي ، ندرك أن أي شخص لديه أي نوع من بيانات اعتماد تسجيل الدخول يمكنه إنشاء مجموعات وحذفها. يستخدم إنشاء مجموعات أرصدة / تكاليف Openai

أولاً ، قم بإعداد Django Superuser:

  1. قم بتشغيل الأمر التالي لإنشاء Superuser: 
 sudo docker-compose -f local.yml run django python manage.py createsuperuser
  1. سيُطلب منك توفير اسم مستخدم وعنوان بريد إلكتروني وكلمة مرور لـ Superuser. أدخل المعلومات المطلوبة.

ثانيًا (إذا رغبت في ذلك) ، قم بإعداد مستخدمين إضافيين

ابدأ تطبيق Delphic محليًا بعد تعليمات النشر.

  1. تفضل بزيارة واجهة Django Admin عن طريق التنقل إلى http: // localhost: 8000/admin في متصفحك.
  2. قم بتسجيل الدخول مع بيانات اعتماد Superuser التي أنشأتها مسبقًا.
  3. انقر على رابط "المستخدمين" في قسم "المستخدمين".
  4. انقر فوق الزر "إضافة المستخدم +" في الزاوية اليمنى العليا.
  5. أدخل المعلومات المطلوبة للمستخدم الجديد ، مثل اسم المستخدم وكلمة المرور. انقر فوق "حفظ" لإنشاء المستخدم.
  6. لمنح المستخدم الجديد أذونات إضافية أو اجعله Superuser ، انقر على اسم المستخدم الخاص بهم في قائمة المستخدمين ، والتمرير لأسفل إلى قسم "الأذونات" ، وتكوين أذوناتهم وفقًا لذلك. احفظ التغييرات الخاصة بك.

إنشاء مجموعة والاستعلام عنها

تحذير - إذا كنت تستخدم Openai كمحرك LLM الخاص بك ، فسيستخدم أي تفاعل في مجموعة أرصدة API / تكلفة أموال التكلفة. إذا كنت تستخدم مفتاح Openai API الخاص بك ، فقد قبلت أيضًا شروط الخدمة الخاصة بهم والتي قد لا تكون مناسبة لحالة الاستخدام الخاصة بك. يرجى القيام باجتهادك.

للوصول إلى واجهة إجابة الأسئلة ، قم بإحضار Fullstack ، وانتقل إلى http://localhost:3000

delphic.demo.mp4

بيئة التنمية

إذا كنت ترغب في المساهمة في Delphic أو Roll Your Produe ، فستحتاج إلى التأكد من إعداد بيئة التطوير.

إعداد الخلفية

على الواجهة الخلفية ، ستحتاج إلى بيئة بيثون عاملة لتشغيل عمليات فحص تنسيق ما قبل الالتزام. يمكنك استخدام مترجم Python في النظام ، لكننا نوصي باستخدام Pyenv وإنشاء ENV الظاهري استنادًا إلى Python> = 3.10.

الإعداد قبل الالتزام

ثم ، في جذر الريبو المحلي ، قم بتشغيل هذه الأوامر: 

 pip install -r ./requirements/local.txt
pre-commit install

الآن ، عندما تقوم بتنظيم الالتزامات ، سيتم تشغيل تنسيق رمز OU AR تلقائيًا.

إجراء اختبارات

لدينا مجموعة اختبار أساسية في ./tests . يمكنك إجراء الاختبارات عن طريق الكتابة: 

 sudo docker-compose -f local.yml run django python manage.py test

إعداد الواجهة الأمامية

على الواجهة الأمامية ، نستخدم العقدة V18.15.0. نحن نفترض أنك تستخدم NVM. ليس لدينا أي اختبارات للواجهة حتى الآن (آسف).

الإعداد وإطلاق خادم تطوير العقدة

القرص المضغوط في دليل الواجهة الأمامية ، قم بتثبيت تبعيات الواجهة الأمامية وبدء تشغيل خادم تطوير ( ملاحظة ، نفترض أنك قمت بتثبيت NVM. إذا لم تقم بتثبيته الآن ): 

 cd frontend
nvm use
npm install yarn
yarn install

ستظهر كتابة yarn start خادم تطوير الواجهة الأمامية على http://localhost:3000 . لا تزال بحاجة إلى إطلاق الواجهة الخلفية حتى تعمل بشكل صحيح.

تشغيل الواجهة الخلفية Compose بدون علامة ملف تعريف fullstack

قم بتشغيل الواجهة الخلفية بدون علم Fullstack: 

 sudo docker-compose -f local.yml up
يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل