ComfyUI واجهة العقد في جملة واحدة: بدل نموذج فيه حقل نص (prompt) وزر، تركّب رسمًا بيانيًا يؤدي كل صندوق فيه (تحميل نموذج، ترميز نص، أخذ عيّنات، فك ترميز) خطوة من خطوات توليد الصور أو الفيديو أو الصوت أو المحتوى ثلاثي الأبعاد. يضم مستودع Comfy-Org/ComfyUI نحو 141 800 نجمة و16 800 تفرّع (fork) وقت المراجعة، في 22 أكتوبر 2026، وهو منشور تحت ترخيص GPL-3.0.
بالنسبة إلى قارئ من فريق SRE أو مطوّر، الفائدة مزدوجة. فمن جهة، سير العمل (workflow) ملف JSON قابل لإعادة الإنتاج، ويعرض الخادم واجهة HTTP محلية. ومن جهة أخرى، هو خادم Python يشغل وحدة معالجة رسومية (GPU) ويقرأ نماذج بحجم عدة غيغابايت ويحمّل شيفرة طرف ثالث على شكل عقد مخصصة: يُراقَب كأي خدمة أخرى.
توضيح للأمانة: لم يثبّت span.observer نظام ComfyUI ولم يشغّله لكتابة هذا المقال. الأوامر مأخوذة من README ومن شيفرة المستودع، واللقطات مأخوذة من الوثائق الرسمية للمشروع أو هي مقتطفات مولّدة من المستودع.
ComfyUI واجهة العقد: ما يقوله المستودع
- الناشر: Comfy Org. المستودع الحالي هو
Comfy-Org/ComfyUI؛ وما زالت روابط كثيرة في README (الشارات والإصدارات) تشير إلى المساحة القديمةcomfyanonymous/ComfyUI. - اللغة: Python للخادم (
main.pyوserver.py). أما الواجهة الأمامية فهي في مستودع منفصل اسمهComfyUI_frontend، وتوزَّع حزمةً على PyPI. - أرقام أعيدت قراءتها في 22 أكتوبر 2026 من صفحة المستودع: نحو 141 800 نجمة ونحو 16 800 تفرّع. يشير الملف
comfyui_version.pyفي الفرع الرئيسي إلى الإصدار 0.42.0؛ ولم يمكن إعادة قراءة قائمة الإصدارات من الصفحة، لذلك لا أذكر تاريخ إصدار. - المنصات: Windows وLinux وmacOS، مع تطبيق سطح مكتب أو تثبيت محمول لـ Windows أو تثبيت يدوي؛ ودعم وحدات NVIDIA وAMD وIntel وApple Silicon وAscend بحسب README.
- دورة النشر: يصف README وتيرة أسبوعية مستهدفة دون ضمان، ويحذّر من أن الالتزامات (commits) خارج الوسوم المستقرة «قد تكون غير مستقرة جدًا وتكسر كثيرًا من العقد المخصصة».
يقدّم المشروع نفسه محرك استدلال (inference) محسَّنًا جدًا للعتاد الاستهلاكي، قادرًا على تشغيل نماذج كبيرة بذاكرة VRAM مقدارها 4 غيغابايت وذاكرة RAM مقدارها 8 غيغابايت بفضل «بث غير متزامن للأوزان». هذا ادعاء من README لم يقِسه span.observer.
ترخيص GPL-3.0: ما الذي يترتب عليه
ملف LICENSE هو نص رخصة GNU العامة (GPL) الإصدار 3. وهي رخصة copyleft. عمليًا:
- يمكنك استخدام ComfyUI ودراسته وتعديله وإعادة توزيعه، بما في ذلك في سياق مهني، دون دفع رخصة.
- إذا وزّعت نسخة معدّلة (أو منتجًا مشتقًا منها)، فعليك توزيعها تحت GPL-3.0 مع الشيفرة المصدرية المقابلة.
- الاستخدام الداخلي الخالص دون إعادة توزيع لا يُلزمك بنشر تعديلاتك.
- تشمل GPL شيفرة ComfyUI. أما أوزان النماذج التي تحمّلها فلها تراخيصها الخاصة، وتخضع العقد الشريكة (الوصول إلى نماذج مغلقة عبر API، بحسب README) لشروط مزوّديها.
لحالة محددة (عقدة مخصصة موزَّعة، أو دمج في منتج)، اطلب من الإدارة القانونية التحقق من النطاق: هذا الملخص ليس رأيًا قانونيًا.
جولة في الواجهة
تعرض الوثائق الرسمية الرسم البياني الافتراضي، وهو سير عمل لتوليد صورة بنموذج Stable Diffusion 1.5. تُجمَّع العقد في خطوات: تحميل النموذج (Load Checkpoint)، وكتابة النص الإيجابي والسلبي (عقدتا CLIP Text Encode)، واختيار الحجم (Empty Latent Image)، وأخذ العيّنات (KSampler)، وفك الترميز (VAE Decode)، ثم الحفظ (Save Image). يطلق الزر Run التنفيذ.

