Repo ComfyUI VNCCS trên GitHub Python chính thức Hugging Face chính thức Danh mục giấy phép mã nguồn mở

Tạo sprite nhân vật visual novel với ComfyUI VNCCS

ComfyUI VNCCS — tên đầy đủ là Visual Novel Character Creation Suite — là bộ custom node cho ComfyUI, sinh ra để giải một bài toán rất cụ thể: tạo sprite nhân vật visual novel có ngoại hình nhất quán qua hàng chục ảnh khác nhau. Repo của AHEKOT không bán cho bạn một workflow đơn lẻ; nó là pipeline bốn bước gồm Character Creator, Character Cloner, Clothes và Emotions, kèm cả công cụ quản lý tư thế lẫn biểu cảm. README tự mô tả toàn bộ quy trình gói trong bốn lần bấm nút. Điều đáng chú ý nhất: đây là công cụ tổ chức tài nguyên nhân vật, không phải một model sinh ảnh mới.

Nội dung

Thank you for reading this post, don't forget to subscribe!

Nhân vật visual novel trôi mỗi ảnh? Cách này giữ nhất quán

VNCCS sinh ra để chữa nỗi đau nào của người làm visual novel?

Nỗi đau nằm ở tấm ảnh thứ hai, không phải tấm đầu. Sinh một nhân vật đẹp thì model nào cũng làm được, nhưng giữ đúng khuôn mặt, màu mắt, độ dài tóc và bộ đồ đó qua hai mươi tư thế và mười hai biểu cảm là chuyện khác hẳn. README mở đầu bằng đúng nhận định ấy: tạo một nhân vật duy nhất trông giống hệt nhau ở mọi ảnh vốn khó hơn nhiều so với việc tạo một bức ảnh.

Cách làm thủ công — generate ảnh gốc rồi img2img cho từng tư thế — có một nhược điểm chết người: nhân vật trôi. Mỗi lần chạy, màu mắt lệch một chút, tóc ngắn đi một đoạn, cổ áo đổi kiểu. Sau mười ảnh thì đó đã là một người khác. VNCCS xử lý bằng cách biến nhân vật thành một thực thể được lưu trữ, có tên, có hồ sơ, rồi mọi workflow đều đọc lại đúng hồ sơ đó thay vì đoán mò từ ảnh.

Vấn đề thứ hai là tổ chức. Một dự án visual novel cần nhân vật nhân với trang phục nhân với biểu cảm nhân với tư thế, và bạn phải biết tấm nào là tấm nào. VNCCS không chỉ generate mà còn xếp sprite vào cây thư mục riêng tại ComfyUI\output\VNCCS\Characters\. README nhắc khá nghiêm túc: cẩn thận khi dọn ổ đĩa, đừng xóa nhầm thư mục đó.

Cài VNCCS vào ComfyUI: ba đường, một bước ai cũng quên

README chia người cài thành hai nhóm và đưa ra ba con đường, nhưng điểm chung là bước cuối ai cũng bỏ qua: cài xong phải vào Comfy Manager bấm Install missing custom nodes. Không làm bước đó, workflow mở ra sẽ thiếu node phụ thuộc và báo lỗi đỏ ngay.

Người mới hoàn toàn: dùng VNCCS Easy Install. README nói bộ này cài ComfyUI kèm cấu hình sẵn và node VNCCS chạy được luôn. README không nêu dung lượng, đường dẫn tải hay yêu cầu hệ thống của bộ cài này.
Người đã có ComfyUI: mở Custom Nodes Manager, tìm VNCCS - Visual Novel Character Creation Suite và chọn install latest version. Đây cũng chính là con đường ComfyUI Manager mà hầu hết bài hướng dẫn khác khuyên dùng, và là cách gọn nhất để nhận bản cập nhật về sau.
Cài tay: chép thư mục đã tải vào ComfyUI/custom_nodes/. Hoặc mở console tại ComfyUI/custom_nodes/ và chạy lần lượt git clone https://github.com/AHEKOT/ComfyUI_VNCCS.git, tiếp đó cd VNCCS_Utils, rồi pip install -r requirements.txt. Bước pip này cần Python có sẵn trên máy.

