نصب ComfyUI و تولید اولین تصویر

Comfy Desktop برنامه رسمی دسکتاپ برای ComfyUI است. این برنامه ComfyUI را به همراه محیط اجرایی مورد نیاز نصب می‌کند، بنابراین نیازی به پیکربندی جداگانه پایتون، CUDA یا pip ندارید. همچنین می‌توانید چندین نصب را روی یک رایانه نگه دارید. هر نصب مستقل باقی می‌ماند، که آن را برای امتحان کردن نسخه‌ها یا پیکربندی‌های مختلف مناسب می‌کند.

قبل از شروع

ابتدا تأیید کنید که رایانه شما شرایط زیر را دارد:

• ویندوز 10 یا جدیدتر، با پشتیبانی از x64 یا ARM64. داشتن کارت گرافیک اختصاصی NVIDIA یا AMD توصیه می‌شود، اما نصب بدون آن نیز امکان‌پذیر است.
• macOS 13 (Ventura) یا جدیدتر، با تراشه سیلیکون اپل (M1 یا جدیدتر) الزامی است.
• لینوکس. بسته‌های نصب به صورت .deb و فایل‌های AppImage در دسترس هستند. اوبونتو 22.04 یا جدیدتر روی x64 توصیه می‌شود.

هر نصب ComfyUI به حدود 4.85 گیگابایت فضای دیسک نیاز دارد. حداقل 8 گیگابایت حافظه آماده کنید؛ 16 گیگابایت تجربه بهتری ارائه می‌دهد. مدل‌های تصویری که بعداً دانلود می‌شوند به فضای دیسک بیشتری نیاز خواهند داشت.

macOS

dmg را باز کنید

• آن را به Applications بکشید
• برای اولین اجرا، به Privacy & Security بروید
• روی Open Anyway کلیک کنید

ویندوز

exe را اجرا کنید

• ویندوز 10 یا جدیدتر
• x64 یا ARM64
• نصب را از صفحه خوش‌آمدگویی ایجاد کنید

لینوکس

deb یا AppImage

• اوبونتو 22.04+ توصیه می‌شود
• x64
• اگر اجرا ناموفق بود، دستورالعمل‌های sandbox را بررسی کنید

نصب و اولین اجرا

به صفحه دانلود Comfy Desktop بروید تا بسته نصب را دریافت کنید. صفحه به‌طور خودکار سیستمی که استفاده می‌کنید را تشخیص می‌دهد.

macOS

1. فایل دانلود شده را باز کنید .dmg.
2. Comfy Desktop را به پوشه Applications بکشید.
3. Comfy Desktop را از Launchpad یا Spotlight Search باز کنید.

هنگامی که برای اولین بار آن را اجرا می‌کنید، macOS ممکن است یک هشدار امنیتی نمایش دهد. Privacy & Security را در System Settings باز کنید و روی Open Anyway کلیک کنید. این دکمه به سیستم اجازه می‌دهد برنامه‌ای را که به‌تازگی مسدود شده است، اجرا کند.

ویندوز

فایل دانلود شده را اجرا کنید .exe (نصب‌کننده NSIS)، دستورالعمل‌های روی صفحه را برای تکمیل نصب دنبال کنید و سپس Comfy Desktop را از منوی Start یا میانبر دسکتاپ باز کنید.

صفحه خوش‌آمدگویی در اولین اجرا ظاهر می‌شود. می‌توانید اولین نصب ComfyUI خود را در آنجا ایجاد کنید.

لینوکس

لینوکس از یک لینک دانلود عمومی استفاده می‌کند. کاربران دبیان یا اوبونتو باید دایرکتوری دانلود حاوی بسته نصب را باز کرده و اجرا کنند:

sudo apt install ./*.deb

هنگام استفاده از AppImage، اجرا کنید:

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

اگر برنامه اجرا نشد، توزیع لینوکس شما ممکن است sandbox الکترون را مسدود کرده باشد. اوبونتو 24.04 و جدیدتر، فضاهای نام کاربری غیرمجاز را از طریق AppArmor محدود می‌کنند. اضافه کنید --no-sandbox و فقط پس از تأیید اینکه sandbox باعث شکست در اجرا شده است، دوباره امتحان کنید. این گزینه sandbox الکترون را برای هر فرآیند غیرفعال می‌کند و در شرایط دیگر توصیه نمی‌شود.

پس از باز کردن Comfy Desktop، صفحه Chooser نمونه‌های نصب موجود را فهرست می‌کند. روی New Instance کلیک کنید تا یک نصب مستقل ComfyUI ایجاد کنید، سپس روی کارت نمونه کلیک کنید تا اجرا شود.

نسخه دسکتاپ به‌طور پیش‌فرض نسخه پایدار را دنبال می‌کند. اگر می‌خواهید هر commit جدید در GitHub را دنبال کنید، از نسخه قابل حمل استفاده کنید، به‌صورت دستی با git نصب کنید، یا کانال به‌روزرسانی نمونه را به Latest on GitHub تغییر دهید.

دریافت جزئیات اتصال از OmniProxy

هیچ آدرس، کلید یا شناسه مدل جهانی برای وارد کردن در اینجا وجود ندارد. نصب Comfy Desktop و تکمیل گردش کار اولیه تبدیل متن به تصویر نیازی به OmniProxy ندارد.

URL پایه ابزار دیگری را در گره‌هایی (nodes) که منبع نامشخصی دارند وارد نکنید. تا زمانی که دستورالعمل‌های صریح برای یک روش ادغام عمومی در دسترس نباشد، آن را به‌طور جداگانه پیکربندی نکنید.

ورود به پیکربندی ابزار

هیچ فرم پیکربندی OmniProxy در اینجا وجود ندارد. برای تولید اولین تصویر، ابتدا باید یک گردش کار (workflow) و یک مدل تصویر آماده کنید.

گردش کار را می‌توان به عنوان توالی مراحل تولید تصویر در نظر گرفت. گره‌ها ماژول‌های عملیاتی در آن هستند که مدل‌ها را بارگذاری می‌کنند، متن را می‌پذیرند یا تصاویر را ذخیره می‌کنند. پس از شروع 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، Comfy Desktop 1.1.6 که از dmg رسمی دریافت شده بود، تأیید شد که در macOS اجرا می‌شود. از آنجایی که هنوز نیاز به ایجاد یک نصب در برنامه و دانلود یک مدل checkpoint بود، گردش کار اولین تصویر تکمیل نشد. بنابراین، این راهنما ادعا نمی‌کند که یک تصویر با موفقیت تولید شده است و OmniProxy با ComfyUI ادغام نشده است.

مدل

لیست کشویی یک نام را نشان می‌دهد

• null نیست
• یک checkpoint انتخاب کنید
• با R رفرش کنید

تولید

روی Run کلیک کنید

• یا Ctrl+Enter را فشار دهید
• منتظر بمانید تا گره‌ها تمام شوند
• تصویر در Save Image است

دامنه

هنوز درگاه را متصل نکنید

• هیچ فیلد پیکربندی جهانی وجود ندارد
• گره‌ها را از منابع ناشناخته نصب نکنید
• تولید موفق تصویر کافی است

خطاهای رایج

• macOS نمی‌تواند برنامه را باز کند: به System Settings → Privacy & Security بروید و روی Open Anyway کلیک کنید. بسته نصب فقط از سیلیکون اپل و macOS 13 یا جدیدتر پشتیبانی می‌کند.
• برنامه بلافاصله در لینوکس خارج می‌شود: ابتدا تأیید کنید که از .deb یا AppImage استفاده می‌کنید. اضافه کنید --no-sandbox فقط پس از تأیید اینکه sandbox باعث شکست در اجرا شده است.
• هشدار مدل گم شده ظاهر می‌شود: مدل checkpoint را از طریق لینک موجود در هشدار دانلود کنید، آن را در دایرکتوری models/checkpoints نصب فعلی ذخیره کنید و سپس R را برای رفرش فشار دهید.
• لیست کشویی مدل نمایش می‌دهد null: از Storage برای بررسی دایرکتوری مدل استفاده کنید، تأیید کنید که فایل در مکان صحیح است و سپس رفرش یا دوباره راه‌اندازی کنید.
• می‌خواهید جزئیات OmniProxy را در اینجا وارد کنید: در حال حاضر هیچ فیلد ادغام عمومی وجود ندارد. گره‌های اضافی را که به‌طور صریح به عنوان یک روش ادغام عمومی مستند نشده‌اند، نصب نکنید.

مراجع رسمی

برای نمای کلی نصب، ببینید Comfy Desktop. برای مراحل نصب خاص پلتفرم، ببینید macOS, ویندوز و لینوکس. برای دستورالعمل‌های استفاده از رابط دسکتاپ، ببینید استفاده از Comfy Desktop. برای مراحل تولید اولین تصویر، ببینید شروع کار با تولید تصویر هوش مصنوعی.

هر جایگاه را با مقادیر از پیکربندی OmniProxy خود جایگزین کنید. هرگز یک کلید واقعی را منتشر نکنید.

یک نتیجه ذخیره شده یا HTTP 200 به تنهایی سازگاری کامل عامل را اثبات نمی‌کند. منبع و مدل را در گزارش درخواست OmniProxy بررسی کنید.

منابع رسمی · ComfyUI ↗