How sczhou/codeformer works
CodeFormer is a face-restoration application and BasicSR-based training framework. Its primary user workflow accepts an image or video, restores faces with a fidelity-controlled CodeFormer model, optionally enhances background or face resolution, and saves results; whole-image processing uses face detection, alignment, and compositing. Separate entry points provide face colorization and inpainting. The graph also covers training data, model/loss/metric layers, and documented video and demo support. Source excerpts show only parts of several paths, so unsampled capability links rely on README statements or are omitted.
Main entry points: inference_codeformer.py Face Restoration · models Training Models · inference_colorization.py Face Colorization · inference_inpainting.py Face Inpainting
Components 24
User Inference
- Face Restoration
inference_codeformer.py - Face Colorization
inference_colorization.py - Face Inpainting
inference_inpainting.py
Face Processing
- Face Helper
facelib/utils/face_restoration_helper.py - Face Detection
facelib/detection - Face Parsing
facelib/parsing
Neural Networks
- CodeFormer Network
basicsr/archs/codeformer_arch.py - RRDBNet
basicsr/archs/rrdbnet_arch.py - VQGAN Network
basicsr/archs/vqgan_arch.py - Architecture Utilities
basicsr/archs/arch_util.py
Training System
- Training Runner
basicsr/train.py - Training Models
basicsr/models - Training Datasets
basicsr/data - Data Prefetch
basicsr/data/prefetch_dataloader.py - Training Losses
basicsr/losses/losses.py - Evaluation Metrics
basicsr/metrics/psnr_ssim.py - Model Base
basicsr/models/base_model.py
Media and Support
- Video I/O
basicsr/utils/video_util.py - Real-ESRGAN Support
basicsr/utils/realesrgan_utils.py - Component Registry
basicsr/utils/registry.py - Storage Access
basicsr/utils/file_client.py
Other components
- User
- Image or Video
- Saved Results
Connections 31
- User → Face Restoration: runs
- Image or Video → Face Restoration: provides media
inference_codeformer.py - Face Restoration → CodeFormer Network: loads model
inference_codeformer.py - Face Restoration → Face Helper: processes faces
inference_codeformer.py - Face Helper → Face Detection: detects faces
facelib/utils/face_restoration_helper.py - Face Helper → Face Parsing: parses faces
facelib/utils/face_restoration_helper.py - Face Restoration → Real-ESRGAN Support: optionally upsamples
inference_codeformer.py - Face Restoration → Video I/O: reads and writes video
inference_codeformer.py - Face Restoration → Saved Results: saves outputs
inference_codeformer.py - User → Face Colorization: runs
- Image or Video → Face Colorization: provides face
- Face Colorization → CodeFormer Network: loads model
inference_colorization.py - Face Colorization → Saved Results: saves outputs
- User → Face Inpainting: runs
- Image or Video → Face Inpainting: provides masked face
inference_inpainting.py - Face Inpainting → CodeFormer Network: loads model
inference_inpainting.py - Face Inpainting → Saved Results: saves outputs
- Training Runner → Training Datasets: builds loaders
basicsr/train.py - Training Runner → Data Prefetch: selects prefetcher
basicsr/train.py - Training Runner → Training Models: runs training
basicsr/train.py - Training Models → Model Base: extends base
basicsr/models/sr_model.py - Training Models → CodeFormer Network: builds network
basicsr/models/codeformer_joint_model.py - Training Models → VQGAN Network: builds codebook target
basicsr/models/codeformer_joint_model.py - Training Models → Training Losses: builds losses
basicsr/models/codeformer_joint_model.py - Training Models → Evaluation Metrics: uses metrics
basicsr/models/codeformer_joint_model.py - Training Losses → Architecture Utilities: uses feature network
- RRDBNet → Architecture Utilities: uses utilities
basicsr/archs/rrdbnet_arch.py - Face Restoration → Component Registry: looks up network
inference_codeformer.py - Face Colorization → Component Registry: looks up network
inference_colorization.py - Face Inpainting → Component Registry: looks up network
inference_inpainting.py - Storage Access → Image or Video: reads stored data