メインコンテンツへスキップ
見出し画像

画質向上Python・Python 3.13でReal-ESRGANを動かす。原因と解決策

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

    画像
    元の画像
    画像
    画質をあげると、AIならではのモヤも浮き彫りに

    📌 この記事でわかること

    • 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.git
    File "<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

    修正方法

    1. GitHub から BasicSR と Real-ESRGAN をそれぞれ git clone

    2. 両方の setup.py を以下のように書き換える

    3. 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自動判定・タイル分割処理・エラーハンドリングをすべて含む、そのまま動くスクリプトです。

    あなたへのおすすめ