Skip to content

التثبيت: حزمة 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) و Linuxgit 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حزمة IntelComfyUI_windows_portable_intel.7z
لا توجد بطاقة رسومات منفصلةأي حزمة NVIDIA، ثم التشغيل باستخدام run_cpu.bat—

⚠️ لا تنزّل حزمة cu126 للبطاقات الحديثة

نص README الرسمي حرفياً: حزمة cu126 مخصصة فقط لبطاقات سلسلة GTX 10 وما هو أقدم، ولا يجوز استخدامها على البطاقات الحديثة من سلسلة RTX 20 وما فوق.

المفترض أن ترى: يبدأ المتصفح تنزيل ملف .7z اسمه مطابق للجدول أعلاه.

  • اسم الملف المنزّل يطابق بطاقة الرسومات لدي

الخطوة 2: فك ضغط حزمة 7z، وهنا ينتهي تثبيت ComfyUI ​

لماذا: الحزمة المحمولة لا تحتوي على مثبّت، و«فك الضغط» هو كل إجراء التثبيت.

الخطوات: قم بفك ضغط .7z إلى موقع ذي مساحة كافية (مثل D:\). انقر بزر الفأرة الأيمن وفك الضغط باستخدام 7-Zip؛ ويمكن لمستكشف Windows في الإصدارات الأحدث فك الضغط مباشرة أيضاً.

المفترض أن ترى: يُفك الضغط عن مجلد بالبنية التالية — وهذه البنية سنستخدمها في كل درس لاحق:

text
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، ومحتوى النصائح موجود في قسم «تنبيهات المخاطر» أدناه):

bat
.\python_embeded\python.exe -s ComfyUI\main.py --windows-standalone-build

يجب أن ترى: نافذة سطر أوامر سوداء تمرر السجلات، وفي النهاية يظهر:

text
To see the GUI go to: http://127.0.0.1:8188

عادةً يفتح المتصفح تلقائيًا وينتقل إلى هذا العنوان؛ إذا لم يفتح تلقائيًا، فافتح المتصفح بنفسك وزُر http://127.0.0.1:8188—— إذا ظهرت لوحة العُقد، فقد نجحت التثبيت.

⚠️ لا تغلق النافذة السوداء

تحذير رسمي: لا تغلق نافذة سطر الأوامر تلك أثناء الاستخدام، وإلا سيتوقف ComfyUI عن العمل. عندما تريد إنهاء الاستخدام أغلقها، فتتوقف الخدمة، وفي المرة القادمة انقر نقرًا مزدوجًا على .bat لإعادة التشغيل.

الخطوة 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 (مثال رسمي):

bat
.\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 إضافية للنسخة المحمولة (غالبًا ما تحتاج تبعيات العُقد المخصصة إلى التثبيت بهذه الطريقة):

bash
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:8188ComfyUI عنوان الواجهة

معاينة الدرس التالي ​

حزمة Windows المحمولة ليست الطريق الوحيد: التركيب البديل: Comfy Desktop والتركيب اليدوي على macOS وLinux.

ستتعلم:

  • كيفية تثبيت نسخة سطح المكتب Comfy Desktop (تقول الجهة الرسمية إنها الأسهل للمستخدمين الجدد)
  • مسارات التثبيت على Mac (Apple Silicon) وLinux
  • كيفية الاختيار بين عدة طرق للتثبيت، وهل يمكن التبديل بعد التثبيت

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

gaodong.aiAboutPrivacyContact

Independent tutorials, not affiliated with any product mentioned. Product names and trademarks belong to their owners. Check official pages for prices and policies.