Trải nghiệm khi dùng CodeFormer
CodeFormer là mã nguồn Python, không có ứng dụng cài sẵn. Bạn tạo môi trường conda, cài các gói trong requirements.txt, rồi chạy script tải các mô hình cần thiết về thư mục weights. Sau đó bạn đặt ảnh cần xử lý vào thư mục đầu vào và chạy script inference_codeformer.py. Kết quả được lưu vào thư mục results.
Điểm đáng chú ý là thông số w từ 0 đến 1. README giải thích w nhỏ cho chất lượng khuôn mặt đẹp hơn, w lớn giữ độ giống người gốc hơn. Vì vậy bạn cân nhắc theo ảnh: ảnh gia đình cần giống thật nên đặt w cao hơn, còn ảnh quá hỏng thì đặt w thấp để mặt nhìn tự nhiên.
Công cụ cũng xử lý được video (đuôi mp4, mov, avi), tô màu khuôn mặt đen trắng hoặc phai màu, và vá khuôn mặt bị che. Nó thường xuất hiện làm tính năng sửa mặt trong các giao diện tạo ảnh khác như Stable Diffusion web UI.
Tính năng nổi bật
Khôi phục mặt từ ảnh chất lượng thấp
Làm rõ khuôn mặt trong ảnh mờ, nhiễu, ảnh cũ hoặc ảnh AI bị méo.
Chỉnh được mức giống gốc
Thông số w cho phép cân giữa chất lượng đẹp và độ giống khuôn mặt thật.
Xử lý cả ảnh toàn cảnh và video
Có thể làm nét nền bằng Real-ESRGAN và xử lý video qua cùng script.
Tô màu và vá khuôn mặt
Có script tô màu cho mặt đen trắng và vá mặt bị che, dùng với ảnh mặt đã căn chỉnh.
Nhiều bộ phát hiện mặt
Hỗ trợ cả dlib cho kết quả giữ nét mặt chính xác hơn, bên cạnh bộ mặc định.
Có mã huấn luyện
Mã huấn luyện và file cấu hình đã công bố cho người nghiên cứu.
Tận dụng CodeFormer vào việc gì?
Gia đình, người lưu giữ ảnh kỷ niệm
Phục hồi ảnh chân dung cũ
Làm rõ khuôn mặt trong ảnh scan của ông bà trước khi in lại, giữ w vừa phải để không làm đổi nét mặt.
Người dùng công cụ tạo ảnh AI
Sửa mặt trong ảnh do AI tạo
Chỉnh khuôn mặt bị méo trong ảnh sinh ra từ các mô hình như Stable Diffusion.
Người làm video
Làm nét video có mặt người
Chạy qua video cũ để mặt rõ hơn, chấp nhận phải thử và chỉnh vài lần.
Sinh viên, lập trình viên
Thử nghiệm xử lý ảnh
Dùng mã nguồn làm điểm xuất phát cho nghiên cứu khôi phục khuôn mặt.
Cần chuẩn bị gì?
- Python (README dùng conda với Python 3.8), PyTorch 1.7.1 trở lên và CUDA 10.1 trở lên theo README.
- Các gói trong requirements.txt cùng bước thiết lập basicsr; dlib chỉ cần khi dùng bộ phát hiện mặt dlib.
- FFmpeg khi xử lý video trên Windows hoặc Mac.
- Card NVIDIA nên có để chạy với tốc độ dễ chịu; README không nêu rõ mức VRAM tối thiểu.
Hướng dẫn cài đặt chi tiết
Cài trên Python (conda)
Tải mã nguồn và tạo môi trường conda riêng như README.
git clone https://github.com/sczhou/CodeFormer cd CodeFormer conda create -n codeformer python=3.8 -y conda activate codeformerCài các gói Python và thiết lập basicsr.
pip3 install -r requirements.txt python basicsr/setup.py developTải các mô hình cần dùng: mô hình phát hiện mặt (facelib) và mô hình CodeFormer.
python scripts/download_pretrained_models.py facelib python scripts/download_pretrained_models.py CodeFormer
Dùng thử lần đầu
Đặt ảnh cần xử lý vào thư mục inputs/TestWhole trong thư mục dự án.
Chạy khôi phục toàn ảnh với w bằng 0,7 như ví dụ trong README, kèm làm nét nền bằng Real-ESRGAN nếu bạn đã cài.
python inference_codeformer.py -w 0.7 --input_path inputs/TestWholeMở thư mục results, so sánh với ảnh gốc, rồi thử w khác (0,5 hoặc 0,9) để xem mặt giống gốc hơn hay đẹp hơn.
Nếu ảnh có nhiều mặt, thử thêm tuỳ chọn --face_upsample để làm nét thêm khuôn mặt.
Mẹo dùng hay
- w thấp cho mặt đẹp hơn nhưng dễ khác người thật; w cao giữ giống thật hơn, nên chọn tuỳ mục đích.
- Dùng bộ phát hiện mặt dlib nếu bạn muốn giữ nét mặt chính xác hơn, theo README, nhưng cần cài thêm dlib.
- Hãy tải CodeFormer chỉ từ kho chính thức; README cảnh báo nhiều trang web không chính thức dùng mô hình này mà không được phép.
Lưu ý và hạn chế
- Giấy phép NTU S-Lab License 1.0 cho phép tái phân phối và dùng phục vụ mục đích phi thương mại. Nếu cần dùng thương mại, hãy liên hệ nhóm tác giả hoặc chọn công cụ khác.
- Mô hình tạo lại chi tiết mặt nên có thể làm gương mặt khác người thật; không dùng kết quả làm bằng chứng hay giấy tờ.
- Phiên bản môi trường trong README khá cũ (Python 3.8); có thể cần chỉnh khi cài trên máy mới, và kho cập nhật lần cuối cuối năm 2025.
Câu hỏi thường gặp
CodeFormer có miễn phí không?
Miễn phí cho mục đích phi thương mại theo giấy phép S-Lab 1.0. Dùng cho công việc kiếm tiền cần được phép riêng.
Khác GFPGAN thế nào?
Cả hai đều khôi phục khuôn mặt. CodeFormer có tham số w để cân bằng chất lượng và độ giống gốc. Bạn nên thử cả hai trên ảnh thật của mình rồi chọn.
Có chạy được trên máy không có card đồ hoạ không?
README đặt yêu cầu CUDA 10.1 trở lên, tức hướng đến card NVIDIA. README không nói rõ về chạy bằng CPU, nên bạn hãy cân nhắc dùng demo trực tuyến hoặc công cụ có giao diện.
Tải mã nguồn về máy
Nếu bạn muốn xem hoặc sửa mã nguồn, mở Terminal (trên Windows là PowerShell) và chạy lệnh dưới. Máy cần cài sẵn Git.
git clone https://github.com/sczhou/CodeFormer.gitRepo tương tự nên xem
GFPGAN
TencentARC / GFPGAN
AI khôi phục khuôn mặt trong ảnh cũ, ảnh mờ, ảnh do AI tạo ra cho rõ nét hơn
Real-ESRGAN
xinntao / Real-ESRGAN
Mô hình AI phóng to và làm nét ảnh, video; có bản chạy ngay không cần cài Python
Upscayl
upscayl / upscayl
Phóng to ảnh mờ, ảnh nhỏ lên nét hơn bằng AI, cài như phần mềm thường, bấm vài nút