Chuyển đến nội dung

sczhou / CodeFormer

CodeFormer

AI khôi phục khuôn mặt trong ảnh cũ, mờ, hỏng hoặc ảnh do AI tạo, giấy phép chỉ phi thương mại

CodeFormer là mô hình khôi phục khuôn mặt (NeurIPS 2022) do nhóm S-Lab thuộc Đại học Công nghệ Nanyang xây dựng. Nó làm rõ khuôn mặt trong ảnh mờ, nhiễu hoặc hỏng, và còn tô màu hay vá khuôn mặt. Bạn chạy bằng Python, có thể chỉnh mức cân bằng giữa chất lượng và độ giống ảnh gốc. Chú ý: giấy phép S-Lab 1.0 chỉ cho dùng phi thương mại.

  • 18.241 sao
  • 3.721 fork
  • Python
  • Cập nhật 12 tháng trước
  • Giấy phép riêng, xem trên GitHub
Độ khó
Khó Dành cho người biết lập trình
Dạng
Mô hình AI, Dòng lệnh (CLI)
Chạy trên
Python, Linux, Windows
Chi phí
Miễn phí cho cá nhân

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)

  1. Tải mã nguồn và tạo môi trường conda riêng như README.

    Terminal
    git clone https://github.com/sczhou/CodeFormer
    cd CodeFormer
    conda create -n codeformer python=3.8 -y
    conda activate codeformer
  2. Cài các gói Python và thiết lập basicsr.

    Terminal
    pip3 install -r requirements.txt
    python basicsr/setup.py develop
  3. Tả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.

    Terminal
    python scripts/download_pretrained_models.py facelib
    python scripts/download_pretrained_models.py CodeFormer

Dùng thử lần đầu

  1. Đặt ảnh cần xử lý vào thư mục inputs/TestWhole trong thư mục dự án.

  2. 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.

    Terminal
    python inference_codeformer.py -w 0.7 --input_path inputs/TestWhole
  3. Mở 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.

  4. 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.

Terminal
git clone https://github.com/sczhou/CodeFormer.git

Repo tương tự nên xem

Tạo ảnh & video bằng AI37,7K

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

KhóPythonLinuxWindows
Tạo ảnh & video bằng AI37,5K

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

VừaWindowsmacOSLinuxPython
Tạo ảnh & video bằng AI52,7K

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

DễWindowsmacOSLinux

Nội dung được biên soạn bằng tiếng Việt dựa trên tài liệu chính thức của dự án, cập nhật lần cuối 16/11/2026. Lệnh cài có thể thay đổi theo phiên bản mới; nếu có khác biệt, hãy làm theo README trên GitHub.

Cùng chủ đề: Tạo ảnh & video bằng AI

Tạo ảnh & video bằng AI165K

Stable Diffusion web UI (AUTOMATIC1111)

AUTOMATIC1111 / stable-diffusion-webui

Giao diện web kinh điển để tạo ảnh bằng Stable Diffusion ngay trên máy tính của bạn

VừaWindowsLinuxmacOSPython
Tạo ảnh & video bằng AI147K

ComfyUI

Comfy-Org / ComfyUI

Tạo ảnh, video, âm thanh bằng AI ngay trên máy bằng cách nối các khối (node) thành quy trình

VừaWindowsmacOSLinuxPython
Tạo ảnh & video bằng AI144K

MoneyPrinterTurbo

harry0703 / MoneyPrinterTurbo

Nhập chủ đề, tự có video ngắn: kịch bản, giọng đọc, cảnh quay, phụ đề và nhạc

VừaWindowsmacOSLinuxDocker+1
Tạo ảnh & video bằng AI53,9K

Fooocus

lllyasviel / Fooocus

Tạo ảnh AI kiểu Midjourney ngay trên máy bạn, chỉ cần gõ mô tả, ít phải chỉnh thông số

DễWindowsLinuxmacOSPython
Tạo ảnh & video bằng AI29,9K

Open-Sora

hpcaitech / Open-Sora

Mô hình tạo video từ chữ và ảnh mã nguồn mở, kèm toàn bộ mã huấn luyện, cần GPU rất mạnh

KhóLinuxPython
Tạo ảnh & video bằng AI29,1K

Invoke (InvokeAI)

invoke-ai / InvokeAI

Xưởng tạo ảnh AI có canvas và workflow, cài bằng trình khởi chạy chính thức

VừaWindowsmacOSLinuxDocker+1

Xem cả 26 repo Tạo ảnh & video bằng AI Về Kho Repo