AIREITER

Real-ESRGAN Rehberi (2026): Weight Dosyaları, İndirme, GUI, ncnn-vulkan

Son Güncelleme: 2026-08-20 01:35:45

Beş yıldır 36.500 yıldızlı bir GitHub deposuna sahip olan Real-ESRGAN, BSD-3-Clause lisansıyla ücretsiz kalmayı sürdürüyor. ncnn-vulkan sürümü sayesinde AMD, Intel ve NVIDIA GPU'larda çalışması da önemli avantajı. Sabit görseller ve anime için hâlâ varsayılan ücretsiz seçenek; uzun, gerçek çekim videolarda ise doğru araç değil.

2026 itibarıyla Real-ESRGAN: Hâlâ güçlü olduğu ve geride kaldığı yerler

Real-ESRGAN'ın en büyük artısı erişilebilirliği: tüm ekosistem ücretsiz, çevrimdışı çalışıyor ve Vulkan üzerinden AMD, Intel ile NVIDIA GPU'lara eşit davranıyor. Video tarafında ise her kareyi bağımsız işlediği için tutarlılığı kaybediyor. Ağır restorasyon işlerinde de sınırlı; çünkü ICCVW 2021 makalesindeki GAN eğitimi tamamen sentetik bozulmalara dayanıyor. Yani yeni ayrıntı üretmekten çok mevcut ayrıntıyı keskinleştiriyor.

Reddit'teki r/upscaling kullanıcılarının özeti tek cümleye sığıyor:

"Yavaşlığın da ötesinde ama görüntüsü fena değil." - u/ChemistryAdorable956, r/upscaling

Hangi weight ne işe yarıyor? x4plus, x2plus, anime_6B ve diğerleri

Kullandığınız yazılımdan önce seçtiğiniz model belirleyici olur. Yayınlanan altı weight dosyasının tamamı projenin resmi Releases sayfasında bulunuyor.

Weight dosyasıYerel ölçekEn uygun kullanımKaynak
RealESRGAN_x4plus.pth4xFotoğraflar, genel görsellerRelease v0.1.0
RealESRGAN_x2plus.pth2xYalnızca iki kat büyütülmesi gereken fotoğraflarReleases sayfası
RealESRGAN_x4plus_anime_6B.pth4xAnime, illüstrasyon, çizgi çalışmalarıRelease v0.2.2.4
RealESRNet_x4plus.pth4xGenel görseller, daha güvenli doku işlemeReleases sayfası
realesr-general-x4v34xSıkıştırılmış veya gürültülü kaynaklarReleases sayfası
realesr-animevideov34xAnime video karelerincnn zip paketiyle birlikte gelir

Format tarafında sık yapılan hata şu: taşınabilir ncnn sürümü kesinlikle .pth dosyalarını kullanmaz. Paketin models klasöründe önceden dönüştürülmüş .param/.bin modelleri bulunur; dolayısıyla .pth indirmek yalnızca Python yönteminde anlamlıdır. README'deki bir başka ayrıntı da önemli: resmi çevrimiçi demo yalnızca anime 6B modelini sunuyor. Fotoğraf kalitesini bu demoya bakarak değerlendirmeyin.

1. yöntem: ncnn-vulkan taşınabilir sürümü — CUDA ve Python gerekmez

En hızlı başlangıç için Real-ESRGAN-ncnn-vulkan releases sayfasındaki taşınabilir çalıştırılabilir dosyayı indirin. En güncel sürüm olan v0.2.0, 24 Nisan 2022 tarihinde yayımlandı ve üç zip paketi içeriyor: Windows 2,2 MB, Ubuntu 3,7 MB, macOS ise 8,5 MB. Arşivi açın, klasörde bir terminal başlatın ve şunu çalıştırın:

./realesrgan-ncnn-vulkan -i input.png -o output.png -n realesrgan-x4plus -s 4

