NekoImageGallery

NekoImageGallery

محرك بحث صور AI عبر الإنترنت يعتمد على نموذج Clip وقاعدة بيانات ناقلات Qdrant. يدعم البحث عن الكلمات الرئيسية والبحث عن الصور المشابهة.

中文文档

سمات

• استخدم نموذج Clip لإنشاء متجهات ذات 768 بُعدًا لكل صورة كأساس للبحث. لا حاجة للتعليق اليدوي أو التصنيف، فئات تصنيف غير محدودة.
• يتم دعم البحث عن النص بتقنية OCR، استخدم PaddleOCR لاستخراج النص من الصور واستخدم BERT لإنشاء متجهات نصية للبحث.
• استخدم قاعدة بيانات ناقلات Qdrant للبحث الفعال عن المتجهات.

?لقطات الشاشة

قد تحتوي لقطات الشاشة المذكورة أعلاه على صور محمية بحقوق الطبع والنشر لفنانين مختلفين، يرجى عدم استخدامها لأغراض أخرى.

✈️ النشر

النشر المحلي

اختر طريقة تخزين البيانات الوصفية

قاعدة بيانات Qdrant (مستحسن)

في معظم الحالات، نوصي باستخدام قاعدة بيانات Qdrant لتخزين البيانات التعريفية. توفر قاعدة بيانات Qdrant أداءً فعالاً في الاسترجاع وقابلية توسع مرنة وأمانًا أفضل للبيانات.

برجاء نشر قاعدة بيانات Qdrant وفقًا لوثائق Qdrant. يوصى باستخدام Docker للنشر.

إذا كنت لا ترغب في نشر Qdrant بنفسك، فيمكنك استخدام الخدمة عبر الإنترنت التي تقدمها Qdrant.

تخزين الملفات المحلية

يقوم تخزين الملفات المحلية مباشرة بتخزين بيانات تعريف الصورة (بما في ذلك ناقلات الميزات، وما إلى ذلك) في قاعدة بيانات SQLite محلية. يوصى به فقط لعمليات النشر على نطاق صغير أو عمليات النشر التطويرية.

لا يتطلب تخزين الملفات المحلية عملية نشر إضافية لقاعدة البيانات، ولكن له العيوب التالية:

• لا يقوم التخزين المحلي بفهرسة المتجهات وتحسينها، وبالتالي فإن التعقيد الزمني لجميع عمليات البحث هو O(n) . ولذلك، إذا كان حجم البيانات كبيرًا، سينخفض ​​أداء البحث والفهرسة.
• سيؤدي استخدام تخزين الملفات المحلي إلى جعل NekoImageGallery ذا حالة، وبالتالي سيفقد قابلية التوسع الأفقي.
• عندما تريد الترحيل إلى قاعدة بيانات Qdrant للتخزين، قد يكون من الصعب ترحيل بيانات التعريف المفهرسة مباشرةً.

نشر NekoImageGallery

1. انسخ دليل المشروع إلى جهاز الكمبيوتر أو الخادم الخاص بك، ثم قم بالخروج إلى علامة إصدار محددة (مثل v1.0.0 ).
2. يوصى بشدة بتثبيت التبعيات المطلوبة لهذا المشروع في بيئة Python venv الافتراضية. قم بتشغيل الأمر التالي:

   python -m venv .venv
   . .venv/bin/activate

3. قم بتثبيت باي تورش. اتبع وثائق PyTorch لتثبيت إصدار الشعلة المناسب لنظامك باستخدام النقطة.

   إذا كنت تريد استخدام تسريع CUDA للاستدلال، فتأكد من تثبيت إصدار PyTorch المدعوم من CUDA في هذه الخطوة. بعد التثبيت، يمكنك استخدام torch.cuda.is_available() لتأكيد ما إذا كان CUDA متاحًا أم لا.

4. تثبيت التبعيات الأخرى المطلوبة لهذا المشروع:

   pip install -r requirements.txt

5. قم بتعديل ملف تكوين المشروع داخل config/ ، ويمكنك تحرير default.env مباشرةً، ولكن يوصى بإنشاء ملف جديد باسم local.env وتجاوز التكوين في default.env .
6. قم بتشغيل هذا التطبيق:

   python main.py

   يمكنك استخدام --host لتحديد عنوان IP الذي تريد الارتباط به (الافتراضي هو 0.0.0.0) و-- --port لتحديد المنفذ الذي تريد الارتباط به (الافتراضي هو 8000).
   يمكنك رؤية جميع الأوامر والخيارات المتاحة عن طريق تشغيل python main.py --help .
7. (اختياري) نشر تطبيق الواجهة الأمامية: NekoImageGallery.App هو تطبيق واجهة ويب بسيط لهذا المشروع. إذا كنت تريد نشره، فيرجى الرجوع إلى وثائق النشر الخاصة به.

؟ نشر عامل الميناء

حول صور عامل الميناء

تم إنشاء صورة عامل الإرساء الخاصة بـ NekoImageGallery وإصدارها على Docker Hub، بما في ذلك متغيرات الخدمة:

العلامات	وصف	أحدث حجم الصورة
edgeneko/neko-image-gallery:<version> edgeneko/neko-image-gallery:<version>-cuda edgeneko/neko-image-gallery:<version>-cuda12.1	يدعم الاستدلال GPU مع CUDA12.1
edgeneko/neko-image-gallery:<version>-cuda11.8	يدعم الاستدلال GPU مع CUDA11.8
edgeneko/neko-image-gallery:<version>-cpu	يدعم فقط استنتاج وحدة المعالجة المركزية

