Repo này tên nvzhuang (拍片哥女装), một site tra cứu ảnh trang phục do AI sinh ra, kèm phần thử đồ ảo tùy chọn. Nghe hơi lạ nhưng cấu trúc rõ ràng: frontend tĩnh thuần HTML/JS, backend Go dùng GoFrame v2, database ảnh gồm 1407 tấm tỷ lệ 2:3, nhân vật không lộ mặt, đúng kiểu “服装参考” để làm moodboard hoặc tham khảo thiết kế.
Vấn đề nó giải quyết khá cụ thể: bạn cần một bộ ảnh quần áo sạch, không dính bản quyền ảnh người mẫu, không lẫn mặt người, để nhìn phom dáng, chất liệu, cách phối. Mấy bộ dataset kiểu DeepFashion hay Fashionpedia thì nặng, cần đăng ký, còn ảnh Pinterest thì lẫn đủ thứ. Ở đây có sẵn 1407 ảnh chia 8 nhóm: xuân 215, hạ 254, thu 244, đông 253, nội y 199, party 48, đồ bơi 54, gợi cảm 140. Tìm theo từ khóa tiếng Trung hoặc tiếng Anh đều được (white, lace, dress hoặc 白, 蕾丝, 连衣裙).
Phần “thử đồ ảo” mới là chỗ đáng nói
Browse ảnh thì ai cũng làm được. Cái khiến repo này có lý do tồn tại là backend Go nối với các model sinh ảnh để làm virtual try-on: upload ảnh chân dung, chọn một bộ trong gallery (hoặc upload đồ của bạn), model sẽ mặc bộ đó lên người, giữ mặt và tóc. README ghi rõ ba thứ cấu hình được: API Key, Base URL, model name. Đổi model chỉ cần thêm một block YAML, không sửa code.
Danh sách provider hiện có: gpt-image (GPT Image 2 qua OpenAI Images), gemini (Nano Banana 2, tức gemini-3.1-flash-image), doubao (Seedream trên 火山方舟, chạy được trong nước không cần proxy), và comfyui cho local. Cộng thêm nhánh OpenAI-compatible để cắm 通义万相, 智谱 CogView, 硅基流动.
Điểm mình thấy thực dụng nhất là nhánh ComfyUI. Nó chạy Qwen-Image-Edit-2511 (Int8) với LoRA Lightning 4 bước, fallback sang MiniMax H3 nếu workflow chưa sẵn sàng. Không tốn key, không tốn quota, ảnh không rời khỏi máy. Với ai có GPU rời thì đây gần như là lựa chọn mặc định, mấy API cloud chỉ để backup.
Vì sao 655 sao trong 2 ngày
Repo tạo ngày 2026-10-29, cập nhật 2026-10-30, tức là mới tinh. 655 sao trong khoảng thời gian đó thì phần lớn đến từ cộng đồng Linux.do, nơi tác giả tự nhận là “3级常任理事” và viết trong README đúng kiểu meme nội bộ: “升到 3 级就可以解锁看女装大佬”. Đây là kiểu repo được share trong một cộng đồng cụ thể rồi lan ra, không phải kiểu tăng trưởng tự nhiên từ search. Cần phân biệt rõ điều đó khi đánh giá độ “hot”.
Nhưng nó không phải meme rỗng. Phần frontend làm khá chỉn: dark/light theme nhớ theo máy, infinite scroll, phím ←/→ để chuyển ảnh, Esc để đóng, tải PNG gốc, tìm kiếm hai chiều có localize keyword (gõ tiếng Trung thì thuộc tính hiển thị tiếng Trung). Có cả nút mở Taobao image search từ ảnh chi tiết, tiện cho ai muốn mua đồ thật.
Cài và chạy thử
Phần xem ảnh thì khỏi cần cài gì, mở thẳng paipiange.github.io/nvzhuang là dùng. AI try-on mới cần backend. Cách nhanh nhất là Docker Compose, làm đúng 2 lệnh:
# 1. Copy template và điền key (ví dụ ARK_API_KEY của 豆包, hoặc OpenAI)
cp backend/.env.example backend/.env
# 2. Chạy
docker compose up -d
Backend lắng nghe ở cổng 8000. Nếu muốn tinh chỉnh model thì copy thêm file config:
cp backend/manifest/config/config.example.yaml backend/manifest/config/config.yaml
Không copy cũng được, hệ thống tự fallback về template và vẫn nghe cổng 8000. Với Windows, tác giả có sẵn script:
backend\restart.bat
Còn nếu chạy tay bằng Go:
cd backend
export ARK_API_KEY="你的Key"
go run main.go
Docker run một dòng cũng có:
cd backend
docker build -f manifest/docker/Dockerfile -t costume-tryon .
docker run -d --name costume-tryon -p 8000:8000 -e ARK_API_KEY="你的豆包ArkKey" costume-tryon
Frontend tìm backend theo thứ tự: setting lưu trong browser, biến window.AI_API_URL, query param ?tryon=, rồi fallback http://127.0.0.1:8000 nếu bạn đang mở từ localhost. Lưu ý query param chỉ cho phép same-origin hoặc loopback, tác giả chặn rồi, tránh bị dùng làm proxy SSRF. Chi tiết này đáng ghi nhận, nhiều repo AI nhỏ bỏ qua.
Ai nên dùng
- Designer hoặc ai làm moodboard cần ảnh trang phục sạch, không mặt người, không vướng bản quyền ảnh mẫu.
- Dev muốn có một frontend gallery mẫu để học cách làm infinite scroll, i18n hai chiều, theme toggle, lưu IndexedDB cho lịch sử sinh ảnh.
- Ai tò mò về kiến trúc pluggable LLM trong Go, xem cách một backend GoFrame gom OpenAI Images, Gemini, Doubao, ComfyUI về cùng một interface.
- Người có GPU rời, muốn thử virtual try-on offline không cần key, không lo ảnh bị gửi lên cloud.
Còn nếu bạn chỉ cần “một site xem đồ đẹp”, mở link online là đủ, không cần clone.
So với lựa chọn khác
Mình không chắc có repo mã nguồn mở nào làm đúng combo “gallery + try-on + ComfyUI local” với license MIT. Mấy project try-on học thuật kiểu OOTDiffusion hay IDM-VTON thiên về research, chạy nặng, không có gallery sẵn. Còn mấy site thương mại như Doubao hay Gemini thì đóng, không có source. Điểm khác biệt của nvzhuang nằm ở chỗ nó là app hoàn chỉnh: gallery, setting, lịch sử, backend deploy được bằng Docker, giấy phép thoáng. Không có gì đột phá về model, nhưng ghép lại thành một sản phẩm dùng được.
Ưu và hạn chế
Ưu: MIT License, dùng thương mại được, sửa được. Backend Go single binary, deploy Docker gọn. Config model tách rời, cắm provider mới không đụng code. Có fallback ComfyUI, có chặn SSRF ở query param, có lưu setting chỉ trong browser và không ghi key vào log hay database. Mấy chi tiết bảo mật nhỏ này cho thấy tác giả có nghĩ.
Hạn chế thì thật: repo mới 2 ngày tuổi, chưa có issue nào đáng kể, API có thể đổi. README tiếng Trung là chính, docs tiếng Anh mỏng, ai không đọc được tiếng Trung sẽ hơi vất vả phần cấu hình ComfyUI. Test coverage không được nhắc tới trong README. Phần lớn sao đến từ một cộng đồng, không phản ánh độ ổn định production. Và đây là project về “nữ trang” nên nội dung có thể không hợp với mọi môi trường công sở, dù bản thân ảnh là ảnh trang phục không lộ mặt.
Cần lưu ý thêm: 1407 ảnh AI sinh ra thì vẫn có thể dính vấn đề bản quyền theo quy định từng nước, MIT chỉ áp cho code và repo, không đảm bảo bạn dùng ảnh thoải mái ở mọi nơi. Đọc 合规审计报告 trong repo trước khi dùng cho mục đích thương mại.
Đây là kiểu repo mình thích: một người làm ra vì cần, làm xong share, code gọn, có đường chạy offline. 655 sao trong 2 ngày thì nên đọc con số đó cùng bối cảnh cộng đồng, nhưng phần kỹ thuật thì đứng độc lập được. Nếu bạn tò mò, clone về, chạy docker compose up -d, mất khoảng 5 phút là có gallery + backend local. Source ở paipiange/nvzhuang.
Câu hỏi thường gặp
nvzhuang là gì và có bao nhiêu ảnh?
Đây là repo tra cứu ảnh trang phục do AI sinh ra kèm phần thử đồ ảo tùy chọn, frontend tĩnh HTML/JS và backend Go dùng GoFrame v2. Database gồm 1407 ảnh tỷ lệ 2:3, nhân vật không lộ mặt, chia 8 nhóm: xuân 215, hạ 254, thu 244, đông 253, nội y 199, party 48, đồ bơi 54, gợi cảm 140.
nvzhuang có chạy được local không cần API key không?
Có, nhờ nhánh ComfyUI chạy Qwen-Image-Edit-2511 (Int8) với LoRA Lightning 4 bước, fallback sang MiniMax H3 nếu workflow chưa sẵn sàng. Cách này không tốn key, không tốn quota và ảnh không rời khỏi máy, phù hợp với ai có GPU rời. Còn muốn dùng cloud thì cấu hình API Key, Base URL, model name qua file YAML.
Cài nvzhuang bằng Docker như thế nào?
Copy backend/.env.example thành backend/.env rồi điền key (ví dụ ARK_API_KEY của 豆包 hoặc OpenAI), sau đó chạy docker compose up -d. Backend lắng nghe ở cổng 8000, mất khoảng 5 phút là có gallery và backend local. Riêng phần xem ảnh thì không cần cài gì, mở thẳng paipiange.github.io/nvzhuang là dùng.
