whatisgithub

What is pgtformer?

nielsrogge/pgtformer — explained in plain English

Analysis updated 2026-07-23 · repo last pushed 2024-09-02

Audience · researcherComplexity · 3/5StaleSetup · moderate

In one sentence

PGTFormer automatically sharpens and restores blurry or damaged faces in videos without needing faces pre-positioned, keeping results smooth across frames.

Mindmap

mindmap
  root((repo))
    What it does
      Fixes blurry faces
      No pre-alignment needed
      Frame-to-frame consistency
    Tech stack
      Python
      BasicSR
      CodeFormer
    Use cases
      Archival footage cleanup
      Old interview remastering
      Face-enhancement research
    Audience
      Filmmakers
      Media companies
      Researchers
    Inputs and Outputs
      Input: low-quality video
      Output: restored faces
      Pre-trained models auto-download

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Clean up blurry or blocky faces in old archival video footage.

USE CASE 2

Remaster low-quality interview clips so faces look sharper and more natural.

USE CASE 3

Benchmark face-enhancement methods against standard video quality metrics.

USE CASE 4

Test face restoration on sample videos using pre-trained models.

What is it built with?

PythonBasicSRCodeFormerVFHQ dataset

How does it compare?

nielsrogge/pgtformer00kaku/gallery-slider-block04amanrajj/netwatch
Stars0
LanguageJavaScriptRust
Last pushed2024-09-022021-05-19
MaintenanceStaleDormant
Setup difficultymoderateeasymoderate
Complexity3/52/53/5
Audienceresearchergeneralops devops

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires comfort running Python commands and installing Python packages, but pre-trained models download automatically on first run.

The license terms are not specified in the repository explanation.

So what is it?

PGTFormer is a tool that fixes blurry, pixelated, or damaged faces in videos. If you have an old or low-quality video clip where someone's face looks blocky or unclear, this project can sharpen and restore that face to look more natural and detailed, all automatically. What makes it stand out is that it doesn't require "pre-alignment," a step where many similar tools need faces to be manually adjusted to a standard position before processing. This tool skips that step entirely and works on faces as they naturally appear in the video. It also focuses on keeping faces consistent from frame to frame, so the restored result looks smooth rather than flickering or shifting as the video plays. The audience for this is anyone working with video restoration, say, a filmmaker cleaning up archival footage, a media company remastering old interviews, or a researcher building better face-enhancement tools. The project includes example videos so you can test it quickly, and the creators provide pre-trained models that download automatically the first time you run it, so you don't need to train anything yourself. Benchmark results in the README show it outperforming several other well-known methods across standard quality metrics, meaning the restored faces score higher in sharpness, structural similarity, and perceptual quality. The project is built on top of existing open-source frameworks (BasicSR and CodeFormer), and it was trained using a large dataset of high-quality face videos called VFHQ. It was published as a research paper at the AI conference IJCAI in 2024. The code and instructions are aimed at someone comfortable running Python commands, but the README keeps the setup fairly straightforward if you have basic familiarity with installing Python packages.

Copy-paste prompts

Prompt 1
Help me clone PGTFormer and set up the Python environment so I can run face restoration on a video file. Walk me through the install steps.
Prompt 2
I have a low-quality video clip with blurry faces. Show me the exact PGTFormer command to restore the faces without pre-aligning them first.
Prompt 3
Walk me through using PGTFormer's pre-trained models on a sample video so I can see how frame-to-frame face consistency works before trying my own footage.
Prompt 4
Help me compare PGTFormer's output quality against CodeFormer on the same blurry video clip using standard sharpness and similarity metrics.

Frequently asked questions

What is pgtformer?

PGTFormer automatically sharpens and restores blurry or damaged faces in videos without needing faces pre-positioned, keeping results smooth across frames.

Is pgtformer actively maintained?

Stale — no commits in 1-2 years (last push 2024-09-02).

What license does pgtformer use?

The license terms are not specified in the repository explanation.

How hard is pgtformer to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is pgtformer for?

Mainly researcher.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.