neural-cd-preserve — self-healing optical-disc archives

Repositories: GitHub · 🤗 HuggingFace

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: 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

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

@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/Quazim0t0/neural-cd-preserve}}
}

Dean Byrne (Quazim0t0) · 2026