CUDA, PyTorch veya Python gerekmez. Resmi README'ye göre Vulkan aracılığıyla Intel, AMD ve NVIDIA GPU'larda çalışır. -i parametresine dosya yerine bir klasör verirseniz, içindeki tüm JPG, PNG ve WebP dosyalarını toplu olarak işler.

Parametreİşlevi
-i / -oGirdi ve çıktı dosyası ya da klasörü
-nModel adı: realesrgan-x4plus, realesrnet-x4plus, realesrgan-x4plus-anime, realesr-animevideov3
-sÖlçek: 2, 3 veya 4; varsayılan 4
-tTile boyutu; ≥32 ya da otomatik için 0. VRAM yetersiz kalırsa düşürün
-g / -jÇoklu GPU sistemlerinde GPU kimliği; yükleme:işleme:kaydetme iş parçacığı sayıları
-xHızdan feragat ederek kalite için TTA modu
-fÇıktı formatı: png varsayılan, jpg, webp
Windows, macOS ve Ubuntu için indirilebilir v0.2.0 dosyalarını gösteren Real-ESRGAN ncnn-vulkan GitHub releases sayfası

README'de belgelenen iki bilinen sınırlama var: ncnn sürümünde outscale karşılığı bulunmuyor ve tile'lara bölüp yeniden birleştirme işlemi, PyTorch yolundan hafifçe farklı sonuçlar doğuran blok tutarsızlıklarına neden olabiliyor. Ayrıca 4x yerel ölçekli x4plus weight'lerinde -s 2 kullanmak bir tuzak. Parametre bunu kabul ediyor, ancak kullanıcılar çıktının bozulduğunu bildiriyor.

"realesrgan-ncnn-vulkan'da ölçeği 4 dışında bir şeye ayarlayınca çıktı bozuluyor; bu nedir?" - @hogehoge61, X

Hedefiniz 2x çıktıysa parametreyle uğraşmak yerine x2plus weight'lerini bir GUI üzerinden veya Python yoluyla kullanın.

2. yöntem: Tüm özellikler için Python ve PyTorch

Projenin tam özellik seti Python tarafında yer alıyor. inference_realesrgan.py betiği doğrudan depoyla geliyor; bu nedenle resmi README'deki kurulum akışı, Python 3.7+ ve PyTorch 1.7+ ile şöyle:

git clone https://github.com/xinntao/Real-ESRGAN.git
cd Real-ESRGAN
pip install -r requirements.txt
python setup.py develop
python inference_realesrgan.py -n RealESRGAN_x4plus -i inputs -o results --face_enhance
python inference_realesrgan.py -n RealESRGAN_x2plus -i inputs -o results

Ek parametrelerin sağladıkları:

  • --face_enhance, algılanan yüzlerde GFPGAN çalıştırır; ikinci komut ise fotoğraflar için yerel 2x tarifidir.
  • --outscale, 3,5x gibi keyfi çıktı ölçekleri belirlemenizi sağlar. Ancak README açıkça söylüyor: Bu, 4x çıktının LANCZOS4 ile yeniden boyutlandırılmasıdır; yerel ölçekleme değildir.
  • README'ye göre alfa kanallı, gri tonlamalı ve 16 bit görsel desteği yalnızca bu Python yolunda vardır.
  • Çıkarım varsayılan olarak fp16 çalışır; tam hassasiyet için --fp32 ekleyin.

3. yöntem: GUI uygulamaları — Upscayl ve Real-ESRGAN GUI

Terminal açmadan klasör sürükleyip bırakmak isteyenler için ana akım tercih Upscayl. Windows, macOS ve Linux için ücretsiz, AGPL lisanslı bir masaüstü uygulaması olan Upscayl; Real-ESRGAN ve Vulkan tabanlı. Klasör bazlı toplu iş kuyrukları, yoğun sıkıştırılmış JPEG'ler için ikinci tur uygulayan "Double Upscayl" seçeneği, kurulum sonrası çevrimdışı çalışma ve PNG/JPG/WebP formatlarında 16x'e kadar çıktı sunuyor. Resmi site Vulkan destekli harici bir GPU öneriyor.