Sau đó khởi động lại ComfyUI, mở Comfy Manager và bấm Install missing custom nodes. Đây không phải bước tùy chọn, vì VNCCS gọi khá nhiều node từ repo khác.

Cảnh báo riêng của README: Pose Studio được tải từ project thứ hai tên VNCCS-Utils, nên bạn phải cài thêm nó. Đừng nhầm với các sản phẩm khác cùng họ VNCCS xuất hiện trên mạng — README của repo này chỉ nhắc đúng một cái tên phụ thuộc là VNCCS-Utils.

Bốn workflow của VNCCS 3.0 nối nhau thành dây chuyền

VNCCS 3.0 chia công việc thành bốn file workflow rời, chạy theo thứ tự và dùng chung một thư viện nhân vật. Mỗi bước chỉ làm một việc, kết quả bước trước là đầu vào bước sau. Hiểu thứ tự này quan trọng hơn hiểu từng tham số.

Bước 0 — Migration assistant. Chỉ dành cho người đã dùng VNCCS bản cũ. README khẳng định nhân vật của bạn an toàn, nhưng bạn phải mở VNCCS_MigrationAssistant.json, chọn nhân vật và bấm migrate để chuyển sang định dạng mới. README còn viết hoa hẳn một dòng cảnh báo: hãy kiểm tra nhân vật chạy đúng trước khi xóa thư mục cũ.

Bước 1 — Character Creator. Mở VNCCS_3.0_Step1_CharacterCreator.json. Trong VNCCS Control Center bạn chọn model dùng cho cả workflow rồi bấm Download. Tiếp đó là VNCCS Character Creator V2: bấm NEW, đặt tên nhân vật — README nhấn mạnh cái tên rất quan trọng, hãy đặt tên riêng và dễ nhớ — rồi đi tiếp bằng một trong hai cách.

Cách một là tự gõ tag, với các nút bút chì phía trên ô nhập đóng vai trò tag builder, chọn giới tính, độ tuổi và kiểu generate; công tắc NSFW quyết định nhân vật gốc có mặc đồ hay không. Cách hai là bấm CHARACTER WIZZARD, mô tả nhân vật bằng lời và để hệ thống tự điền các lựa chọn, nhưng README dặn rõ phải kiểm tra lại. Nút GENERATE PREVIEW cho phép xem trước ngoại hình mà không phải chạy lại toàn bộ quá trình; không ưng thì sửa tag rồi bấm lại.

Chọn model sinh nhân vật cũng nằm ở bước này. README đưa hai lựa chọn. Illustrious tuy được coi là cũ nhưng tạo nhân vật xuất sắc và có lượng LoRA khổng lồ cho mọi phong cách, chất lượng không đáng lo. Anima mới hơn, làm được gần như mọi thứ nhưng ngốn tài nguyên hơn và chưa có nhiều LoRA. Tác giả khuyên thử cả hai rồi tự quyết.

Song song đó là ba mức model trong Control Center:

Mức trong Control Center	README mô tả
Q4	Nhẹ nhất, hợp máy yếu, nhưng ở một số chỗ kết quả có thể kém hào nhoáng hơn
Q5	Cân bằng giữa chất lượng và hiệu năng, được xem là lựa chọn hợp lý cho phần lớn người dùng
Q8	Nặng nhất, nhưng cho ra nhân vật đẹp nhất
VRAM tối thiểu, dung lượng file, tốc độ	README không nêu

Bước 1.1 — Character Cloner. Đây là bản sao của Character Creator nhưng dành cho ảnh nhân vật có sẵn: ảnh bạn tải trên mạng, chụp từ anime, hay tự vẽ. README lưu ý ảnh nên có chất lượng tốt và là ảnh toàn thân, vì phần cơ thể không nhìn thấy sẽ do model tự bịa ra. Bạn nạp ảnh vào, viết tag hoặc bấm ANALYZE CAPTIONS, cấu hình Pose Studio, và cân nhắc bật NSFW nếu muốn có sẵn sprite không mặc đồ. README nói rõ chúng không bắt buộc, nhưng về sau mặc đồ cho nhân vật sẽ dễ hơn nhiều.

