تثبيت ComfyUI وإنشاء أول صورة

Comfy Desktop هو تطبيق سطح المكتب الرسمي لـ ComfyUI، ويثبّت ComfyUI وبيئة التشغيل المطلوبة معًا، لذلك لا تحتاج إلى إعداد Python أو CUDA أو pip بشكل منفصل. ويمكنك أيضًا الاحتفاظ بعدة عمليات تثبيت على الكمبيوتر نفسه، بحيث تكون كل واحدة منها مستقلة عن الأخرى، وهو ما يناسب تجربة إصدارات أو إعدادات مختلفة.

التحضير قبل التثبيت

تأكد أولًا من أن الكمبيوتر يستوفي الشروط التالية:

• Windows 10 أو إصدار أحدث، مع دعم x64 أو ARM64. يُنصح باستخدام بطاقة رسومات منفصلة من NVIDIA أو AMD، لكن يمكن التثبيت حتى من دون بطاقة رسومات منفصلة.
• macOS 13 ‏(Ventura) أو إصدار أحدث، ويجب أن يكون الجهاز مزودًا بشريحة Apple ‏(M1 أو أحدث).
• Linux. تتوفر حزم التثبيت بصيغتي .deb وAppImage، ويُنصح باستخدام Ubuntu 22.04 أو إصدار أحدث وبنية x64.

تحتاج كل عملية تثبيت لـ ComfyUI إلى نحو 4.85 GB من مساحة القرص. جهّز ذاكرة لا تقل عن 8 GB، بينما تكون 16 GB أنسب للاستخدام. وستشغل نماذج الصور التي تنزّلها لاحقًا مساحة إضافية على القرص.

macOS

افتح dmg

• اسحبه إلى التطبيقات
• انتقل إلى الخصوصية والأمان عند التشغيل الأول
• انقر على فتح على أي حال

Windows

شغّل exe

• Windows 10 أو أحدث
• x64 أو ARM64
• أنشئ التثبيت من صفحة الترحيب

Linux

deb أو AppImage

• يُنصح باستخدام Ubuntu 22.04+
• x64
• راجع تعليمات وضع الحماية إذا فشل التشغيل

التثبيت والتشغيل لأول مرة

انتقل إلى صفحة تنزيل Comfy Desktop للحصول على حزمة التثبيت. ستتعرف الصفحة تلقائيًا على النظام الذي تستخدمه.

macOS

1. افتح ملف .dmg الذي نزّلته.
2. اسحب Comfy Desktop إلى مجلد التطبيقات.
3. افتح Comfy Desktop من Launchpad أو عبر بحث Spotlight.

عند التشغيل لأول مرة، قد يعرض macOS تحذيرًا أمنيًا. عندها افتح Privacy & Security (الخصوصية والأمان) في إعدادات النظام، ثم انقر على Open Anyway (فتح على أي حال). يسمح هذا الزر للنظام بتشغيل التطبيق الذي جرى حظره للتو.

Windows

شغّل ملف .exe الذي نزّلته، وهو حزمة تثبيت NSIS، واتبع التعليمات الظاهرة على الشاشة لإكمال التثبيت. بعد ذلك افتح Comfy Desktop من قائمة «ابدأ» أو من اختصار سطح المكتب.

عند التشغيل لأول مرة، ستظهر شاشة الترحيب، ويمكنك منها إنشاء أول عملية تثبيت لـ ComfyUI.

Linux

يستخدم Linux رابط تنزيل عامًا. إذا كنت تستخدم Debian أو Ubuntu، فانتقل إلى مجلد التنزيل الذي يحتوي على حزمة التثبيت، ثم نفّذ:

sudo apt install ./*.deb

عند استخدام AppImage، نفّذ:

chmod +x ./*.AppImage
./*.AppImage

إذا تعذّر تشغيل التطبيق، فقد يكون توزيع Linux يمنع صندوق حماية Electron. يفرض Ubuntu 24.04 والإصدارات الأحدث قيودًا على مساحات أسماء المستخدمين غير المميزين من خلال AppArmor. لا تضف --no-sandbox لإعادة المحاولة إلا بعد التأكد من أن سبب الفشل هو تعذّر بدء صندوق الحماية. يعطّل هذا الخيار صندوق حماية Electron لكل عملية، لذلك لا يُنصح باستخدامه في الحالات الأخرى.

بعد فتح Comfy Desktop، ستعرض صفحة Chooser مثيلات التثبيت الموجودة. انقر على New Instance لإنشاء عملية تثبيت جديدة ومستقلة لـ ComfyUI، ثم انقر على بطاقة المثيل المقابل لتشغيله.

يتتبع إصدار سطح المكتب القناة المستقرة افتراضيًا. إذا كنت تريد متابعة كل التغييرات الأحدث على GitHub، فيمكنك استخدام الإصدار المحمول أو التثبيت اليدوي عبر git، أو تغيير قناة تحديث المثيل إلى Latest on GitHub.

الحصول على معلمات الاتصال من OmniProxy

لا يوجد هنا عنوان عام أو مفتاح أو معرّف نموذج يمكن إدخاله. لا يتطلب تثبيت Comfy Desktop أو إكمال مسار تحويل النص الأساسي إلى صورة استخدام OmniProxy.

لا تُدخل Base URL الخاص بأدوات أخرى في عُقد مجهولة المصدر. انتظر حتى تتوفر تعليمات عامة واضحة للتكامل، ثم نفّذ الإعداد بصورة منفصلة.

إدخال إعدادات الأداة

لا يوجد هنا نموذج إعداد خاص بـ OmniProxy. لإنشاء الصورة الأولى، يجب أولًا تجهيز سير العمل ونموذج الصور.

يمكن النظر إلى سير العمل على أنه مجموعة من خطوات إنشاء الصورة، بينما تمثّل العُقد وحدات التشغيل المسؤولة عن مهام مثل تحميل النموذج أو استقبال النص أو حفظ الصورة. بعد تشغيل ComfyUI، يُحمَّل عادةً سير العمل الافتراضي لتحويل النص إلى صورة تلقائيًا.

إذا احتجت إلى فتح سير عمل آخر، فاختر Workflows → Open من القائمة. يُستخدم هذا الخيار لتحميل صورة تحتوي على معلومات سير العمل أو ملف سير عمل بصيغة JSON.

لا تتضمن معظم عمليات التثبيت نموذجًا أساسيًا بصورة افتراضية. بعد تحميل سير العمل، إذا لم يكن الملف v1-5-pruned-emaonly-fp16.safetensors موجودًا على الكمبيوتر، فستعرض الواجهة تنبيهًا يفيد بفقدان النموذج. افتح التنبيه للاطلاع على النموذج المفقود ورابط تنزيله.

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

توجد طريقتان لتنزيل النموذج:

• انقر على Download في الواجهة؛ يبدأ هذا الزر تنزيل النموذج المفقود. يحفظ إصدار سطح المكتب النموذج في ComfyUI/models/checkpoints ضمن عملية التثبيت الحالية، ويمكن متابعة تقدم التنزيل من لوحة النماذج في الشريط الجانبي. تأتي التنزيلات التلقائية عادةً من Hugging Face، لذلك يجب أن تتمكن الشبكة من الوصول إلى Hugging Face.
• إذا لم يظهر أي تقدم في التنزيل لفترة طويلة، فيمكنك نسخ رابط التنزيل من تفاصيل النموذج المفقود، وتنزيل الملف يدويًا، ثم حفظه في مجلد checkpoints نفسه. بعد ذلك حدّث ComfyUI أو أعد تشغيله.

بعد وضع النموذج في مكانه، اضغط على R في لوحة المفاتيح كي تعيد الواجهة قراءة قائمة النماذج الموجودة في العُقد.

التطبيق

Comfy Desktop

• يتولى تثبيت البيئة
• استخدم صفحة الترحيب أو أنشئ مثيلًا جديدًا
• انقر على البطاقة للتشغيل

سير العمل

تحويل النص إلى صورة

• يُحمّل تلقائيًا عادةً
• يمكن أيضًا فتحه من القائمة
• سيظهر تحذير عند فقدان نموذج

النموذج

checkpoints

• نزّله من الرابط الوارد في التحذير
• يمكن لإصدار سطح المكتب حفظه تلقائيًا
• اضغط R لتحديث القائمة

التحقق من مهمة فعلية

بعد تجهيز النموذج، اتبع الخطوات التالية لمحاولة إنشاء أول صورة:

1. في عقدة Load Checkpoint، اختر v1-5-pruned-emaonly-fp16.safetensors. تتولى هذه العقدة تحميل النموذج المستخدم لإنشاء الصورة الحالية.
2. انقر على Run أو اضغط على Ctrl + Enter. يُستخدم Run لبدء تنفيذ مهمة إنشاء الصورة الحالية.
3. ستظهر النتيجة التي جرى إنشاؤها في عقدة Save Image. تُستخدم هذه العقدة لمعاينة الصورة النهائية وحفظها، ويمكنك النقر بزر الفأرة الأيمن على الصورة لحفظها على جهازك.

إذا لم يظهر أي نموذج في Load Checkpoint، أو إذا عرضت القائمة المنسدلة القيمة null، فتحقق أولًا من مجلد النموذج، ثم حدّث ComfyUI أو أعد تشغيله.

حتى تاريخ 2026-10-09، تم التأكد على macOS من إمكانية تشغيل Comfy Desktop 1.1.6 الذي تم الحصول عليه من ملف dmg. ونظرًا إلى أن الأمر ما زال يتطلب إنشاء عملية تثبيت داخل التطبيق وتنزيل نموذج checkpoint، فلم تكتمل عملية إنشاء الصورة الأولى؛ لذلك لا يُدّعى هنا أن إنشاء الصورة نجح، كما لم يتم ربط OmniProxy مع ComfyUI.

النموذج

يظهر اسم في القائمة المنسدلة

• ليس null
• حدّد نقطة التحقق
• اضغط R للتحديث

التوليد

انقر على Run

• أو اضغط Ctrl+Enter
• انتظر حتى تنتهي العُقد
• ستجد الصورة في Save Image

النطاق

لا توصل البوابة حاليًا

• لا توجد خانة إعداد عامة
• لا تثبّت عُقدًا مجهولة المصدر
• يكفي نجاح توليد الصورة

الأخطاء الشائعة

• تعذّر فتح التطبيق على macOS: انتقل إلى إعدادات النظام → الخصوصية والأمان، ثم انقر على فتح على أي حال. لا تدعم حزمة التثبيت سوى أجهزة Apple المزودة بشرائح Apple وmacOS 13 أو إصدار أحدث.
• يُغلق التطبيق فور تشغيله على Linux: تأكد أولًا من أنك تستخدم .deb أو AppImage. لا تضف --no-sandbox إلا بعد التأكد من أن سبب المشكلة هو تعذّر بدء صندوق الحماية.
• ظهور تنبيه يفيد بفقدان النموذج: نزّل نموذج checkpoint من الرابط الموجود في التنبيه، واحفظه في models/checkpoints ضمن عملية التثبيت الحالية، ثم اضغط على R للتحديث.
• تعرض القائمة المنسدلة للنماذج القيمة null: استخدم Storage للتحقق من مجلد النموذج، وتأكد من وضع الملف في المكان الصحيح، ثم حدّث التطبيق أو أعد تشغيله.
• تريد إدخال OmniProxy هنا: لا توجد حاليًا خانات عامة للتكامل. لا تثبّت عُقدًا إضافية لم يُذكر بوضوح أنها طريقة تكامل عامة.

المراجع الرسمية

راجع Comfy Desktop للحصول على نظرة عامة حول التثبيت. تتوفر خطوات التثبيت الخاصة بكل منصة في macOS وWindows وLinux. ولمعرفة كيفية استخدام واجهة سطح المكتب، راجع Using Comfy Desktop. أما خطوات إنشاء الصورة الأولى، فتتوفر في Getting Started with AI Image Generation.

استبدل كل عنصر نائب بقيم إعداد OmniProxy الخاصة بك. لا تنشر مفتاحاً حقيقياً أبداً.

لا يثبت الحفظ الناجح أو HTTP 200 وحده توافق Agent الكامل. تحقق من المصدر والنموذج في سجل استدعاءات OmniProxy.

المصادر الرسمية · ComfyUI ↗