Real-ESRGAN은 저해상도 사진과 일러스트의 픽셀 수를 늘리면서 윤곽과 질감을 복원하는 무료 오픈소스 AI 이미지 확대 도구입니다.
Windows에서는 CUDA나 Python 설치 없이 ncnn Vulkan 포터블 ZIP을 풀어 명령 프롬프트에서 실행할 수 있습니다. 일반 사진은 realesrgan-x4plus 모델로 4배 확대하고 출력 파일의 실제 크기와 화질을 확인합니다.
Real-ESRGAN은 어떤 프로그램인가요?
Real-ESRGAN은 실제 사진과 압축 이미지에서 생기는 복합 열화를 복원하도록 학습된 초해상도 프로젝트입니다. 공식 프로젝트 최신 태그는 v0.3.0이며, 즉시 실행 가능한 ncnn Vulkan 패키지는 v0.2.5.0 릴리스의 2022-04-24 빌드입니다.
포터블 패키지에는 Windows·Linux·macOS 실행 파일과 필요한 모델이 포함됩니다. 그래픽 창은 없고 -i 입력, -o 출력, -n 모델, -s 배율을 명령줄에서 지정하며 Intel·AMD·NVIDIA의 Vulkan 지원 GPU를 사용합니다.
Real-ESRGAN 실제 명령줄 실행과 공식 복원 비교
첫 화면은 Windows 포터블에서 realesrgan-x4plus 모델로 공식 179×179 샘플을 716×716 PNG로 처리한 실제 명령 프롬프트입니다. 두 번째는 같은 실행 결과이며, 마지막은 공식 저장소가 제공하는 입력과 Real-ESRGAN 출력 비교입니다.
| Windows ZIP | 45,474,481바이트 |
|---|---|
| Linux ZIP | 46,931,474바이트 |
| macOS ZIP | 51,817,124바이트 |
| 입력 | JPG·PNG·WebP |
| 출력 | JPG·PNG·WebP |
| 기본 배율 | 4배 |
Windows에서 Real-ESRGAN으로 사진 4배 확대
Windows용 ZIP을 새 폴더에 모두 풀고, 입력 사진을 같은 폴더나 경로가 단순한 작업 폴더에 둡니다. 탐색기 주소 표시줄에 cmd를 입력해 그 폴더에서 명령 프롬프트를 엽니다.
일반 사진은 realesrgan-ncnn-vulkan.exe -i input.jpg -o output.png -n realesrgan-x4plus -s 4 -f png를 실행합니다. 완료 뒤 output.png의 가로·세로가 입력의 4배인지 확인하고 100% 확대에서 윤곽과 인공 무늬를 살핍니다.
- Windows 포터블 ZIP을 받습니다.
- ZIP 안의 파일과 models 폴더를 한 폴더에 모두 풉니다.
- 입력 JPG·PNG·WebP를 작업 폴더에 둡니다.
- 그 폴더에서 명령 프롬프트를 엽니다.
- -i 입력, -o 출력, -n 모델, -s 배율을 넣어 실행합니다.
- 진행률이 끝나면 출력 파일을 엽니다.
- 픽셀 크기와 얼굴·글자·경계의 복원 결과를 확인합니다.
최신 프로젝트와 포터블 파일 버전 구분
GitHub의 최신 프로젝트 릴리스는 v0.3.0이지만 해당 릴리스에는 실행 파일 자산이 없습니다. Windows·Linux·macOS 포터블 실행 파일은 v0.2.5.0 릴리스에 공개된 2022-04-24 ncnn Vulkan 패키지를 사용합니다.
Python 소스와 학습 모델을 직접 구성하려는 사용자는 v0.3.0 코드와 PyTorch 환경을 선택할 수 있습니다. 설치 없이 이미지 한 장을 확대하려면 모델과 DLL이 포함된 v0.2.5.0 포터블 ZIP이 간단합니다.
Windows·Linux·macOS ZIP 선택
Windows는 realesrgan-ncnn-vulkan-20220424-windows.zip, Ubuntu 계열 Linux는 ubuntu.zip, macOS는 macos.zip을 받습니다. 세 패키지는 운영체제별 실행 파일이므로 서로 바꿔 실행하지 않습니다.
Windows ZIP은 45,474,481바이트이며 이번 확인 파일의 SHA-256은 ABC02804E17982A3BE33675E4D471E91EA374E65B70167ABC09E31ACB412802D입니다. Linux와 macOS는 파일 이름과 릴리스 자산 크기를 확인한 뒤 압축을 풉니다.
압축 해제와 models 폴더 유지
ZIP 안에는 realesrgan-ncnn-vulkan.exe, models 폴더, Visual C++ DLL과 예제 파일이 들어 있습니다. 실행 파일만 따로 옮기면 모델 param·bin 파일을 찾지 못하므로 폴더 구조를 그대로 유지합니다.
Windows 탐색기에서 ZIP을 연 채 실행하지 말고 모두 압축 풀기를 사용합니다. 경로에 공백이 있으면 입력과 출력 경로를 큰따옴표로 감싸며, 처음에는 C:\RealESRGAN처럼 짧은 작업 경로가 편합니다.
실제 명령과 결과 파일 확인
명령 형식은 realesrgan-ncnn-vulkan.exe -i 입력파일 -o 출력파일 [옵션]입니다. 실제 확인에서는 공식 0014.jpg를 realesrgan-x4plus, 4배, PNG 출력으로 처리해 179×179 입력에서 716×716 결과를 만들었습니다.
실행 직후 GPU 이름과 Vulkan 기능 정보가 표시되고 진행률이 출력됩니다. 명령 프롬프트가 다시 나타나면 -o에 적은 파일을 열어 크기와 화질을 확인합니다. 성공 메시지가 길지 않으므로 출력 파일 존재가 최종 확인 기준입니다.
일반 사진 모델 선택
자연 사진과 실사 이미지에는 -n realesrgan-x4plus를 사용합니다. 이 모델은 4배 복원을 기준으로 하며 -s 4와 함께 쓰면 입력 가로·세로가 각각 4배인 결과를 만듭니다.
결과가 지나치게 매끈하거나 존재하지 않던 질감이 생기면 원본과 나란히 비교합니다. AI 확대는 실제 디테일을 되찾는 보장이 아니라 학습된 패턴으로 그럴듯한 정보를 보완하므로 증거 사진이나 문서 판독에는 원본을 함께 보관합니다.
애니메이션과 일러스트 모델 선택
선화와 애니메이션 정지 이미지는 -n realesrgan-x4plus-anime을 선택합니다. 패키지의 기본 모델 realesr-animevideov3는 애니메이션 영상 프레임 처리용으로 x2·x3·x4 모델 파일을 포함합니다.
사진에 애니 모델을 쓰면 경계가 과장되거나 질감이 단순해질 수 있습니다. 같은 입력을 일반 모델과 애니 모델로 각각 저장해 선, 눈동자, 배경 질감을 비교하고 목적에 맞는 결과를 고릅니다.
입력 폴더를 한 번에 처리
-i에 파일 대신 폴더를 넣고 -o에 미리 만든 출력 폴더를 지정하면 폴더 안 이미지를 차례로 처리합니다. 예를 들어 -i input_folder -o output_folder -n realesrgan-x4plus -s 4 -f png처럼 실행합니다.
입력과 출력 폴더를 같은 위치로 지정하지 말고 별도 폴더를 만듭니다. 처리 전 파일 수를 기록하고 완료 뒤 출력 수와 이름을 비교해 누락된 파일이 없는지 확인합니다.
출력 형식과 배율 설정
-f는 jpg, png, webp 중 하나를 선택합니다. 투명 배경을 유지하거나 중간 결과를 보관할 때는 PNG, 용량을 줄일 때는 JPG 또는 WebP를 비교합니다.
-s는 2·3·4를 사용할 수 있고 기본값은 4입니다. 배율이 커질수록 결과 픽셀 수와 메모리 사용량이 빠르게 늘어납니다. 목적 화면 크기가 작다면 2배부터 확인해 불필요한 처리 시간과 용량을 줄입니다.
큰 이미지에서 tile 크기 조정
-t 0은 타일 크기를 자동으로 고릅니다. GPU 메모리 부족이나 처리 중 종료가 발생하면 -t 256 또는 -t 128처럼 32 이상의 작은 타일을 지정해 한 번에 처리하는 영역을 줄입니다.
타일을 너무 작게 하면 처리 시간이 늘고 경계가 일관되지 않을 수 있습니다. 공식 안내도 포터블 실행 파일이 이미지를 타일로 나눠 처리하므로 PyTorch 구현과 결과가 조금 다르거나 블록 불일치가 생길 수 있다고 설명합니다.
GPU와 작업 스레드 옵션
-g는 사용할 GPU 번호를 고르며 기본값은 자동입니다. 여러 GPU가 표시될 때 -g 0 또는 -g 1로 지정할 수 있습니다. 실행 초기에 출력되는 장치 이름으로 선택한 GPU를 확인합니다.
-j load:proc:save는 불러오기·처리·저장 스레드 수를 정하고 기본값은 1:2:2입니다. 저장 장치가 느리거나 메모리가 부족하면 기본값을 유지하고, 먼저 tile 옵션으로 안정성을 확인합니다.
Vulkan 장치를 찾지 못할 때
실행 즉시 vkCreateInstance 또는 GPU 장치 관련 오류가 나오면 그래픽 드라이버가 오래됐거나 Vulkan을 지원하지 않는 장치일 수 있습니다. Intel·AMD·NVIDIA의 현재 드라이버를 설치하고 다시 시작한 뒤 실행합니다.
원격 데스크톱이나 가상 머신에서는 물리 GPU의 Vulkan 기능이 전달되지 않을 수 있습니다. 로컬 세션에서 확인하고, 지원 GPU가 없으면 Python/PyTorch의 CPU 또는 다른 지원 장치 구성은 별도 환경으로 설치해야 합니다.
모델 파일을 찾지 못할 때
failed to load model 같은 오류가 나오면 exe 옆 models 폴더에 선택한 모델의 .param과 .bin이 모두 있는지 확인합니다. realesrgan-x4plus는 realesrgan-x4plus.param과 realesrgan-x4plus.bin이 필요합니다.
명령을 다른 폴더에서 실행했다면 현재 작업 폴더가 패키지 폴더인지 확인하거나 -m으로 models 폴더 경로를 지정합니다. 파일 이름의 하이픈과 철자를 공식 목록과 똑같이 입력합니다.
입력 또는 출력 경로 오류
입력 파일을 읽지 못하면 JPG·PNG·WebP 형식인지, 확장자와 실제 파일 형식이 같은지 확인합니다. 경로에 공백이나 괄호가 있으면 전체 경로를 큰따옴표로 묶습니다.
폴더 일괄 처리에서는 출력 폴더를 먼저 만듭니다. 쓰기 권한이 없는 Program Files나 시스템 폴더 대신 문서나 별도 작업 폴더를 사용하고, 같은 파일 이름이 이미 있다면 새 출력 폴더를 정합니다.
얼굴 보정과 Python 버전 구분
공식 Python 스크립트는 –face_enhance로 GFPGAN 얼굴 보정을 연결할 수 있지만 ncnn Vulkan 포터블 실행 파일의 옵션에는 face_enhance가 없습니다. 두 실행 방식을 섞어 명령을 입력하지 않습니다.
얼굴 보정, 임의 outscale, 학습 모델 변경이 필요하면 Python 3.7 이상, PyTorch와 BasicSR·facexlib·gfpgan 의존성을 설치하는 소스 방식이 필요합니다. 단순 2·3·4배 확대는 포터블 방식으로 충분합니다.
출력 화질 검토
결과를 입력과 같은 화면 배율로만 보면 선명해 보일 수 있으므로 100% 확대와 최종 사용 크기에서 둘 다 확인합니다. 얼굴 눈·치아, 간판 글자, 나뭇가지와 반복 무늬에 없는 디테일이 생겼는지 봅니다.
원본 파일, 사용한 모델과 명령, 출력 파일을 한 폴더에 기록하면 재현하기 쉽습니다. 가장 큰 배율보다 필요한 크기에 맞는 최소 배율을 선택하고, 중요한 문서는 AI 결과만 남기지 않습니다.
완료 확인: 픽셀 크기와 결과 비교
-s 4로 처리했다면 입력 179×179가 716×716처럼 가로와 세로가 각각 4배가 됐는지 속성에서 확인합니다. 파일이 열리고 색상과 투명도가 유지되는지도 확인합니다.
선명도가 개선됐더라도 왜곡이나 가짜 질감이 보이면 모델이나 배율을 바꿔 다시 실행합니다. 출력 경로와 파일 수, 픽셀 크기와 육안 품질을 모두 확인하면 한 번의 확대 작업이 끝납니다.
자주 묻는 질문
Real-ESRGAN은 무료인가요?
네. 공식 저장소가 BSD-3-Clause 라이선스로 공개돼 있고 포터블 실행 파일도 무료로 받을 수 있습니다.
최신 v0.3.0에 Windows 실행 파일이 있나요?
v0.3.0 릴리스에는 실행 파일 자산이 없습니다. 공식 포터블 Windows ZIP은 v0.2.5.0 릴리스의 2022-04-24 빌드입니다.
Python과 CUDA를 설치해야 하나요?
ncnn Vulkan 포터블은 Python이나 CUDA 없이 실행되지만 Vulkan을 지원하는 그래픽 장치와 드라이버가 필요합니다.
일반 사진에는 어떤 모델을 쓰나요?
-n realesrgan-x4plus를 사용합니다. 애니메이션 정지 이미지는 realesrgan-x4plus-anime을 비교해 보세요.
메모리 부족 오류는 어떻게 줄이나요?
-t 256 또는 -t 128처럼 타일 크기를 줄이고, 필요하면 -s 2로 먼저 결과를 확인합니다.
포터블 ZIP을 풀고 일반 사진 모델로 첫 결과를 확인하세요
Windows 포터블의 폴더 구조를 유지해 압축을 풀고 realesrgan-x4plus 모델로 입력 사진을 4배 확대해 보세요. 명령이 끝나면 출력 파일의 픽셀 크기와 얼굴·글자·경계를 원본과 비교하고, 메모리가 부족하면 타일 크기와 배율을 낮춰 다시 처리하면 됩니다.
공식 자료와 확인일
Real-ESRGAN 공식 저장소 · Real-ESRGAN v0.3.0 공식 릴리스 · ncnn Vulkan 포터블 v0.2.5.0 릴리스 · Real-ESRGAN ncnn Vulkan 공식 저장소 | 2026-10-01T08:03:09.751648+00:00