Bước 2 — Character Clothes. Trong VNCCS Clothes Designer, chọn nhân vật, bấm New và đặt tên cho bộ trang phục. Bạn mô tả từng phần quần áo vào các ô tương ứng, hoặc bấm Clothes Wizzard để mô tả tổng thể. README nhấn mạnh hai ô head và face: khai báo kỹ ở đây giúp không mất chi tiết về sau, ví dụ kính thì ghi vào face, mũ thì ghi vào head. Còn một tab riêng tên CLONE CLOTHES cho phép tải ảnh quần áo có sẵn để nhân bản. Nút GENERATE PREVIEW vẫn dùng được trước khi chạy toàn bộ.

Bước 3 — Character Emotions. Đây là bước biến mọi sprite mặt lạnh thành một bộ biểu cảm. Trong VNCCS Emotion Studio, chọn nhân vật, chọn các bộ trang phục muốn áp dụng, rồi tick từng biểu cảm trong danh sách. Không có biểu cảm nào vừa ý thì thêm Custom emotion và tự mô tả.

Tham số quan trọng nhất ở bước này là Face Detailer Denoise. README giải thích nó theo một trục duy nhất: denoise càng cao thì ảnh gốc càng bị thay đổi, biểu cảm càng rõ nhưng nhân vật càng dễ mất nét; denoise càng thấp thì càng giống nhân vật gốc nhưng biểu cảm càng nhạt. README nói thẳng không có công thức sẵn, và khuyên đừng chọn hết trang phục lẫn biểu cảm ngay lần đầu — chạy ít một để tìm ngưỡng phù hợp rồi hãy chạy hết.

Cuối cùng, mọi sprite nằm trong ComfyUI\output\VNCCS\Characters\.

Pose Studio: đặt sai tỉ lệ cơ thể thì hỏng cái gì?

Pose Studio là node đến từ VNCCS-Utils, và nó là chỗ tập trung nhiều sai sót nhất khi mới dùng. Nhiệm vụ của nó là chọn tư thế và số lượng tư thế; nút Import cho phép nạp một tấm ảnh bất kỳ có nhân vật rồi lấy lại tư thế y như trong ảnh. Nhưng README cảnh báo một thứ trước cả chuyện tư thế: tỉ lệ cơ thể của model phải khớp với nhân vật.

Cụ thể, tuổi được lấy tự động từ bước trước, nhưng bạn nên tự đặt lại chiều cao và kiểu thân hình. README nói kết quả sẽ tốt hơn nhiều nếu làm vậy. Đây là kiểu tham số mà người mới hay để mặc định vì nghĩ nó không quan trọng, rồi thắc mắc tại sao nhân vật ra dáng người khác.

Tiếp theo là khâu tách nền. BG Remove có các preset chroma key, trong đó Balanced được README đánh giá là preset rất tốt. Nhưng nếu nó chưa đủ, hoặc ngược lại là quá tay đến mức làm hỏng nhân vật, bạn chuyển sang preset nhẹ hơn. SAM3 Details Recovery làm bước tách nền chậm hơn nhưng giúp bạn đỡ phải lo về mắt hoặc chi tiết quần áo trùng màu nền.

Và đây là mẹo đáng giá nhất trong cả README: hãy chọn màu nền ít xuất hiện nhất trên nhân vật. Nhìn vào mắt và tóc trước — nếu chúng xanh lá, chọn nền xanh dương, hoặc ngược lại. Với Character Cloner, lời khuyên này càng đúng, vì bạn không kiểm soát được nhân vật gốc.

Ở VNCCS Character Generator, README nói bạn không cần bận tâm nhiều về tham số, nhưng có thể chọn model upscale hoặc tắt hẳn. Repo không nói mặc định là model nào.

