add 'Why NERVE?' as the second section
Browse files
README.md
CHANGED
|
@@ -39,6 +39,37 @@ Part of the **BODY** suite by **Philip Hofmann** — networks built to be
|
|
| 39 |
|
| 40 |
---
|
| 41 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 42 |
## Quickstart
|
| 43 |
|
| 44 |
### As a user (just want to upscale / restore images)
|
|
|
|
| 39 |
|
| 40 |
---
|
| 41 |
|
| 42 |
+
## Why NERVE?
|
| 43 |
+
|
| 44 |
+
There are many SR networks already. Here's the honest case for NERVE — and when
|
| 45 |
+
to pick something else.
|
| 46 |
+
|
| 47 |
+
**One-line pitch:** a ~1.8M-param, pure-conv SR net that trains with plain
|
| 48 |
+
`train.py`, exports to dynamic ONNX on the first try, and converts to ncnn —
|
| 49 |
+
with no fusion step, no variants, no custom ops.
|
| 50 |
+
|
| 51 |
+
**Why it's worth your time:**
|
| 52 |
+
- **One file, one variant.** The architecture is a single readable file and the
|
| 53 |
+
model is one size. No S/M/L matrix, no fused-vs-unfused checkpoints, nothing
|
| 54 |
+
to fuse before deploy — **what you train is what you ship.**
|
| 55 |
+
- **Export just works.** Dynamic-shape ONNX (verified, ORT parity ~1e-5) and a
|
| 56 |
+
clean ncnn conversion. Standard ops only (`Conv / Add / ReLU / DepthToSpace /
|
| 57 |
+
Resize`).
|
| 58 |
+
- **Boring, stable training.** Norm-free, bf16 AMP, no gradient clipping, a
|
| 59 |
+
single Charbonnier loss for the base stage.
|
| 60 |
+
- **Small and fast.** ~1.8M params — SPAN-class size but conv-only, so it fits
|
| 61 |
+
mobile, edge, web and game engines.
|
| 62 |
+
- **Real-world first.** Trained on a CC0 dataset with the full Real-ESRGAN OTF
|
| 63 |
+
degradation pipeline; the OTF GAN model restores degraded images, not just
|
| 64 |
+
clean bicubic downsamples.
|
| 65 |
+
- **Maintainable for years.** One op set, no exotic dependencies, ~90-line arch.
|
| 66 |
+
|
| 67 |
+
**When to pick something else:** if you want maximum PSNR/LPIPS on academic
|
| 68 |
+
benchmarks, or a big transformer, NERVE isn't trying to win that — use HEART.
|
| 69 |
+
NERVE wins on *simplicity, deployability and hassle-free training*.
|
| 70 |
+
|
| 71 |
+
---
|
| 72 |
+
|
| 73 |
## Quickstart
|
| 74 |
|
| 75 |
### As a user (just want to upscale / restore images)
|