Cài đặt ComfyUI và tạo ảnh lần đầu

Comfy Desktop là ứng dụng máy tính chính thức của ComfyUI, cài đặt đồng thời ComfyUI và môi trường chạy cần thiết nên bạn không phải tự cấu hình riêng Python, CUDA hoặc pip. Bạn cũng có thể giữ nhiều bản cài đặt trên cùng một máy tính; mỗi bản hoạt động độc lập, phù hợp để thử riêng các phiên bản hoặc cấu hình khác nhau.

Chuẩn bị trước khi cài đặt

Trước tiên, hãy xác nhận máy tính đáp ứng các điều kiện sau:

• Windows 10 trở lên, hỗ trợ x64 hoặc ARM64. Nên sử dụng card đồ họa rời NVIDIA hoặc AMD, nhưng vẫn có thể cài đặt nếu không có card đồ họa rời.
• macOS 13 (Ventura) trở lên và bắt buộc sử dụng chip Apple (M1 trở lên).
• Linux. Gói cài đặt có định dạng .deb và AppImage; nên sử dụng Ubuntu 22.04 trở lên với kiến trúc x64.

Mỗi bản cài đặt ComfyUI cần khoảng 4.85 GB dung lượng ổ đĩa. Hãy chuẩn bị ít nhất 8 GB RAM; 16 GB sẽ phù hợp hơn khi sử dụng. Các mô hình hình ảnh tải xuống sau đó sẽ chiếm thêm dung lượng ổ đĩa.

macOS

Mở dmg

• Kéo vào Applications
• Lần đầu, vào Privacy & Security
• Nhấn Open Anyway

Windows

Chạy exe

• Windows 10 hoặc mới hơn
• x64 hoặc ARM64
• Tạo bản cài đặt trên trang chào mừng

Linux

deb hoặc AppImage

• Khuyến nghị Ubuntu 22.04+
• x64
• Nếu không khởi động được, hãy xem hướng dẫn về sandbox

Cài đặt và khởi chạy lần đầu

Truy cập trang tải xuống Comfy Desktop để lấy gói cài đặt. Trang này sẽ tự động nhận diện hệ điều hành bạn đang sử dụng.

macOS

1. Mở tệp .dmg đã tải xuống.
2. Kéo Comfy Desktop vào thư mục Applications.
3. Mở Comfy Desktop từ Launchpad hoặc Spotlight Search.

Khi khởi chạy lần đầu, macOS có thể hiển thị cảnh báo bảo mật. Khi đó, hãy mở Privacy & Security (Quyền riêng tư & Bảo mật) trong phần cài đặt hệ thống rồi nhấp vào Open Anyway (Vẫn mở); nút này cho phép hệ thống khởi chạy ứng dụng vừa bị chặn.

Windows

Chạy tệp .exe đã tải xuống (gói cài đặt NSIS), làm theo hướng dẫn trên màn hình để hoàn tất cài đặt, sau đó mở Comfy Desktop từ menu Start hoặc lối tắt trên màn hình nền.

Trong lần khởi chạy đầu tiên, màn hình chào mừng sẽ xuất hiện. Tại đây, bạn có thể tạo bản cài đặt ComfyUI đầu tiên.

Linux

Linux sử dụng liên kết tải xuống chung. Người dùng Debian hoặc Ubuntu hãy mở thư mục tải xuống chứa gói cài đặt, sau đó chạy:

sudo apt install ./*.deb

Khi sử dụng AppImage, hãy chạy:

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

Nếu ứng dụng không khởi chạy được, có thể bản phân phối Linux đang chặn sandbox của Electron. Ubuntu 24.04 trở lên giới hạn không gian tên của người dùng không có đặc quyền thông qua AppArmor. Chỉ thêm --no-sandbox để thử lại sau khi xác nhận lỗi khởi chạy là do sandbox. Tham số này sẽ tắt sandbox Electron cho từng tiến trình và không nên được sử dụng trong các trường hợp khác.

Sau khi mở Comfy Desktop, trang Chooser sẽ liệt kê các phiên bản cài đặt hiện có. Nhấp vào New Instance để tạo một bản cài đặt ComfyUI mới, độc lập với các bản khác, rồi nhấp vào thẻ của phiên bản tương ứng để khởi chạy.

Phiên bản máy tính mặc định theo dõi bản ổn định. Nếu muốn theo dõi mọi commit mới nhất trên GitHub, bạn có thể chuyển sang bản portable, cài đặt thủ công bằng git hoặc đổi kênh cập nhật của phiên bản thành Latest on GitHub.

Lấy thông số kết nối từ OmniProxy

Không có địa chỉ, khóa hoặc model ID dùng chung để điền tại đây. Việc cài đặt Comfy Desktop và hoàn tất quy trình tạo ảnh từ văn bản cơ bản đều không cần OmniProxy.

Không điền Base URL của công cụ khác vào các node không rõ nguồn gốc. Hãy đợi đến khi có hướng dẫn tích hợp chung rõ ràng rồi mới cấu hình riêng.

Điền cấu hình công cụ

Không có biểu mẫu cấu hình OmniProxy tại đây. Để tạo ảnh lần đầu, trước tiên bạn cần chuẩn bị workflow và mô hình hình ảnh.

Có thể hiểu workflow là một tập hợp các bước tạo ảnh, còn node là các mô-đun thao tác chịu trách nhiệm tải mô hình, nhận văn bản hoặc lưu ảnh. Sau khi ComfyUI khởi chạy, workflow tạo ảnh từ văn bản mặc định thường sẽ tự động được tải.

Nếu cần mở workflow khác, bạn có thể chọn Workflows → Open trong menu; tùy chọn này dùng để tải hình ảnh có chứa thông tin workflow hoặc tệp workflow JSON.

Phần lớn bản cài đặt mặc định không đi kèm mô hình nền tảng. Sau khi tải workflow, nếu máy tính không có v1-5-pruned-emaonly-fp16.safetensors, giao diện sẽ thông báo thiếu mô hình. Mở cảnh báo để xem mô hình còn thiếu và liên kết tải xuống tương ứng.

Để xem thư mục mô hình mà bản cài đặt hiện tại đang sử dụng, hãy nhấp vào menu dạng viên thuốc ở phía trên, sau đó mở Storage; mục này cho biết vị trí lưu thực tế của mô hình và các tệp khác. Menu dạng viên thuốc phía trên chỉ có trong ứng dụng máy tính. Nhấp vào biểu tượng thư mục bên cạnh đường dẫn để mở trực tiếp thư mục đó trong trình quản lý tệp của hệ thống.

Có hai cách tải mô hình:

• Nhấp vào Download trên giao diện; nút này sẽ bắt đầu tải mô hình còn thiếu. Phiên bản máy tính sẽ lưu mô hình vào ComfyUI/models/checkpoints của bản cài đặt hiện tại. Bạn có thể xem tiến trình tải xuống trong bảng mô hình ở thanh bên. Tệp tải xuống tự động thường đến từ Hugging Face, vì vậy mạng của bạn cần truy cập được Hugging Face.
• Nếu trong thời gian dài không có tiến trình tải xuống, bạn có thể sao chép liên kết tải xuống trong phần chi tiết của mô hình còn thiếu, tải tệp theo cách thủ công và lưu vào cùng thư mục checkpoints, sau đó làm mới hoặc khởi động lại ComfyUI.

Sau khi đặt mô hình đúng vị trí, hãy nhấn phím R để giao diện đọc lại danh sách mô hình trong các node.

Ứng dụng

Comfy Desktop

• Nó phụ trách cài đặt môi trường
• Dùng trang chào mừng hoặc tạo phiên bản mới
• Nhấn vào thẻ để khởi động

Quy trình làm việc

Tạo ảnh từ văn bản

• Thường được tải tự động
• Cũng có thể mở từ menu
• Sẽ có cảnh báo nếu thiếu mô hình

Mô hình

checkpoints

• Tải xuống từ liên kết trong cảnh báo
• Bản desktop có thể tự động lưu
• Nhấn R để làm mới danh sách

Kiểm tra bằng một tác vụ thực tế

Sau khi chuẩn bị xong mô hình, hãy làm theo các bước sau để thử tạo ảnh lần đầu:

1. Trong node Load Checkpoint, chọn v1-5-pruned-emaonly-fp16.safetensors. Node này chịu trách nhiệm tải mô hình sẽ được sử dụng cho tác vụ tạo ảnh hiện tại.
2. Nhấp vào Run hoặc nhấn Ctrl + Enter. Run dùng để bắt đầu thực thi tác vụ tạo ảnh hiện tại.
3. Kết quả tạo sẽ xuất hiện trong node Save Image. Node này dùng để xem trước và lưu ảnh cuối cùng; bạn có thể nhấp chuột phải để lưu ảnh vào máy.

Nếu không có mô hình trong Load Checkpoint hoặc danh sách thả xuống hiển thị null, hãy kiểm tra thư mục mô hình trước, sau đó làm mới hoặc khởi động lại ComfyUI.

Tính đến ngày 2026-10-09, đã xác nhận trên macOS rằng Comfy Desktop 1.1.6 lấy từ tệp dmg chính thức có thể khởi chạy. Do vẫn cần tạo bản cài đặt trong ứng dụng và tải mô hình checkpoint, quy trình tạo ảnh lần đầu chưa được hoàn tất. Vì vậy, hướng dẫn này không tuyên bố đã tạo ảnh thành công và cũng chưa tích hợp OmniProxy vào ComfyUI.

Mô hình

Danh sách thả xuống có tên

• Không phải null
• Đã chọn checkpoint
• Đã nhấn R để làm mới

Tạo ảnh

Nhấn Run

• Hoặc nhấn Ctrl+Enter
• Chờ các nút chạy xong
• Ảnh nằm trong Save Image

Phạm vi

Tạm thời không kết nối gateway

• Không có mục cấu hình chung
• Không cài các nút không rõ nguồn gốc
• Chỉ cần tạo ảnh thành công

Lỗi thường gặp

• Không mở được trên macOS: vào Cài đặt hệ thống → Quyền riêng tư & Bảo mật, rồi nhấp vào Vẫn mở. Gói cài đặt chỉ hỗ trợ chip Apple và macOS 13 trở lên.
• Ứng dụng thoát ngay khi khởi chạy trên Linux: trước tiên hãy xác nhận bạn đang sử dụng .deb hoặc AppImage. Chỉ thêm --no-sandbox sau khi chắc chắn việc khởi chạy thất bại là do sandbox.
• Thông báo thiếu mô hình: tải mô hình checkpoint qua liên kết trong cảnh báo, lưu vào models/checkpoints của bản cài đặt hiện tại, sau đó nhấn R để làm mới.
• Danh sách thả xuống của mô hình hiển thị null: dùng Storage để kiểm tra thư mục mô hình, xác nhận tệp đã được đặt đúng vị trí, rồi làm mới hoặc khởi động lại.
• Muốn điền OmniProxy tại đây: hiện không có trường tích hợp chung. Không cài thêm các node chưa được mô tả rõ ràng là phương thức tích hợp chung.

Tài liệu tham khảo chính thức

Xem tổng quan cài đặt tại Comfy Desktop. Xem các bước cài đặt cho từng nền tảng tại macOS, Windows và Linux. Xem cách sử dụng giao diện máy tính tại Using Comfy Desktop. Xem các bước tạo ảnh lần đầu tại Getting Started with AI Image Generation.

Thay thế mọi chỗ giữ chỗ bằng giá trị từ cấu hình OmniProxy của riêng bạn. Không bao giờ công bố khóa thật.

Kết quả được lưu hoặc mã HTTP 200 đơn lẻ không chứng minh khả năng tương thích đầy đủ của Agent. Hãy kiểm tra nguồn và mô hình trong bản ghi lệnh gọi của OmniProxy.

Nguồn chính thức · ComfyUI ↗