حيث <version> هو رقم الإصدار أو الاسم المستعار لإصدار NekoImageGallery، كما يلي:

إصدار	وصف
latest	أحدث نسخة مستقرة من NekoImageGallery
v*.*.* / v*.*	رقم الإصدار المحدد (يتوافق مع علامات Git)
edge	قد يحتوي الإصدار الأحدث من NekoImageGallery على ميزات غير مستقرة وتغييرات معطلة

في كل صورة، قمنا بتجميع التبعيات الضرورية، وأوزان نماذج openai/clip-vit-large-patch14 ، وأوزان نماذج bert-base-chinese ونماذج easy-paddle-ocr لتوفير صورة كاملة وجاهزة للاستخدام.

تستخدم الصور /opt/NekoImageGallery/static كوحدة تخزين لتخزين ملفات الصور، وتثبيتها على المجلد أو الدليل الخاص بك إذا كان التخزين المحلي مطلوبًا.

بالنسبة للتكوين، نقترح استخدام متغيرات البيئة لتجاوز التكوين الافتراضي. يمكن توفير الأسرار (مثل الرموز المميزة لواجهة برمجة التطبيقات) من خلال أسرار عامل الإرساء.

إعداد nvidia-container-runtime (لمستخدمي CUDA فقط)

إذا كنت تريد استخدام تسريع CUDA، فأنت بحاجة إلى تثبيت nvidia-container-runtime على نظامك. يرجى الرجوع إلى الوثائق الرسمية للتثبيت.

الوثيقة ذات الصلة:

1. https://docs.docker.com/config/containers/resource_constraints/#gpu
2. https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/install-guide.html#docker
3. https://nvidia.github.io/nvidia-container-runtime/

قم بتشغيل الخادم

1. قم بتنزيل ملف docker-compose.yml من المستودع.

    # For cuda deployment (default)
   wget https://raw.githubusercontent.com/hv0905/NekoImageGallery/master/docker-compose.yml
   # For CPU-only deployment
   wget https://raw.githubusercontent.com/hv0905/NekoImageGallery/master/docker-compose-cpu.yml && mv docker-compose-cpu.yml docker-compose.yml

2. قم بتعديل ملف docker-compose.yml حسب الحاجة
3. قم بتشغيل الأمر التالي لبدء الخادم:

    # start in foreground
   docker compose up
   # start in background(detached mode)
   docker compose up -d

تحميل الصور إلى NekoImageGallery

هناك طرق عديدة لتحميل الصور إلى NekoImageGallery

• من خلال واجهة الويب: يمكنك استخدام واجهة الويب لتحميل الصور إلى الخادم. يتم توفير واجهة الويب بواسطة NekoImageGallery.App. تأكد من تمكين Admin API وتعيين رمز المشرف الخاص بك في ملف التكوين.
• من خلال الفهرسة المحلية: هذا مناسب للنشر المحلي أو عندما تكون الصور التي تريد تحميلها موجودة بالفعل على الخادم. استخدم الأمر التالي لفهرسة دليل الصور المحلي الخاص بك:

   python main.py local-index < path-to-your-image-directory >

  سيقوم الأمر أعلاه بتحميل جميع الصور الموجودة في الدليل المحدد والأدلة الفرعية الخاصة به بشكل متكرر إلى الخادم. يمكنك أيضًا تحديد فئات/تمييز بنجمة للصور التي تقوم بتحميلها، راجع python main.py local-index --help لمزيد من المعلومات.
• من خلال واجهة برمجة التطبيقات: يمكنك استخدام واجهة برمجة تطبيقات التحميل التي توفرها NekoImageGallery لتحميل الصور. باستخدام هذه الطريقة، يمكن للخادم منع حفظ ملفات الصور محليًا ولكن يقوم فقط بتخزين عناوين URL وبيانات التعريف الخاصة بها.
  تأكد من تمكين Admin API وتعيين رمز المشرف الخاص بك في ملف التكوين.
  هذه الطريقة مناسبة للتحميل التلقائي للصور أو مزامنة NekoImageGallery مع الأنظمة الخارجية. وثائق Checkout API لمزيد من المعلومات.

وثائق واجهة برمجة التطبيقات

يتم توفير وثائق واجهة برمجة التطبيقات (API) من خلال واجهة Swagger UI المضمنة في FastAPI. يمكنك الوصول إلى وثائق واجهة برمجة التطبيقات (API) بزيارة المسار /docs أو /redoc الخاص بالخادم.

⚡ مشروع ذو صلة

يعمل هذا المشروع مع NekoImageGallery :D

ملخص المستودع

♥ المساهمة

هناك العديد من الطرق للمساهمة في المشروع: تسجيل الأخطاء، وإرسال طلبات السحب، والإبلاغ عن المشكلات، وإنشاء الاقتراحات.

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

نحن مهتمون أيضًا بتعليقاتك حول مستقبل هذا المشروع. يمكنك تقديم اقتراح أو طلب ميزة من خلال أداة تعقب المشكلات. ولجعل هذه العملية أكثر فعالية، نطلب أن تتضمن هذه المعلومات مزيدًا من المعلومات للمساعدة في تعريفها بشكل أكثر وضوحًا.

حقوق الطبع والنشر

حقوق الطبع والنشر 2023 إيدج نيكو

مرخص بموجب ترخيص AGPLv3.