πΌ DaisyChain-Train β Old Hardware Training Pipeline
Part of DaisyChain on π€ Hugging Face β https://huggingface.co/DaisyChainAI Model page (weights + card): https://huggingface.co/DaisyChainAI/DaisyChain-Train
In plain terms: DaisyChain-Train lets you use old / spare machines to train neural networks. The training runs through emulated GPU logic β verified INT8 units (GUDA-style) that stand in for a GPU's math β so machines without a modern GPU can still do the work. Chain several together and they train one shared model as a cluster. Before you rely on it, see what it can't do β Limitations.
Use the hardware you already have to train. Each machine runs the emulated GPU logic (verified INT8 units β multiply / requantize / ReLU) to compute the model, and DaisyChain pools the machines data-parallel: device selection, capacity-weighted sharding, gradient sync, a P2P setup, and a live dashboard. Two ways to run β Docker or Python.
β οΈ Read this first
DaisyChain-Train is for small models on spare hardware. It pools compute, not memory (the model must fit on one machine), scaling is sublinear, and it is not a substitute for a real GPU on large models. Full envelope in docs/LIMITS.md β please read it before relying on it.
Feature list
Python cluster trainer (daisychain/)
- Data-parallel training across mixed machines β each node trains its own shard; gradients combine into the exact full-batch gradient, replicas stay bit-identical.
- Capacity-weighted sharding β faster machines automatically take a bigger share of the batch.
- Emulated GPU compute (verified INT8 units) β
VerifiedLinearlayers run every forward multiply / requantize / ReLU through the bundled trained units; cluster-wide unit-invocation counts printed by rank 0. - Bring your own model β any
Task(build_model/sample/loss) viaDAISY_TASK; template inexamples/my_task_template.py. - Plain-float alternative task β same cluster and pooling with ordinary float math.
- Live dashboard (
daisychain-dashboard) β readiness banner, P2P connectivity scan, pooled cores/RAM, per-node capacity plan, live loss. - SpikeWhale control panel (
spikewhale_panel,localhost:8899) β sliders for model size / training settings, any HF dataset you can access (default streamed FineWeb-Edu), start/stop/re-adjust, live loss. - Docker demo cluster β 3 nodes + dashboard in one command.
- Windows helper (
scripts\setup.bat) and Tailscale mesh guide.
DaisyChain-Web (web/) β browser P2P training
- Zero-install nodes β opening the page IS joining; devices on one network auto-group (Snapdrop-style, by public IP).
- Private cross-network rooms β
?room=CODEwith host approval for every join. - Full WebRTC mesh β gradients travel peer-to-peer; the server only signals and serves static files, it never sees weights or gradients.
- Leader-follower runs β whoever presses Start sets width / sequence / batch-per-device / steps / learning rate for the whole group; config broadcast on the wire.
- Mid-run join β late devices are synced in (weights + step) and contribute from the next step.
- Bit-identical replicas β same seeded init, strict roster-order gradient averaging, deterministic Adam with identical state on every peer; verified live by per-step weight hashes.
- Sync guard β any weight-hash mismatch stops the run instead of training past a fork; the step roster forbids silent partial averages.
- Gradient repair β a follower missing a roster gradient re-requests it from the leader (8 steps retained), bit-exact, and the run continues.
- Cross-device kernel probe β every step, every device re-hashes a fixed seeded int8 GEMM through its live kernel; catches broken arithmetic that weight hashes cannot see.
- Hardcoded FineWeb-Edu streaming β the server reads random slices of
the 10BT parquet shards straight off the HF CDN via HTTP range requests
(pure-JS
hyparquet); built-in corpus fallback offline. - Checkpoints β download
.pt, upload β broadcast to the whole group; validated (magic, dims, tokenizer vocab) before accepting. - Inference kit β one self-contained HTML file with the trained weights baked in; generations offline, anywhere.
- In-page generation β prompt box on the trained model.
- Old-hardware tier β no WebGPU? The identical units run on CPU (same bits, so CPU and GPU devices co-train in one group). There is no plain-float path.
- Large-message fragmentation β multi-MB gradients/checkpoints chunked at 48 KB over the data channels.
Verified compute & kernels (web)
- Verified INT8 units everywhere β block-scaled int8 GEMM: exact LUT products, exact int32 accumulation, bit-exact f32 epilogue with a pinned rounding schedule; scales derived in JS f64 (division never runs on GPU).
- Backends, best-first β DP4A hardware int8 dot β LUT compute shader β CPU mirror; every kernel exact-gated at init (bit-level compares) and demoted to the mirror on any mismatch.
- Continuous random-cell audit at live training shapes.
- Fused attention kernels β gather/scatter head-strided qΒ·kα΅ and aΒ·v straight from BTΓC layout (CUTLASS ex. 36/52 style).
- QKV dual-GEMM fusion β shared left operand quantized once, one batch-3 dispatch (ex. 45); bit-identical.
- B2B MLP chain β both MLP GEMMs back-to-back on GPU with fused per-row absmax reduction and on-device quantize (ex. 13 + 23); WGSL-exact respec with a fround-stepped JS mirror; fma-contraction-immune by construction.
- Dispatch-optimized backward β overlapped independent GEMMs, batch-3 sibling fusions (ex. 05/24); bit-identical gradients; optional int8 STE backward path (dormant, 1.21Γ vs float).
Verification stack (web)
- Exact init gates on every kernel, every device, every boot β including gates that "gate the gate" with discriminating boundary inputs.
- IEEE-754 binary32 oracle in exact BigInt arithmetic β proves the JS epilogue mirror is spec-correct (rejects the old mirror on 34% of inputs).
- Metamorphic property suite β reference-free relations + definitional absolutes; 4/4 on an externally-authored bug corpus, matching the differential gate.
- RDNA2 ISA audit hardenings β bit-level (β0-aware) gate comparisons; proof that FMA contraction cannot change the quantize.
- Eleven-suite test chain (
cd web && npm test) β convergence, replicas, oracle, gates, properties, external corpus, self-corpus (the instruments scored against my own bugs), B2B, optimizer, transformer LM, int8 backward; results in web/TEST_RESULTS.md. - Dirty-buffer gate β the pool is poisoned before a re-sweep so state bugs (a kernel assuming zeroed memory) are caught deterministically rather than by ordering luck.
Documentation
- Python: QUICKSTART, LIMITS, CUSTOM_TASK, TAILSCALE.
- Web: Getting started, Architecture, Verification, Troubleshooting.
Quick start
Docker (most reliable β one command)
docker compose -f docker/docker-compose.yml up --build
# open http://localhost:8080
Brings up a 3-node demo cluster + dashboard on one machine.
Python (real machines)
On every machine (pip install -e .):
export MASTER_ADDR=100.101.102.10 # coordinator IP (Tailscale 100.x recommended)
export MASTER_PORT=29560
export WORLD_SIZE=3
export RANK=0 # 1, 2, ... on the others
export GLOO_SOCKET_IFNAME=tailscale0 # your mesh / LAN NIC
daisychain-train
Windows helper
scripts\setup.bat
An interactive menu: Docker, Python node, or just install deps.
Full walkthrough: docs/QUICKSTART.md.
π SpikeWhale control panel (sliders β real training)
python -m daisychain.spikewhale_panel
# open http://localhost:8899
A web control panel: pick model size / training settings with sliders, choose any HuggingFace dataset you have access to (default: streamed FineWeb-Edu), hit Start, and watch the live loss. Stop and re-adjust any time with β Back to settings. Launches the real DaisyChain training underneath.
π DaisyChain-Web (train by opening a browser tab)
cd web && npm install && node server.js
# open http://localhost:8787 on every device
Zero-install browser training: devices on the same network auto-group
(Snapdrop-style) and train a shared model peer-to-peer over WebRTC, computing
through the same verified INT8 units (WebGPU, with the identical units on CPU
for machines without it β there is no plain-float path). Private cross-network
rooms via ?room=CODE with host approval β the room creator accepts each
device before it can join. Includes gradient averaging with a deterministic
Adam optimizer (identical state on every peer, nothing extra over the wire),
checkpoint download (.pt) and upload β broadcast so one device can
restore the whole group after a failure.
Live demo: https://huggingface.co/spaces/Quazim0t0/DaisyChain-Web
Recent updates (July 2026) β DaisyChain-Web
Verification stack β the browser trainer's correctness is now checked by things that run, not argued (full results):
- IEEE-754 oracle (
web/test_ieee.js): a binary32 oracle built from the standard in exact BigInt arithmetic proves the JS epilogue mirror is spec-correct β and rejects the old round-once mirror on 34% of inputs. - Metamorphic properties + oracle mutation scoring (
test_metamorphic.js,test_corpus.js): properties needing no reference implementation, scored against an externally-authored bug taxonomy β 4/4, matching the exact differential gate's 4/4. Relations own the loop bugs; two definitional absolutes (ReLU output range, a unit-scale integer anchor) own the value bugs no relation can see. - Exact kernel gates on every live kernel, a continuous audit at live shapes, and a cross-device kernel probe (same seeded int8 GEMM, same hash on every honest device, any backend). The audit's sampling was rebuilt against a named bug class: its old constants (6 cells, 2% of GEMMs) bounded an overhead that had never been measured (auditing every GEMM costs <0.01% of a step), and uniform random cells cannot see a last-row/column bug at a 16512-wide output. Sampling is now stratified β the first cells are the structural danger points, chosen deliberately. On a last-column bug, same cell budget: uniform caught 5/300 audits, stratified 300/300, with zero false positives.
- RDNA2 ISA audit: reading a real GPU's shader ISA against our
determinism assumptions confirmed three of them on silicon (exact packed
int8 dot; correctly-rounded f32 add/mul; 1-ULP reciprocal β division stays
off the GPU) and produced two hardenings. (1) Real ISAs have non-IEEE
variants that flush β0 to +0; JS
!==can't see that (-0 !== 0is false), so all gates and audits now compare bit patterns β exactly what the replica hash sees. (2) FMA contraction of the quantize'sxΒ·inv + 0.5(one rounding instead of two) turned out to be floor-invisible by construction β proven intest_b2b.jswith 175k+ last-ulp anomalies at binade edges, zero survivingfloor(). Rounding mode and denorm flushing are runtime driver state on real hardware, which is why every device re-runs the exact gates at every init.
Training data β FineWeb-Edu (10BT sample) is the hardcoded dataset. The
Space reads random slices of the parquet shards straight off the HF CDN with
range requests (pure-JS hyparquet, SNAPPY) and serves plain text at /data
β no dependency on the datasets-server rows API and its 503s.
Resilience β the sync guard now repairs instead of halting: a roster gradient that reached the leader but not some follower (asymmetric WebRTC mesh) is re-requested from the leader, bit-exact, and the run continues. The guard still stops anything that would fork the weights.
CUTLASS-style kernel work, each step proven bit-identical or exact-gated:
- Dispatch-optimized backward (ex. 05/24): independent GEMMs overlapped, sibling trios fused into batch-3 dispatches β bit-identical gradients, dormant int8-backward path down from 1.63Γ to 1.21Γ vs float.
- QKV dual-GEMM fusion (ex. 45): q/k/v share one left operand β quantized once, one batched dispatch, zero changed bits.
- B2B MLP chain (ex. 13 + 23): both MLP GEMMs back-to-back on the GPU with
a fused per-row absmax reduction; the intermediate is quantized on-device
via a WGSL-exact respec (
floor(f32(xΒ·invScale)+0.5)β no GPU division) whose fround-stepped JS mirror keeps mixed GPU/CPU fleets bit-identical.
Profile-driven speed work β every change below is bit-identical (gradient and loss hashes unchanged), so none of it trades correctness for wall clock:
- Buffer pooling: GPU buffers are recycled by size bucket instead of being created and destroyed per dispatch (~19 per MLP call, per layer, per step). 6β10% faster, every hash unchanged.
- Shared-operand embedding GEMMs: profiling put two f32 backward GEMMs at
55% of the entire step, and both consumed the same
dlogitsoperand β ~17 MB at the 16512-token vocab, uploaded twice. One upload, one encoder, one submit: that pair went 205 β 90 ms and the step 12% faster. The fusion is gated bit-for-bit against the two calls it replaces. - A negative result, kept on purpose: the remaining hot kernel looked
cache-hostile (adjacent lanes wrote 66 KB apart), but making the writes
contiguous changed nothing. Two probes explain why β holding the output at
17 MB while cutting compute 32Γ barely moved the time. The logits GEMM is
transfer-bound, not compute-bound, and the readback cannot be removed
because softmax must stay in JS (WGSL's
expis not correctly rounded, and a per-vendorexpwould fork replicas). The real lever there is the vocabulary, not the kernel. - An init backend race was tried and removed: it tied on the shipped path, cost ~430 ms of init, and made the backend vary between page loads, which silently invalidated three A/B comparisons before it was caught. A knob that changes what you are measuring is worse than a fixed choice.
Dirty-buffer gate β and the assumption it falsified. Pooling introduced a bug class the gates predate: a pooled buffer is not zero-initialized, so a kernel that assumes zeros is right on step one and wrong on step two. That is a state bug, where no single call is wrong and the sequence is, which is the family no oracle can reach. The assumption was that the gates were blind to it. Mutation-testing the gate proved otherwise: deleting the zeroing made the plain gate fail at its second shape, because the sweep's own shapes recycle each other's buffers. The suite had incidental coverage nobody designed, which is coverage nobody can rely on β shorten the shape list and it evaporates with the gate still green. It is now deliberate: the pool is poisoned with 1e4-magnitude residue before a re-sweep, so detection no longer depends on ordering luck. ~90 ms one-time.
Scoring the oracles against my OWN bugs (web/test_selfcorpus.js) β the
external corpus measures kernel bugs someone else wrote down, so this suite
asks the harder question: what do the instruments score against the four real
bugs of the month? Properties 0/2 on the data-plane pair (the cΒ·out
theorem again), differential 2/2 β but half the bugs were not in the
kernels at all. A dead gate is a bug in a checker, caught only by mutating
the gate; a stalled roster gradient is a bug in the protocol, where every
computed value on every peer was correct, so no data oracle could fire. Those
needed different instruments, not better oracles.
All eleven test suites (cd web && npm test) pass; results with methodology in
web/TEST_RESULTS.md.
How it works
Each machine runs the same command; they form a cluster and train one shared model. Two things happen:
- The compute runs through the emulated GPU logic. By default the model is
built from
VerifiedLinearlayers, so every forward multiply / requantize / ReLU is done by the bundled verified INT8 units (daisychain/verified/) β the emulated GPU math. Rank 0 prints cluster-wide unit-invocation counts so you can see the emulated logic doing the work. - The machines are pooled data-parallel. Each node trains on its own shard; gradients are capacity-weighted and combined into the exact full-batch gradient, so replicas stay bit-identical. Faster machines automatically take a bigger share.
old machine A ββ
old machine B ββΌββΊ each runs the emulated GPU logic on its shard ββΊ one model
old machine C ββ (gradients combined across the cluster)
Bring your own model
DaisyChain-Train trains any Task (build_model / sample / loss). Copy
examples/my_task_template.py, set DAISY_TASK=your_module:YourTask. Use
VerifiedLinear (see daisychain/verified_task.py) to run your model's compute
through the emulated units. See docs/CUSTOM_TASK.md.
Plain-float alternative
To skip the emulated units and train with normal float math on each machine, set
DAISY_TASK=daisychain.example_task:ExampleTask. Same cluster, same pooling β
the model math just runs as ordinary float instead of through the verified units.
The dashboard
daisychain-dashboard (or the Docker service) serves a Tailwind page at :8080
β readiness banner, P2P connectivity scan, pooled cores/RAM + capacity plan
(per-node device, weight, batch), and live training loss.
Networking
Use Tailscale for a P2P mesh so machines on different networks get stable IPs on one interface β docs/TAILSCALE.md.
Layout
daisychain/cluster.py capacity-weighted CPU/GPU data-parallel trainer
daisychain/train.py entry point (daisychain-train)
daisychain/verified/ bundled trained N/N units + VerifiedLinear (train through them)
daisychain/verified_task.py default task: forward runs on the verified units
daisychain/example_task.py plain-float alternative task
daisychain/task.py the Task interface + loader
daisychain/dashboard/ agent + P2P scanner + Tailwind server
docker/ Dockerfile, dashboard image, compose (demo cluster)
scripts/setup.bat / setup.sh interactive setup helpers
config/ nodes + cluster env examples
examples/my_task_template.py starting point for your own model
docs/ QUICKSTART, LIMITS, CUSTOM_TASK, TAILSCALE
daisychain/spikewhale_task.py trains the real SpikeWhale on streamed HF datasets
daisychain/spikewhale_panel.py slider control panel (localhost:8899)
web/ DaisyChain-Web: P2P browser training (WebRTC + WebGPU)
export_luts_web.py regenerates web/public LUTs from the trained units
Install
pip install torch numpy psutil
pip install -e . # exposes: daisychain-train, daisychain-agent, daisychain-dashboard
Requires Python β₯ 3.9, PyTorch β₯ 2.0. Multi-node is reliable on Linux/macOS; on Windows use Docker/WSL (see Limitations).
Links
- DaisyChain on Hugging Face: https://huggingface.co/DaisyChainAI
- This model: https://huggingface.co/DaisyChainAI/DaisyChain-Train
License: MIT Β· Author: Dean Byrne (Quazim0t0) Β· Org: DaisyChainAI
Citation
@misc{byrne2026daisychain,
title = {DaisyChain-Train: An Old Hardware Training Pipeline},
author = {Byrne, Dean (Quazim0t0)},
year = {2026},
howpublished = {\url{https://huggingface.co/DaisyChainAI/DaisyChain-Train}},
note = {Chain spare/old machines into a data-parallel training cluster}
}
Dean Byrne (Quazim0t0) Β· 2026