Windows, macOS ve Linux'ta Real-ESRGAN büyütmesi için ücretsiz açık kaynak GUI olan Upscayl

Daha hafif alternatif, Real-CUGAN'ı da çalıştırabilen ve bulduğunda daha yeni upscayl-ncnn ikili dosyasını tercih eden, platformlar arası Tkinter arayüzü TransparentLC'nin realesrgan-gui uygulaması. Cilalı toplu iş deneyimi için Upscayl'ı; betik kullanımı, ffmpeg işlem hatları veya model üzerinde tam kontrol gerektiğinde ise CLI yöntemlerini seçin.

Anime mi fotoğraf mı? Alışkanlığa göre değil, içeriğe göre model seçin

Anime, manga panelleri ve çizgi çalışmalarının yeri anime_6B. Resmi README'ye göre bu, çok daha küçük boyut için optimize edilmiş bir anime görsel modeli ve proje kendi waifu2x karşılaştırmasına da bağlantı veriyor. Fotoğraflarda x4plus; iki kat büyütmenin yeterli olduğu durumlarda ise x2plus kullanılmalı. Eski taramalar, yoğun JPEG sıkıştırması veya ekran görüntüleri gibi gürültülü kaynaklarda realesr-general-x4v3 daha doğru tercih. README'de bu model için belgelenen -dn gürültü azaltma gücü, temizleme ile bu model ailesinin bilinen aşırı yumuşatma eğilimi arasında denge kurmak için var.

r/upscaling kullanıcılarının sık karşılaştığı bir sınır da şu: anime weight'leri gerçek insanlara uygulandığında kararsız, hatalı yüzler üretebiliyor. Bu başlıktaki ilk yanıt, u/Green-Cucumber8507'den gelen "Modelin hangi varyantı?" sorusu. Yüzlerin görünür olduğu portrelerde Python yolunu ve --face_enhance seçeneğini kullanın; GFPGAN, büyütmenin yumuşattığı yüz ayrıntılarını onarır.

Sorun çıkaran noktalar ve çözümleri

"Vulkan device not found" hatası veya anlık çökmeler

Şu sırayla ilerleyin:

  1. Önce GPU sürücüsünü güncelleyin.
  2. Ekran kartının Vulkan desteğini doğrulayın; Upscayl'ın Windows sorun giderme rehberi bu kontrolü anlatıyor.
  3. Çift GPU'lu dizüstü ve masaüstü sistemlerde, sistem grafik ayarlarından uygulamayı harici GPU'ya zorlayın.

Sessiz kapanmalar ve models klasörü

Çalıştırılabilir dosya hata yazdırmadan segfault veriyor veya sessizce kapanıyorsa önce -m parametresini kontrol edin: Dönüştürülmüş model dosyalarını içeren bir klasörü göstermelidir. Çalıştırılabilir dosyayı ve onun models klasörünü, paketten çıktığı biçimde birlikte tutun.

Videoda bellek yetersizliği: 8 GB'lık iş akışı

Uzun videolar VRAM'i hızla tüketir. X'te @bi_9527zx'in 8 GB ekran kartıyla paylaştığı çalışan yöntem şu: diğer tüm modelleri bellekten kaldırın, videoyu ffmpeg ile PNG karelerine ayırın, her kareyi tek tek 4x büyütün, ardından ffmpeg ölçekleme ve padding ile yeniden birleştirin. İşe yarıyor, ancak maliyeti net biçimde ortaya koyuyor:

"Her kare bağımsız işlendiği için biraz titreşim kalabilir." - u/Dagnarus15, r/upscaling

Hız sınırı gerçekten var

