التثبيت: حزمة Windows المحمولة تعمل خلال 5 دقائق
إن كنت تبحث عن «تثبيت ComfyUI»، فربما أخافتك الدروس التي تقول «ثبّت Python أولًا، ثم ثبّت PyTorch، ثم اضبط CUDA». الخبر السار: تثبيت ComfyUI على Windows له مسار لا يلمس أيًّا من ذلك إطلاقًا — الحزمة المحمولة (Portable) الرسمية: ملف مضغوط 7z يضم بيئة Python مستقلة و PyTorch المطابق لبطاقة رسومياتك، فك الضغط واستخدم. الخطوات بعد اكتمال التنزيل تكفيها 5 دقائق؛ أما وقت التنزيل نفسه فيعتمد على سرعة إنترنتك.
يأخذك هذا الدرس عبر مسار حزمة Windows المحمولة: اختر الحزمة الصحيحة ← فك الضغط ← انقر نقرًا مزدوجًا للتشغيل ← ترى لوحة العقد في المتصفح. إن أردت نسخة سطح المكتب، أو كنت مستخدم Mac / Linux، فاذهب مباشرة إلى التثبيت البديل.
ماذا ستستطيع أن تفعل بعد إتمام الدرس
- تنزيل حزمة ComfyUI المحمولة الرسمية المطابقة لبطاقة رسومياتك (لكل من NVIDIA / AMD / Intel ملفها الخاص)
- فك ضغط حزمة 7z وتشغيل ComfyUI باستخدام سكربت
.batالصحيح - فتح
http://127.0.0.1:8188في المتصفح ورؤية لوحة العقد - شرح «متطلبات بطاقة الرسوميات لـ ComfyUI»: أي حزمة تناسب أي بطاقة، وماذا تفعل إن لم يكن لديك بطاقة رسوميات منفصلة
- ترقية النسخة المحمولة باستخدام السكربت الرسمي الموجود في مجلد
update
مأزقك الحالي
- تريد تجربة رسم الصور بالذكاء الاصطناعي، تبحث عن «تثبيت ComfyUI على Windows»، فتظهر لك دروس كلها «ثبّت Python ← اضبط مصدر pip ← ثبّت PyTorch ← طابق إصدار CUDA»، فتُحبَط قبل أن تبدأ
- ثبّت سابقًا حزمة مجمّعة، فتعارضت بيئة Python مع برامج أخرى، ولم يُزَل التثبيت بشكل نظيف حتى عند إلغائه
- نزّلت ComfyUI ولا تعرف أي ملف تنقر عليه نقرًا مزدوجًا؛ النافذة السوداء تومض وتختفي، أو تعمل الخدمة لكنك لا تعرف أين الواجهة
متى تستخدم هذه الطريقة
عندما تحتاج إلى:
- أسرع طريقة لتشغيل ComfyUI على Windows: دون تثبيت Python، دون ضبط CUDA، دون تغيير بيئة النظام
- تثبيت «أخضر»: البرنامج بأكمله مع بيئة Python المستقلة موجود في مجلد واحد
- استخدام النسخة التي جمّعتها الجهة الرسمية مسبقًا لبطاقة رسومياتك (NVIDIA / AMD / Intel) مباشرة
ولا تريد:
- معاناة مطابقة إصدار Python مع PyTorch و CUDA
- ترك كومة من متغيرات البيئة والتبعيات في نظامك
- تعلّم مصطلحات مثل conda و venv أولًا قبل أن تبدأ الرسم
💡 تتوفر أيضًا نسخة سطح مكتب رسمية
توفر الجهة الرسمية أيضًا نسخة سطح المكتب Comfy Desktop، ويصفها README الرسمي بأنها «الأبسط للمستخدمين الجدد»، فهي تأتي بمثبّت رسومي وتُحدّث نفسها تلقائيًا. النسخة المحمولة ونسخة سطح المكتب تشغّلان نفس ComfyUI، فاختر إحداهما؛ طريقة تثبيت نسخة سطح المكتب في التثبيت البديل.
🎒 التحضيرات قبل البدء
- قراءة الدرس السابق ComfyUI ما هو: لتعرف ما هي العقد والوصلات وسير العمل، فلا تتوه عند فتح الواجهة بعد التثبيت
- جهاز كمبيوتر يعمل بـ Windows: الإصدارات الأحدث من مستكشف Windows تفك ضغط ملفات 7z مباشرة، وعلى الأنظمة القديمة ثبّت أولًا برنامج 7-Zip المجاني
- معرفة علامة بطاقة رسومياتك (NVIDIA / AMD / Intel): إن لم تكن متأكدًا فألقِ نظرة على «محولات العرض» في إدارة الأجهزة
- يُنصح بمتصفح Google Chrome 143 أو أحدث — الجهة الرسمية تذكر صراحةً أن 142 وما دونه به مشكلات عرض وأداء معروفة
- اترك مساحة كافية على القرص: حجم الحزمة المحمولة بعد فك الضغط ليس صغيرًا، وكل نموذج لاحق قد يصل حجمه إلى عدة GB
- كوب من الماء ☕
⚠️ تلميحات التنزيل داخل الصين
تُستضاف حزمة التثبيت على GitHub Releases، وتأتي معظم النماذج من Hugging Face — تذكر الوثائق الرسمية أن مستخدمي البر الرئيسي للصين قد يحتاجون إلى إعداد وكيل (proxy) للوصول المستقر إلى GitHub. بطء التنزيل لا يعني أنك أخطأت في الخطوات.
متطلبات النظام: ComfyUI نظرة سريعة على متطلبات بطاقة الرسوميات
الحد الأدنى من العتاد الذي حددته الجهة الرسمية منخفض جدًا: بفضل تقنية البث غير المتزامن للأوزان (asynchronous weight streaming)، يمكن لـ 4GB من ذاكرة VRAM + 8GB من ذاكرة RAM تشغيل أكبر النماذج مفتوحة المصدر. حالة دعم بطاقات الرسوميات من كل علامة:
| العتاد | حالة الدعم |
|---|---|
| NVIDIA | تُدعم البطاقات الصادرة خلال آخر 10 سنوات تقريبًا (بدءًا من سلسلة GTX 900)؛ توصي الجهة الرسمية بسلسلة 30 أو أعلى للحصول على أفضل أداء، وكلما زادت ذاكرة VRAM كان ذلك أفضل |
| AMD | حزمة Windows مبنية على ROCm وتدعم معماريات RDNA 2 / 3 / 3.5 / 4 دون الحاجة إلى تثبيت HIP SDK منفصلًا |
| Intel | سلسلة Arc (دعم torch.xpu الأصلي) |
| Apple Silicon | مدعوم (سلسلة M)، عبر مسار تثبيت Mac، انظر التثبيت البديل |
| بدون بطاقة رسومات منفصلة | يمكن التشغيل بوضع CPU (--cpu)، لكنه بطيء فقط |
أما نظام التشغيل، فـ Windows / Linux / macOS كلها مدرجة في قائمة الدعم الرسمية، لكن الحزمة المحمولة صدرت لنظام Windows فقط. ولا تحتاج إلى تثبيت Python: فالحزمة المحمولة تتضمن Python مستقلاً خاصاً بها (النسخة الحالية 3.13) و PyTorch (حزمة NVIDIA حالياً بنسخة CUDA 13.0).
الفكرة الأساسية
ما هي الحزمة المحمولة لـ ComfyUI. يجمع المسؤولون ComfyUI البرنامج الرئيسي وبيئة Python مستقلة (python_embeded) ونسخة PyTorch المطابقة لبطاقة الرسومات في ملف 7z واحد. ما يسمى «التثبيت» هو مجرد فك الضغط؛ وما يسمى «التشغيل» هو النقر المزدوج على النص البرمجي .bat الموجود داخله — حيث يشغّل ComfyUI\main.py باستخدام Python المدمج، ويقيم خدمة محلية على حاسوبك.
أين الواجهة. ComfyUI يعتمد بنية «خدمة محلية + واجهة ويب»: بعد التشغيل تفتح المتصفح على http://127.0.0.1:8188 (127.0.0.1 يعني «هذا الجهاز»). أما نافذة سطر الأوامر السوداء فهي الخدمة نفسها — يحذّر المسؤولون صراحة: لا تغلقها أثناء الاستخدام، فإذا أغلقتها يتوقف ComfyUI عن العمل.
الخطوة الأهم: اختر الحزمة حسب بطاقة الرسومات. أصدر المسؤولون حزماً مختلفة لمعالجات GPU المختلفة، وهذا هو المكان الوحيد الذي يسهل فيه الاختيار الخاطئ عند تثبيت النسخة المحمولة من ComfyUI. لنضع طرق التثبيت المحلي الثلاثة جنباً إلى جنب:
| طريقة التثبيت | لمن تناسب | بعبارة واحدة |
|---|---|---|
| الحزمة المحمولة لـ Windows (هذا الدرس) | مستخدمو Windows الذين يريدون أسرع تشغيل | فك الضغط واستخدم مباشرة، مع Python و PyTorch مدمجين |
| Comfy Desktop نسخة سطح المكتب | لمن يريد مثبّتاً رسومياً وتحديثاً تلقائياً | تقول الجهة الرسمية إنه الأسهل للمستخدمين الجدد |
| التثبيت اليدوي على macOS / Linux | مستخدمو Mac (Apple Silicon) و Linux | git clone + pip لإعداد البيئة بنفسك |
اكتمال التثبيت ≠ القدرة على توليد الصور. حزمة التثبيت لا تتضمن أي ملفات نماذج — أول نموذج (الذي تستخدمه الدورة الرسمية هو SD1.5، بحجم حوالي 4GB) عليك تنزيله ووضعه في مجلد models بنفسك، وهذا موضوع درس أين توضع النماذج.
اتبع خطواتي
الخطوة 1: تأكد من بطاقة الرسومات واختر حزمة تنزيل ComfyUI الصحيحة
لماذا: الجهة الرسمية تحزم الحزم حسب نوع GPU، واختيار الحزمة الخاطئة قد يؤدي إلى فشل التشغيل أو أداء ضعيف جداً.
قارن بالجدول التالي وانقر للتنزيل (الملفات كلها في صفحة أحدث إصدار على GitHub Releases):
| بطاقة الرسومات لديك | الحزمة المطلوب تنزيلها | اسم الملف |
|---|---|---|
| NVIDIA سلسلة RTX 20 وما فوق | الحزمة القياسية (CUDA 13.0، Python 3.13) | ComfyUI_windows_portable_nvidia.7z |
| NVIDIA سلسلة GTX 10 وما هو أقدم | حزمة cu126 (CUDA 12.6، Python 3.12) | ComfyUI_windows_portable_nvidia_cu126.7z |
| Windows on ARM + NVIDIA | حزمة ARM64 (Python 3.14) | ComfyUI_windows_portable_nvidia_arm64.7z |
| AMD | حزمة AMD (ROCm) | ComfyUI_windows_portable_amd.7z |
| Intel | حزمة Intel | ComfyUI_windows_portable_intel.7z |
| لا توجد بطاقة رسومات منفصلة | أي حزمة NVIDIA، ثم التشغيل باستخدام run_cpu.bat | — |
⚠️ لا تنزّل حزمة cu126 للبطاقات الحديثة
نص README الرسمي حرفياً: حزمة cu126 مخصصة فقط لبطاقات سلسلة GTX 10 وما هو أقدم، ولا يجوز استخدامها على البطاقات الحديثة من سلسلة RTX 20 وما فوق.
المفترض أن ترى: يبدأ المتصفح تنزيل ملف .7z اسمه مطابق للجدول أعلاه.
- اسم الملف المنزّل يطابق بطاقة الرسومات لدي
الخطوة 2: فك ضغط حزمة 7z، وهنا ينتهي تثبيت ComfyUI
لماذا: الحزمة المحمولة لا تحتوي على مثبّت، و«فك الضغط» هو كل إجراء التثبيت.
الخطوات: قم بفك ضغط .7z إلى موقع ذي مساحة كافية (مثل D:\). انقر بزر الفأرة الأيمن وفك الضغط باستخدام 7-Zip؛ ويمكن لمستكشف Windows في الإصدارات الأحدث فك الضغط مباشرة أيضاً.
المفترض أن ترى: يُفك الضغط عن مجلد بالبنية التالية — وهذه البنية سنستخدمها في كل درس لاحق:
ComfyUI_windows_portable
├── ComfyUI ← البرنامج الرئيسي (مجلد النماذج models موجود داخله أيضاً)
├── python_embeded ← بيئة Python مستقلة مدمجة
├── update ← نصوص دفعية (batch) للترقية
├── README_VERY_IMPORTANT.txt ← تعليمات استخدام الحزمة المحمولة الرسمية
├── run_cpu.bat ← التشغيل بوضع CPU (لمن لا يملك بطاقة رسومات منفصلة، بطيء)
└── run_nvidia_gpu.bat ← تشغيل NVIDIA (حزمة AMD تستخدم run_amd_gpu.bat، وحزمة Intel تستخدم run_intel_gpu.bat)- أستطيع العثور على run_nvidia_gpu.bat (أو ملف .bat المطابق لبطاقة الرسومات لدي)
الخطوة 3: انقر نقراً مزدوجاً على .bat لتشغيل ComfyUI
لماذا: سيقوم .bat بتشغيل الخدمة المحلية باستخدام Python المدمج، وهذه الخطوة هي «التشغيل» الفعلي.
الخطوات: انقر نقراً مزدوجاً على النص البرمجي للتشغيل المطابق لبطاقة الرسومات لديك:
- NVIDIA:
run_nvidia_gpu.bat - AMD:
run_amd_gpu.bat - Intel:
run_intel_gpu.bat - بدون كرت رسوميات منفصل:
run_cpu.bat
ما يفعله لا يتجاوز سطرًا واحدًا—— السطر الذي يقوم بالعمل الفعلي داخل run_nvidia_gpu.bat هو هذا (يوجد في الملف أيضًا قسم رسمي لنصائح استكشاف الأخطاء و pause، ومحتوى النصائح موجود في قسم «تنبيهات المخاطر» أدناه):
.\python_embeded\python.exe -s ComfyUI\main.py --windows-standalone-buildيجب أن ترى: نافذة سطر أوامر سوداء تمرر السجلات، وفي النهاية يظهر:
To see the GUI go to: http://127.0.0.1:8188عادةً يفتح المتصفح تلقائيًا وينتقل إلى هذا العنوان؛ إذا لم يفتح تلقائيًا، فافتح المتصفح بنفسك وزُر http://127.0.0.1:8188—— إذا ظهرت لوحة العُقد، فقد نجحت التثبيت.
⚠️ لا تغلق النافذة السوداء
تحذير رسمي: لا تغلق نافذة سطر الأوامر تلك أثناء الاستخدام، وإلا سيتوقف ComfyUI عن العمل. عندما تريد إنهاء الاستخدام أغلقها، فتتوقف الخدمة، وفي المرة القادمة انقر نقرًا مزدوجًا على .bat لإعادة التشغيل.
- يفتح المتصفح http://127.0.0.1:8188، ويمكنك رؤية لوحة العُقد
الخطوة 4: التعرف على الوجهة التالية—— مجلد النماذج
لماذا: حزمة التثبيت لا تتضمن النماذج، ولا يزال Load Checkpoint فارغًا في الواجهة الآن، والنقر مباشرة على التوليد سيسبب خطأً أحمر. تثبيت النماذج هو موضوع الدرس التالي، وهنا نكتفي بالتعرف على الباب.
الخطوة: افتح في مستكشف الملفات ComfyUI_windows_portable\ComfyUI\models\checkpoints—— هنا يوضع أول نموذج لك (الوزن SD1.5 الذي يستخدمه الدرس الرسمي v1-5-pruned-emaonly-fp16.safetensors).
يجب أن ترى: صفًّا من المجلدات الفرعية تحت models (checkpoints، vae، loras وغيرها). لشرح مفصل لقواعد المجلدات وطرق مشاركة النماذج بين برامج متعددة، انظر أين تضع النماذج؛ وللحصول على أول صورة بعد وضع النموذج، انظر أول توليد صورة.
- أعرف أن أول نموذج يجب وضعه في
ComfyUI\models\checkpoints
نقطة تحقق ✅
- اسم ملف
.7zالذي نزّلته مطابق لكرت الرسوميات لدي (لم أنزّل حزمة cu126 بالخطأ للكرت الجديد) - بعد فك الضغط يمكنني رؤية
run_nvidia_gpu.bat(أوrun_amd_gpu.bat/run_intel_gpu.bat) ومجلدupdate - بعد النقر المزدوج على
.bat، يظهر في سطر الأوامرTo see the GUI go to: http://127.0.0.1:8188 - يفتح المتصفح
http://127.0.0.1:8188، ويمكنني رؤية لوحة عُقد ComfyUI - أعرف: لا يمكن إغلاق النافذة السوداء بشكل عشوائي؛ والتثبيت وحده ليس كل شيء، فالنماذج يجب تنزيلها بشكل منفصل
تنبيهات لتجنب العثرات
❌ بعد النقر المزدوج على .bat تومض النافذة السوداء وتختفي، ولم يعمل ComfyUI
كتب المسؤول مباشرةً في run_nvidia_gpu.bat نصًّا: إذا رأيت النص ولم يبدأ ComfyUI، حدِّث تعريف NVIDIA إلى أحدث إصدار أولًا؛ وإذا ظهر خطأ c10.dll، فثبِّت مكتبات تشغيل Microsoft VC++، والعنوان الرسمي المقدم هو https://aka.ms/vc14/vc_redist.x64.exe. الترتيب الصحيح: تحديث التعريف ← ثم النقر المزدوج؛ ظهور خطأ c10.dll ← تثبيت مكتبات التشغيل. لمزيد من مشاكل التشغيل انظر ماذا تفعل إذا لم ينجح التثبيت.
❌ نزّلت حزمة cu126 لكرت من سلسلة RTX 30/40/50
حزمة cu126 (CUDA 12.6) مخصصة لكرت GTX 10 وما هو أقدم، ويؤكد README الرسمي بأحرف كبيرة «لا تستخدمها على سلسلة 20 أو أحدث». الطريقة الصحيحة: احذفها ونزّل الحزمة القياسية ComfyUI_windows_portable_nvidia.7z (CUDA 13.0) من جديد.
❌ خطأ في فك الضغط، أو ملفات ناقصة بعد فك الضغط
يضيف Windows علامة «قفل» على الملفات المنزّلة من الإنترنت، مما يؤدي إلى فشل فك الضغط. الحل المقدم في README الرسمي: انقر بزر الفأرة الأيمن على ملف .7z ← خصائص ← ضع علامة على «إلغاء القفل» (Unblock) ← موافق، ثم أعد فك الضغط. وإذا لم ينجح الأمر فاستخدم 7-Zip لفك الضغط.
❌ يستطيع المتصفح فتح 127.0.0.1:8188، لكن الواجهة بيضاء أو مشوهة
تشير متطلبات النظام الرسمية بوضوح: إصدارات Chrome 142 وما قبلها بها مشاكل معروفة تسبب خللًا في عرض الواجهة ومشاكل في الأداء. الطريقة الصحيحة: قم بترقية Chrome إلى 143 أو أحدث ثم افتحه.
نصائح متقدمة (اختياري)
🔧 ترقية النسخة المحمولة: يوجد في مجلد update ثلاثة نصوص برمجية رسمية، يكفي النقر عليها نقرًا مزدوجًا:
| النص البرمجي | الوظيفة |
|---|---|
update\update_comfyui.bat | التحديث إلى أحدث إصدار تطويري |
update\update_comfyui_stable.bat | التحديث إلى أحدث إصدار مستقر |
update\update_comfyui_and_python_dependencies.bat | ⚠️ يعيد تثبيت تبعيات Python معه، ويشير المسؤول إلى استخدامه فقط عند وجود مشاكل في التبعيات، وقبل تشغيله اعمل نسخة احتياطية لمجلد التثبيت بأكمله |
🔧 السماح للأجهزة الأخرى على الشبكة المحلية بالوصول: افتح run_nvidia_gpu.bat بالمفكرة، وأضف المعامل --listen (مثال رسمي):
.\python_embeded\python.exe -s ComfyUI\main.py --listen --windows-standalone-build
pauseبعد إعادة التشغيل سيعرض السجل To see the GUI go to: http://0.0.0.0:8188. اضغط Win + R وأدخل cmd لفتح موجه الأوامر، وأدخل ipconfig لمعرفة عنوان IP للجهاز، ثم تصل الأجهزة الأخرى عبر المتصفح إلى http://<你的本机IP>:8188.
🔧 تثبيت حزم Python إضافية للنسخة المحمولة (غالبًا ما تحتاج تبعيات العُقد المخصصة إلى التثبيت بهذه الطريقة):
cd ComfyUI_windows_portable
.\python_embeded\python.exe -m pip install <包名>إذا كان pip بطيئًا داخل الصين، يمكنك إضافة معامل مرآة Tsinghua (يذكر المستند الرسمي هذا الحل أيضًا): -i https://pypi.tuna.tsinghua.edu.cn/simple.
🔧 متغيرات تشغيل رسمية مدمجة: توجد في حزمة NVIDIA أيضًا run_nvidia_gpu_fast_fp16_accumulation.bat، التي تفعّل تسريع تراكم fp16—— يقول الشرح الرسمي «أسرع لنماذج fp16 مع انخفاض طفيف في الجودة»؛ أما حزمة AMD فتأتي مع run_amd_gpu_enable_dynamic_vram.bat (بإضافة المعامل --enable-dynamic-vram).
ملخص الدرس
✅ لقد أكملت تثبيت ComfyUI (مسار الحزمة المحمولة لـ Windows): اختيار الحزمة حسب كرت الرسوميات ← فك الضغط ← النقر المزدوج على .bat ← فتح http://127.0.0.1:8188 في المتصفح.
✅ لقد أوضحت متطلبات كرت الرسوميات لـ ComfyUI: كروت NVIDIA الحديثة تستخدم الحزمة القياسية، وسلسلة GTX 10 وما هو أقدم تستخدم حزمة cu126؛ ولكل من AMD / Intel حزمتها المقابلة؛ وبدون كرت رسوميات منفصل يمكن التشغيل بوضع CPU، والحد الأدنى الرسمي يصل إلى 4GB ذاكرة رسوميات + 8GB ذاكرة RAM.
✅ لقد حفظت ثلاثة أمور: النافذة السوداء هي الخدمة نفسها فلا تغلقها بشكل عشوائي؛ وحزمة التثبيت لا تتضمن النماذج، وأول نموذج يوضع في ComfyUI\models\checkpoints؛ والترقية تتم بالنصوص البرمجية الرسمية في مجلد update.
| الملف / العنوان | الوظيفة |
|---|---|
run_nvidia_gpu.bat | نص تشغيل NVIDIA (تحتوي حزم AMD / Intel على نصوصها المقابلة) |
run_cpu.bat | التشغيل في وضع CPU (بإضافة المعامل --cpu، بطيء) |
update\update_comfyui.bat | الترقية إلى أحدث إصدار تطويري |
ComfyUI\models\checkpoints | ضع النموذج الأول هنا |
http://127.0.0.1:8188 | ComfyUI عنوان الواجهة |
معاينة الدرس التالي
حزمة Windows المحمولة ليست الطريق الوحيد: التركيب البديل: Comfy Desktop والتركيب اليدوي على macOS وLinux.
ستتعلم:
- كيفية تثبيت نسخة سطح المكتب Comfy Desktop (تقول الجهة الرسمية إنها الأسهل للمستخدمين الجدد)
- مسارات التثبيت على Mac (Apple Silicon) وLinux
- كيفية الاختيار بين عدة طرق للتثبيت، وهل يمكن التبديل بعد التثبيت
مستخدمو Windows الذين شغّلوا الحزمة المحمولة بالفعل يمكنهم أيضًا الانتقال مباشرة إلى أين توضع النماذج، لإنتاج أول صورة في وقت أقرب.