
画質向上Python・Python 3.13でReal-ESRGANを動かす。原因と解決策
作成したイラストを高画質にしたい。納品のために高画質にしたい。
Real-ESRGANを利用したいと思っても、Google Colab環境でしか記事がヒットしない……
Google Colabは簡単に利用出来るのですが、画質をかなりあげる場合、「セッションエラー」が起きてしまいます。
そのため、今回はvscodeなどで利用できるPythonコードに成型し、GPTimage2で作成した画像を4倍(A2相当)にするためのPython式を書くことにしました。


📌 この記事でわかること
Real-ESRGANをPython 3.13のローカル環境で動かす手順
KeyError: '__version__' が出る根本原因
エラーを修正するコードの書き換え方(2箇所)
高画質化スクリプト jiko.py の全コード(有料)
🗂 フォルダ構成
d:\画質UpPython\
├── input.png # 元画像
├── output.png # 出力画像(処理後に生成)
├── izon.py # 依存ライブラリ・モデルのセットアップ
├── jiko.py # 高画質化の実行スクリプト ← 有料部分
├── weights/
│ └── RealESRGAN_x4plus.pth
├── BasicSR/ # GitHubからクローン・手動修正済み
└── Real-ESRGAN/ # 同上
🔧 STEP 1:環境構築(izon.py)
ColabのノートブックをそのままローカルのPythonで動かそうとすると、!pip install が使えません。標準ライブラリの subprocess に書き換えます。
import os, sys, subprocess, wget
subprocess.check_call([sys.executable, "-m", "pip", "install",
"facexlib", "gfpgan", "resampy", "wget"])
model_dir = 'weights'
os.makedirs(model_dir, exist_ok=True)
model_url = ('https://github.com/xinntao/Real-ESRGAN/releases/'
'download/v0.1.0/RealESRGAN_x4plus.pth')
model_path = os.path.join(model_dir, 'RealESRGAN_x4plus.pth')
if not os.path.exists(model_path):
wget.download(model_url, model_path)⚠️ STEP 2:Python 3.13特有のインストールエラーを直す
次のコマンドを実行すると、Python 3.13環境では必ずこのエラーが出ます。
pip install basicsr
pip install git+https://github.com/xinntao/Real-ESRGAN.gitFile "<string>", line 79, in get_version
KeyError: '__version__'原因
Python 3.13 では、関数内で exec() を実行した結果がデフォルトで locals() に入らなくなりました。BasicSR と Real-ESRGAN 両方の setup.py がこのパターンを使っているため、どちらもエラーになります。
# 問題のあるコード(setup.py内)
def get_version():
with open(version_file, 'r') as f:
exec(compile(f.read(), version_file, 'exec'))
return locals()['__version__'] # Python 3.13ではここで KeyError修正方法
GitHub から BasicSR と Real-ESRGAN をそれぞれ git clone
両方の setup.py を以下のように書き換える
pip install -e . でローカルインストール
# 修正後
def get_version():
with open(version_file, 'r') as f:
d = {}
exec(compile(f.read(), version_file, 'exec'), d)
return d['__version__']💡 exec() の第2引数に辞書 d を渡すことで、実行結果を確実に受け取れます。Python 3.12以前でも動作します。
⚠️ BasicSR と Real-ESRGAN、両方の setup.py を修正しないと動きません。片方だけでは解決しないので注意。
📄 ここから有料記事です
高画質化を実行する jiko.py の全コード(コメント付き)を掲載しています。
GPU自動判定・タイル分割処理・エラーハンドリングをすべて含む、そのまま動くスクリプトです。