| --- |
| license: mit |
| library_name: pytorch |
| tags: |
| - verified-units |
| - reed-solomon |
| - archival |
| - preservation |
| - self-healing |
| --- |
| |
| # neural-cd-preserve — self-healing optical-disc archives |
|
|
| **Repositories:** [GitHub](https://github.com/quzi93/neural-cd-preserve) · [🤗 HuggingFace](https://huggingface.co/NeuralVerified/neural-cd-preserve) |
|
|
| Scan an optical disc into a self-healing `.pt` archive that **detects and repairs |
| bit-rot** and reconstructs the disc even from a damaged copy. Built on the same |
| neural-verified Reed-Solomon core as |
| [neural-storage](https://huggingface.co/NeuralVerified/neural-storage): each unique |
| chunk is RS-split into shards, every shard carries its own SHA-256, so silent |
| corruption is detected, marked as an erasure, and repaired from survivors (as long |
| as ≥ *k* of *n* shards remain). |
|
|
| > **Honest by design:** RS self-healing protects the *archive* against future |
| > bit-rot. It cannot recover disc sectors that were already unreadable at scan |
| > time — those are recorded, and re-reads are merged. No entropy is beaten. |
|
|
| ## Use |
|
|
| ```bash |
| pip install torch |
| python step_cd.py # full self-healing demo |
| |
| python cli.py archive \\.\D: mydisc.pt --label MY_CD # drive or .iso |
| python cli.py verify mydisc.pt |
| python cli.py heal mydisc.pt |
| python cli.py restore mydisc.pt out.iso |
| ``` |
|
|
| The demo injects 149 silent bit-flips; `verify` detects all, `heal` repairs all, |
| `restore` returns bit-exact; corrupting beyond RS capacity is flagged **LOST**, |
| never silently wrong. |
|
|
| Weights: `GF256.pt` (verified GF(256) LOG/EXP). |
|
|
| **Create your own verified unit** (template: `cdpreserve/gf256.py`): write the |
| exact golden finite function → enumerate the domain (decompose big/linear ones |
| into bit/byte slices, see `cdpreserve/rs.py`) → `common.train` → `common.verify` |
| must be bit-exact on 100% of inputs → compose. |
|
|
| ## Citation |
|
|
| ```bibtex |
| @misc{byrne2026neuralcdpreserve, |
| title = {neural-cd-preserve: Self-Healing Optical-Disc Archival with Verified Erasure Coding}, |
| author = {Byrne, Dean (Quazim0t0)}, |
| year = {2026}, |
| howpublished = {\url{https://huggingface.co/NeuralVerified/neural-cd-preserve}} |
| } |
| ``` |
|
|
| **Dean Byrne (Quazim0t0)** · 2026 |
|
|
|
|
| --- |
|
|
| <!-- neuralverified-relocation-note --> |
| > **Now hosted by [NeuralVerified](https://huggingface.co/NeuralVerified).** |
| > |
| > This repo was moved into the NeuralVerified organization to help organize my profile. |
| > Originally published at [`Quazim0t0/neural-cd-preserve`](https://huggingface.co/Quazim0t0/neural-cd-preserve). |
|
|