Hiện tượng	Cách xử lý mà README gợi ý
Mắt hoặc phụ kiện quần áo cùng màu nền bị ăn mất	Bật SAM3 Details Recovery, chấp nhận chậm hơn
Preset Balanced tách nền quá tay, lem vào nhân vật	Đổi sang preset chroma key nhẹ hơn
Nhân vật ra tư thế sai tỉ lệ, trông không giống bản gốc	Chỉnh lại tuổi, chiều cao và body type trong Pose Studio
Biểu cảm quá mạnh, nhân vật mất nét riêng	Giảm Face Detailer Denoise
Biểu cảm nhạt, gần như không khác ảnh gốc	Tăng Face Detailer Denoise
Chạy một lượt quá nhiều trang phục và biểu cảm	README khuyên tách ra, chạy ít trước để tìm ngưỡng

VNCCS đứng ở đâu giữa Qwen Image, SeedVR2 và CivitAI?

Câu trả lời ngắn: VNCCS không cạnh tranh với các model sinh ảnh, nó ngồi ở tầng trên. Hiểu sai tầng sẽ khiến bạn đi tải nhầm thứ.

Qwen Image và bản đóng gói Qwen-Image_ComfyUI là model sinh ảnh — chúng tạo ra hình, còn VNCCS tổ chức hình thành bộ sprite nhất quán. Bạn có thể dùng Qwen Image cho khâu dựng nền hoặc CG, nhưng nó không có khái niệm nhân vật, bộ trang phục hay biểu cảm. README của VNCCS không nhắc Qwen Image; model được nêu tên chỉ có Illustrious và Anima.

SeedVR2 là công cụ upscale. VNCCS Character Generator có ô chọn model upscale, nhưng README không nói nó dùng model nào, cũng không xác nhận hỗ trợ SeedVR2. Nếu muốn ghép SeedVR2 vào, đó là việc bạn tự cấu hình trong ComfyUI, không phải thứ repo làm sẵn.

CivitAI là nơi bạn sẽ dành khá nhiều thời gian. README nói Illustrious có lượng LoRA khổng lồ cho mọi phong cách, còn Anima thì ít hơn — nghĩa là lựa chọn model ở bước 1 kéo theo việc bạn có bao nhiêu LoRA để chơi. Còn chuyện BF16 GGUF mà các bài khác nhắc tới thì nên đọc cẩn thận: README chỉ nói tới Q4, Q5, Q8 và không xác nhận đó là định dạng GGUF hay tối ưu cho nền đẹp.

ComfyUI Manager là đường cài chuẩn. ComfyUI Cloud thì README không nói gì — toàn bộ hướng dẫn đều giả định bạn chạy ComfyUI cục bộ. Và nếu bạn bắt gặp những cái tên như VNCCS 3D Factory, VNCCS UniCanvas hay VNCCS Sprite Generator ở nơi khác, hãy biết rằng README của repo này không nêu tên nào trong số đó.

VNCCS chưa làm được gì, và dự án còn sống không?

README tự liệt kê phần chưa có: animation, môi trường 3D, tạo ảnh CG trong môi trường 3D đó, sinh giọng nói cho nhân vật và sinh nhạc nền cho game. Tất cả đều nằm ở thì tương lai. Ở bản hiện tại, bạn chỉ có sprite tĩnh.

Một loạt thứ khác README không nêu, và bạn nên coi đó là khoảng trống phải tự kiểm chứng:

Giấy phép. README không ghi license, nên chưa có cơ sở nào để nói bạn được dùng thương mại hay không. Muốn chắc, phải hỏi trực tiếp tác giả.
Nhịp cập nhật. Bản 3.0 được gọi là cập nhật lớn, nhưng README không có changelog, không có ngày phát hành, không có số phiên bản trước đó.
Yêu cầu phần cứng. Không có VRAM tối thiểu, không có dung lượng model, không có thời gian generate mẫu. Chỉ có gợi ý Q4 nhẹ, Q5 cân bằng, Q8 nặng.
Giới hạn kỹ thuật. Không nói tối đa bao nhiêu tư thế hay bao nhiêu bộ đồ, cũng không nói độ phân giải sprite đầu ra.

