neural-cd-preserve / README.md
Quazim0t0's picture
Import from Quazim0t0/neural-cd-preserve; repoint refs to NeuralVerified
de15a9f verified
|
Raw
History Blame Contribute Delete
2.55 kB
metadata
license: mit
library_name: pytorch
tags:
  - verified-units
  - reed-solomon
  - archival
  - preservation
  - self-healing

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.traincommon.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/NeuralVerified/neural-cd-preserve}}
}

Dean Byrne (Quazim0t0) · 2026


Now hosted by NeuralVerified.

This repo was moved into the NeuralVerified organization to help organize my profile. Originally published at Quazim0t0/neural-cd-preserve.