Ölçek hissi vermesi için: X'te @zinya2dx, SD kalitesindeki yaklaşık 20 saniyelik videoyu 4K'ya çıkarmanın GPU'yu tam yükte yaklaşık bir saat çalıştırdığını bildiriyor. Sabit görseller çok daha rahat; @Tomoari_hsmt, X'te NPU'lu 860M sınıfı bir GPU'da görsel başına yaklaşık 2 saniye ölçmüş.

2026'da Real-ESRGAN, Topaz ve SeedVR2 karşılaştırması

Real-ESRGAN artık abonelik tabanlı paketlerle ve keskinleştirmek yerine ayrıntıyı yeniden üreten açık diffusion upscaler'larla rekabet ediyor.

Real-ESRGANTopaz GigapixelByteDance SeedVR2
Lisans ve fiyatBSD-3, ücretsizPersonal için $149/yıl, Pro için $499/yıl (resmi fiyatlandırma)Apache-2.0, ücretsiz
Donanımncnn üzerinden herhangi bir Vulkan GPUKendi GPU'nuzda çalışan masaüstü uygulamasıCiddi VRAM'e sahip NVIDIA GPU'lar (3B/7B varyantları)
YaklaşımGAN, mevcut ayrıntıyı keskinleştirirModel başına kontrollere sahip ticari GAN/CNN paketiTek adımlı diffusion, ayrıntıyı yeniden üretir
Bildirilen işlem hızıx4 720p fp16'da 1,7 fps (RTX 5090)Proteus: 1080p'de 15 fps, 4K'da 7,3 fps4K sınıfı diffusion: 0,2–2 fps
Dikkat edilmesi gerekenlerVideoda titreşim, ağır hasarda düz dokularAbonelik fiyatlandırması720p yapay zekâ üretimi videolarda belgelenmiş aşırı keskinleştirme
RTX 5090 üzerinde ölçülen büyütme hızlarını gösteren çubuk grafik: Topaz Proteus 1080p'de 15 fps, 4K'da 7,3 fps; Real-ESRGAN x4 720p fp16'da 1,7 fps

Tüm hız verileri, Haziran 2026'da RTX 5090 üzerinde çalıştırılan ve sürekli güncellenen bir açık benchmark'tan geliyor. İş yükleri farklı: Real-ESRGAN, fp16 modunda 720p girdide x4 olarak; Topaz Proteus ise 1080p ve 4K'da ölçüldü. Bu nedenle değerleri doğrudan kıyas yerine büyüklük sırası olarak okuyun. Hiyerarşi için benchmark'ın kendi önerileri daha anlamlı: ucuz toplu işler ve önizlemeler için Real-ESRGAN, sinema kalitesinde 4K için SeedVR2-7B.

ByteDance'in Apache-2.0 lisansıyla ICLR 2026'da yayımladığı SeedVR2, ayrıntıyı diffusion yaklaşımıyla yeniden üretir. Bunun da ters bir bedeli var: benchmark metodoloji notlarına göre diffusion upscaler'lar sentetik girdilerde daha başarılı, fakat yeni bir yüz icat edebilir ve kareler arasında sapma yaşayabilir. Kenar ayrıntılarında yeni açık araçlar şimdiden öne geçmiş durumda. Real-ESRGAN ile FlashVSR'ı karşılaştıran bir X kullanıcısı bunu kısa ve net ifade ediyor:

"RealESRGAN sonunda daha azını veriyor." - @dawidope, X

Uzun süredir kullanan bazı kişiler de zor kaynaklarda ayrıntıların patlaması nedeniyle araçtan uzaklaşıyor. @realrebelai, X'te Topaz'a geçmeden önce "bazen ayrıntıları patlattığını fark ediyorum" diye yazmıştı.

