| --- |
| license: bsd-3-clause |
| library_name: coreml |
| tags: |
| - coreml |
| - coremltools |
| - apple-silicon |
| - waifufinder |
| - real-esrgan |
| - image-super-resolution |
| --- |
| |
| Published by WaifuFinder. `manifest.json` pins 3 model files by SHA-256; |
| the app verifies every one of them, plus the licence, attribution and validation files, |
| before installation. |
| # Real-ESRGAN x2plus — optimized Core ML |
|
|
| Self-contained framewise 2× upscaler for |
| [WaifuFinder](https://github.com/alastorid/WaifuFinder). WaifuFinder downloads |
| these files directly: no Python, no source checkpoint, no conversion step. |
|
|
| ## Contents |
|
|
| | Path | What | |
| | --- | --- | |
| | `RealESRGANValidated.mlpackage` | Converted, original-model-validated model | |
| | `manifest.json` | Architecture, original fingerprints, SHA-256 of every file | |
| | `validation.json` | Original-model parity, tile and product checks | |
| | `LICENSE` | Real-ESRGAN weights, BSD 3-Clause | |
| | `BasicSR-LICENSE` | Reference architecture, Apache-2.0 | |
| | `NOTICE` | Attribution and conversion summary | |
|
|
| The app compiles the package once at install time, on the machine that will run |
| it, because compiled Core ML is tied to the local compiler and macOS version. |
|
|
| ## What "optimized" means |
|
|
| The network is the unmodified Real-ESRGAN x2plus. The conversion: |
|
|
| - fuses the first convolution into the following stage; |
| - expresses 256, 384 and 522 pixel inputs as enumerated Core ML shapes, so a |
| small tile is upscaled at its own size instead of being padded to 522; |
| - records the measured parity against the original PyTorch network in the model |
| metadata, and the app refuses to use a package that is not that validated one. |
|
|
| `validation.json` records the measurements: maximum absolute error against the |
| original network stays at or below 0.0069 across every supported input size, |
| against a 0.01 acceptance bound. |
|
|
| ## Provenance |
|
|
| Weights: [xinntao/Real-ESRGAN](https://github.com/xinntao/Real-ESRGAN), |
| `RealESRGAN_x2plus.pth`. Architecture reference: |
| [XPixelGroup/BasicSR](https://github.com/XPixelGroup/BasicSR) revision |
| `8d56e3a`. |
|
|
| ## Licence |
|
|
| BSD 3-Clause (weights). See `LICENSE`, `BasicSR-LICENSE` and `NOTICE`. |
|
|