Về người bảo trì, README chỉ cho thấy repo do một tác giả là AHEKOT phát triển độc lập, có kênh cộng đồng để chia sẻ kết quả và hỏi đáp, cùng lời kêu gọi ủng hộ. Không có số liệu nào về số người đóng góp hay tần suất commit. Nói cách khác: đây là dự án một người, và bạn nên định giá rủi ro đó trước khi đặt cả pipeline của mình lên nó.

Câu hỏi thường gặp

Có phải cài thêm VNCCS-Utils mới dùng được Pose Studio?

Đúng. README nói rõ Pose Studio được tải từ project thứ hai tên VNCCS-Utils, nên bạn phải cài nó cùng. Nếu chỉ cài VNCCS mà bỏ qua bước này, các workflow có Pose Studio sẽ thiếu node. Sau khi cài, hãy vào Comfy Manager bấm Install missing custom nodes để ComfyUI tự bù các phụ thuộc còn lại.

Đang dùng VNCCS bản cũ, nhân vật có bị mất khi lên 3.0?

README khẳng định nhân vật của bạn an toàn, nhưng bắt buộc phải chạy công cụ chuyển đổi. Mở VNCCS_MigrationAssistant.json, chọn nhân vật rồi bấm migrate để chuyển sang định dạng mới. README cảnh báo bằng chữ in hoa: hãy kiểm tra nhân vật hoạt động đúng trước khi xóa thư mục cũ.

VNCCS có chạy được trên ComfyUI Cloud không?

README không nêu. Toàn bộ hướng dẫn cài đặt trong repo đều giả định bạn cài trên máy cục bộ, hoặc dùng bộ VNCCS Easy Install dựng sẵn ComfyUI. Không có mục nào nói về môi trường cloud, nên bạn phải tự thử và tự chịu rủi ro về dung lượng model cũng như chi phí lưu trữ.

Dùng VNCCS cho dự án thương mại có được không?

README không nêu giấy phép, nên tài liệu không trả lời được câu này. Bạn cũng cần kiểm tra giấy phép của checkpoint Illustrious hoặc Anima mà mình tải về, vì đó mới là thứ bạn thực sự phân phối trong sản phẩm. Hãy liên hệ tác giả repo trước khi dùng cho game bán.

Model nào nên chọn: Illustrious hay Anima?

README không chọn hộ bạn. Illustrious được mô tả là cũ nhưng ổn định, tạo nhân vật tốt và có rất nhiều LoRA; Anima mới hơn, làm được gần như mọi thứ nhưng cần nhiều tài nguyên hơn và ít LoRA hơn. Ở bước cảm xúc, README nói Anima cho biểu cảm hay hơn nhưng có thể thay đổi chi tiết nhân vật quá nhiều.

Nguồn tham khảo

Bắt đầu VNCCS từ đâu nếu bạn chỉ có một buổi tối

Đừng cài xong rồi chạy hết mọi thứ ngay. Hãy đi đúng thứ tự mà README vạch ra: cài qua ComfyUI Manager, đừng quên VNCCS-Utils và nút Install missing custom nodes, rồi mở đúng file Step1. Chọn Q5, tạo một nhân vật, bật GENERATE PREVIEW để xem mặt trước khi chạy. Chỉ chọn một tư thế cho lần đầu.

Sang bước trang phục, làm đúng một bộ và điền kỹ ô head với face. Sang bước biểu cảm, chọn hai biểu cảm thay vì hai mươi, và chỉnh Face Detailer Denoise cho tới khi vừa ý rồi mới nhân rộng. Một buổi tối là đủ để biết công cụ này có hợp với bạn hay không.

Nếu bạn chỉ cần vài tấm ảnh đẹp để đăng mạng, VNCCS là quá nhiều máy móc. Nếu bạn đang làm một visual novel cần hàng trăm sprite nhất quán, hoặc dự án game cần quản lý nhân vật theo bộ trang phục và biểu cảm, thì đây là một trong số ít công cụ mã nguồn mở giải đúng bài toán đó — miễn là bạn chấp nhận rằng tài liệu còn thiếu nhiều con số và dự án chỉ có một người gánh.