API yolu, tüm donanım sorularını devre dışı bırakıyor. Replicate'in barındırdığı nightmareai/real-esrgan, 1.000 çıktı görseli için $2, yani görsel başına $0.002 ücret alıyor. GFPGAN yüz seçeneğiyle 10 kata kadar ölçeklemeyi destekliyor, 1440p altı girdiler öneriyor ve sayfadaki çalıştırma sayacına göre yaklaşık 97 milyon kez kullanılmış. Sayfadaki tek örnek tahmin yaklaşık 2,5 saniyede tamamlanmış. Yerelde kurulum yapmak başlı başına engelse, AIReiter'ın barındırılan upscaler'ı aynı işi tarayıcıdan yapmanızı sağlıyor.

Kısa cevaplar: lisans, donanım, video ve .pth dosyaları

Real-ESRGAN ticari kullanım için ücretsiz mi?

Evet. Proje, açık kaynak dünyasının en esnek lisanslarından biri olan BSD 3-Clause ile dağıtılıyor. Dönüştürülmüş ncnn ikili dosyaları ve yayımlanan weight'ler depoyla birlikte geliyor; ticari bir ürün yayımlamadan önce her depodaki LICENSE dosyasını okuyun.

Real-ESRGAN için NVIDIA GPU şart mı?

Hayır. ncnn-vulkan sürümü ve Upscayl, Vulkan aracılığıyla Intel, AMD ve NVIDIA GPU'larda çalışır. CUDA yalnızca NVIDIA kartın en hızlı yol olduğu Python/PyTorch yönteminde önem kazanır.

Real-ESRGAN video büyütebilir mi?

Yalnızca kare kare. realesr-animevideov3 anime kliplerini işler; açık benchmark ise önizlemeler için Real-ESRGAN'ı vs_temporalfix VapourSynth filtresiyle eşleştiriyor. Buna rağmen her kare bağımsız büyütüldüğünden zamansal titreşim tamamen kaybolmaz.

.pth dosyasını ncnn-vulkan içinde yükleyebilir miyim?

Doğrudan yükleyemezsiniz; ncnn, dönüştürülmüş .param/.bin dosyalarına ihtiyaç duyar. Dönüşüm mümkün olsa da ciddi bir sınırı var:

"Yalnızca eski mimarili 4x modellerde çalışıyor." - u/nmkd, r/GameUpscale

En hızlı çalıştırma arka ucu hangisi?

Model sabit olabilir, ancak arka uç değildir. Uzun süredir kullanan bir kullanıcı, aynı işin Vulkan dışındayken çok daha yavaş olduğunu tespit etmiş: u/SouthernVisit3076, r/software'da "Vulkan kullandığımdakine göre benim için çok daha yavaş" diyor. Modeli suçlamadan önce kendi ekran kartınızda benchmark yapın.

Bu gece hangi yolu seçmelisiniz?

Real-ESRGAN elinizdeki pikselleri keskinleştirir; diffusion araçları ise onları değiştirir. Kaynağınızın belge niteliği mi yoksa estetik amaç mı taşıdığına göre seçim yapın:

DurumunuzYapılması gereken
Fotoğraflar, terminal kullanmak istemiyorumReal-ESRGAN modeliyle Upscayl
Anime veya çizgi çalışmasıanime_6B / realesrgan-x4plus-anime ile Upscayl ya da ncnn
2x fotoğraflarRealESRGAN_x2plus ile Python yöntemi
Eski, sıkıştırılmış, gürültülü taramalar-dn değeri ayarlanmış realesr-general-x4v3
Yüzlerin önemli olduğu portreler--face_enhance ile Python
Anime video kliplerirealesr-animevideov3 ile ncnn
Gerçek çekim veya 4K videoReal-ESRGAN değil; SeedVR2 ya da Topaz
Yüzlerce görsel, GPU zamanı yokAPI: Replicate, görsel başına $0.002

İlgili içerikler: ücretsiz AI video upscaler karşılaştırması ve fiyatlar ile alternatifleri içeren Replicate incelemesi.