بعد التنفيذ تظهر الصورة في العقدة Save Image وفي لوحة الوسائط المولّدة، مع مدتها وحجمها. يوضح README أن سحب صورة PNG مولّدة إلى الصفحة يعيد تحميل سير العمل كاملًا، بما فيه البذرة (seed): وهذا ما يجعل النتائج قابلة لإعادة الإنتاج.

نقاط أخرى في README: لا يُنفَّذ من الرسم البياني إلا الأجزاء التي مدخلاتها صالحة، ولا يُعاد حساب إلا ما تغيّر منذ آخر تنفيذ. لذلك فإرسال الرسم نفسه مرتين لا يعيد حساب النتيجة الأولى.
التثبيت خطوة بخطوة
الخيار الأول: تطبيق سطح المكتب
يوصي README بتطبيق سطح المكتب للمستخدمين الجدد، وهو متاح لـ Windows وmacOS عبر رابط التنزيل في موقع comfy.org.
الخيار الثاني: الأرشيف المحمول لـ Windows
يوجد أرشيف 7z مستقل لوحدات NVIDIA وAMD وIntel؛ ولا يوصي به README للمستخدمين العاديين. يُستخرج باستخدام 7-Zip. وتوضع نقاط الفحص (checkpoints) في ComfyUI\models\checkpoints. يضم الإصدار الحالي Python 3.13 وPyTorch CUDA 13.0؛ حدّث تعريفات NVIDIA إذا فشل التشغيل.
الخيار الثالث: comfy-cli
pip install comfy-cli
comfy install
الخيار الرابع: التثبيت اليدوي (Windows وLinux وmacOS)
يذكر README أن Python 3.13 «مدعوم جيدًا جدًا» (و3.14 يعمل، مع تحفظات على بعض العقد المخصصة). الخطوات لوحدة NVIDIA:
- استنسخ المستودع، ثم ضع نقاط الفحص في
models/checkpointsوملفات VAE فيmodels/vae. - ثبّت PyTorch باستخدام فهرس CUDA المذكور في README:
pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu130 - ثبّت الاعتماديات داخل مجلد المستودع:
pip install -r requirements.txt - شغّل الخادم:
python main.py
لوحدات AMD أو Intel أو Apple Silicon أو Ascend يعطي README أوامر PyTorch أخرى: اتبع القسم المقابل بدل قسم NVIDIA. النماذج غير مرفقة مع المستودع: تنزّلها بنفسك وتحترم ترخيصها.
الحدود والنقاط المفتوحة
- العقد المخصصة: هي حزم Python تعمل داخل عملية الخادم. يُفعَّل مدير ComfyUI-Manager بالأمر
python main.py --enable-manager(بعدpip install -r manager_requirements.txt، بحسب README)، ويتيح الخيار--disable-all-custom-nodesتعطيلها جميعًا. لا تثبّت إلا عقدًا قرأت شيفرتها. - التعرّض للشبكة: افتراضيًا يستمع الخادم على
127.0.0.1في المنفذ 8188 (قيم قُرئت منcomfy/cli_args.py). يفتح الخيار--listenدون وسيط كل الواجهات. يقترح README الخيارين--tls-keyfileو--tls-certfileلـ TLS، مع شهادة موقّعة ذاتيًا «غير مناسبة للاستخدام المشترك أو الإنتاجي». لا يصف README أي مصادقة: ضع وكيلًا عكسيًا (reverse proxy) مع مصادقة أمام أي وصول عن بُعد. - الاستقرار: اعمل على وسم مستقر لا على الفرع الرئيسي، كما ينصح README.
- البيانات الصادرة: لا ينزّل النواة شيئًا دون طلب، بحسب README؛ ويعطّل الخيار
--offlineالعقد الشريكة المدفوعة ويضع سياسة أمان محتوى مقيِّدة للواجهة الأمامية.
مراقبة خادم ComfyUI
لا يصدّر ComfyUI تتبعات OpenTelemetry بحسب README؛ وتعتمد قابلية الملاحظة (observability) على واجهته البرمجية وسجلاته. تعلن شيفرة server.py خصوصًا هذه المسارات:

- يعيد
GET /system_statsنظام التشغيل وذاكرة RAM الكلية والحرة وإصداري ComfyUI وPyTorch، ولكل وحدة GPU القيمتينvram_totalوvram_free. انتبه: تحتوي الاستجابة أيضًا علىargv، أي سطر الأوامر كاملًا؛ فلا تعرضها علنًا. - يسرد
GET /queueالمهام الجارية (queue_running) والمنتظرة (queue_pending). عمق الطابور أول مؤشر على التشبع. - يعطي
GET /historyالتنفيذات المنتهية؛ ويوقفPOST /interruptالتنفيذ الجاري.
أما السجلات (logs) فيضبط --verbose مستوى التسجيل، ويرسل --log-stdout الخرج إلى stdout بدل stderr، وهذا مناسب للحاويات. مخطط بسيط: سكربت صغير يستعلم من /system_stats و/queue كل دقيقة وينشر ذاكرة VRAM الحرة وطول الطابور مقاييس OpenTelemetry، تستطيع Dynatrace SaaS أو Dynatrace Managed (أو أي خلفية OTLP أخرى) استيعابها. هذه وصفة من عندنا لا ميزة في ComfyUI. وللجمع، راجع OpenTelemetry وPrometheus: متكاملان.
كيف تتحقق من أن كل شيء يعمل
- بعد
python main.py، افتحhttp://127.0.0.1:8188: يظهر الرسم البياني الافتراضي. - يجب أن يعيد الطلب
GET /system_statsوحدات GPU لديك وذاكرة VRAM الحرة. - شغّل سير العمل الافتراضي مع نقطة فحص موجودة: تظهر الصورة، ويحتوي
/historyعلى التنفيذ.
أفضل الممارسات
- ابقَ على وسم مستقر ودوّن الإصدار (
comfyui_versionفي/system_stats) في سجلات التغيير لديك. - أبقِ الخادم على الحلقة المحلية، أو خلف وكيل بمصادقة وTLS.
- دقّق كل عقدة مخصصة قبل تثبيتها، واستخدم مستخدم نظام مخصصًا.
- راقب ذاكرة VRAM الحرة والطابور: النموذج الكبير جدًا يفشل بشكل مفاجئ لا تدريجي.
- أدِر إصدارات سير عمل JSON الخاصة بك؛ فهي توثّق التوليد أفضل من أي تذكرة. ولعناصر أخرى في بنية محلية، راجع بنية الذكاء الاصطناعي مفتوحة المصدر المستضافة ذاتيًا.
الأسئلة الشائعة
هل ComfyUI مجاني للاستخدام التجاري؟
البرنامج تحت GPL-3.0 التي تسمح بالاستخدام التجاري. للنماذج تراخيصها الخاصة، وهي أحيانًا مقيِّدة، وتتبع العقد الشريكة المدفوعة مزوّديها. تحقق من كل ترخيص.
هل يلزم GPU قوي؟
يؤكد README قدرته على تشغيل نماذج كبيرة بذاكرة VRAM مقدارها 4 غيغابايت وذاكرة RAM مقدارها 8 غيغابايت، ويذكر أيضًا وضع المعالج المركزي (CPU) للأرشيف المحمول. يتوقف الأداء على النموذج: جرّب بنموذجك.
هل يمكن استخدامه في سلسلة أدوات أو مع وكلاء؟
يذكر README واجهة محلية ونقاط نهاية لدمجه في خطوط الإنتاج. إذا كان وكيل يقود الخادم، فطبّق ضوابط الحماية لوكلاء الذكاء الاصطناعي في الإنتاج.
الخلاصة
يستحق ComfyUI الاهتمام لمن يريد التحكم في كل خطوة من التوليد وإعادتها بالمطابقة. الثمن: خادم GPU يجب تثبيته جيدًا، وترخيص GPL يجب فهمه، وعقد خارجية يجب مراقبتها. وللاطلاع على ما تفعله أداة مجاورة في مجال الصور، راجع PhotoCraft، محرر صور مفتوح المصدر بلغة Rust. المصادر: مستودع Comfy-Org/ComfyUI ووثائق ComfyUI.
span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC ولا للمشاريع المذكورة. العلامات التجارية المذكورة ملك لأصحابها. الأدوات تتطور بسرعة، لذا تحقق دائمًا من الأوامر والخيارات في وثائقها الرسمية.