Phips commited on
Commit
55e8d2e
·
verified ·
1 Parent(s): 50bf54c

add 'Why NERVE?' as the second section

Browse files
Files changed (1) hide show
  1. README.md +31 -0
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)