8

Model Conversion Guide

Aaron Liu edited this page 2024-11-02 17:07:13 -04:00

Table of Contents

• Prerequisites
• Steps

This guide explains how you can convert PyTorch models to NCNN models for Upscayl.

Important

Only PyTorch models for ESRGAN are guaranteed to work. You can use a similar process for ONNX models (use onnxsim to simplify the model, install ONNX in dependencies and replace the orange blocks with their cyan equivalents), but it can often fail.

Prerequisites

• chaiNNer (Versions after v0.21.0 currently don't work due to an outdated library used by our CLI)
  • This .chn file. Right click the link, click "Save link as" and save it wherever you want.
• A model in PyTorch (.pth) format. This guide is for converting PyTorch to NCNN (Upscayl's format) only.
  • You can get models from https://openmodeldb.info/?t=arch%3Aesrgan.
  • Make sure the model is made for the ESRGAN architecture.
• A Text Editor

Steps

1. Open chaiNNer and inside its dependency manager (the download button in the top right corner) install PyTorch and NCNN. ONNX is optional.
2. Set the correct GPU under the ONNX tab of the settings if you can.
3. Load the .chn file you downloaded in the Prerequisites section by clicking File → Open in chaiNNer.
4. Select the .pth model you want to convert by clicking the button that says "Click to select a file...".
5. Select an output folder under "Base Directory".
6. Name that model by typing under "Param/Bin Name".
7. Press the Run button (▶️) on top of the window or press F5 on your keyboard.
8. Wait for chaiNNer to finish converting. You'll get 2 files: a .bin and a .param
9. Open the .param file and change the first "input" on the second column and all "input"s (usually 2) in the third column to "data".
10. Save the .param file and copy the .param and .bin file to your custom models folder named 'models'. If you don't have one, create it.
11. Open Upscayl and go to Settings → Add custom models and select your custom models folder.
12. Your model should now appear at the bottom of your models list.
13. Happy Upscayling 😄

• If the model doesn't work, try reverting your edits in step 9.