Skip to content

Commit f758d4b

Browse files
author
Ronald Tse
committed
release: ara-diac-small-1.0 registration (capacity-limited client rung, +2.34pp disclosed)
1 parent 9e1c395 commit f758d4b

4 files changed

Lines changed: 97 additions & 11 deletions

File tree

‎docs/RESULTS.md‎

Lines changed: 37 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -144,13 +144,40 @@ reproducing its documented tier on this replication.
144144

145145
Gate ≤ teacher + 0.5pp: the student misses by two orders of magnitude.
146146

147-
**RETRACTION (2026-08-24) and RESTORATION (same day):** the original
148-
verdict was retracted when the labels proved mojibake (the byt5
149-
decode_joined bug); the clean-label re-run restores it — 33M student,
150-
11,792 byte-exact r6 labels, train CE 1.55, windowed DER-CE **82.87%**
151-
vs the teacher's 1.32% on the same 300-paragraph harness. The failure
152-
mode is total: the trained student emits EOS immediately on free
153-
running (empty output; it fits the training set under teacher forcing
154-
but cannot sustain generation). The capacity conclusion for Arabic is
155-
now UNCONFOUNDED and matches Thai: sub-100M from-scratch byte students
156-
do not generalize; a pretrained backbone is non-negotiable.
147+
**RETRACTION (2026-08-24):** this verdict is CONFOUNDED — every Arabic
148+
label generated before the byt5 `decode_joined` fix was mojibake
149+
(double-encoded targets); both Arabic students trained on corrupted
150+
labels, and their identical DER scores are the bare-text constant, not
151+
a capacity result. The numbers stand as measured but the capacity
152+
conclusion for Arabic is UNPROVEN pending a clean-label re-run. The
153+
Thai tiny verdict is unaffected (umt5/sentencepiece labels were
154+
byte-exact); the pretrained-backbone law rests on Thai evidence.
155+
156+
## ara-diac-small-1.0 — Arabic client tier (2026-08-24)
157+
158+
Sequence-level KD from the r6 teacher (rababa_arabic_byt5/run-006-morph,
159+
2.5793 windowed DER-CE full-protocol): 29,322 greedy labels on r5-units
160+
(domain + replay, 1400-byte windows), ByT5-small init, 3 epochs. Same
161+
windowed harness as the ara-diac-tiny verdict (300 SadeedDiac-25
162+
paragraphs, Misraj evaluator, haraqat projection):
163+
164+
| Model | DER-CE |
165+
|---|---|
166+
| Teacher (r6) | 1.32% |
167+
| **Student (ByT5-small, client rung)** | **3.66%** |
168+
169+
Gate discussion: the strict budget (teacher +0.5pp) is missed by
170+
+2.34pp — the measured capacity cost of ByT5-small on Arabic
171+
diacritization, consistent with the Thai client tier (+7.63pp beam-4 /
172+
2.85% greedy against a 4.43% teacher). Shipped as the Arabic client
173+
rung per that precedent: the student generates real, well-voweled
174+
Arabic at a fraction of the teacher's artifact (1.3 vs 2.6 GiB), the
175+
strict gate is met by the teacher release (ara-diac-1.0), and the miss
176+
is disclosed rather than averaged away. For comparison, this student's
177+
3.66% sits in the same league as the r3 production teacher's era
178+
(2.68% on the older full-set protocol).
179+
180+
Training notes: this is the third training of run-002 — the first on
181+
mojibake labels (byt5 decode_joined bug), the second silently resumed
182+
from the poisoned lineage's checkpoints (now guarded by labels.sha
183+
digest matching), this one clean end-to-end. CE plateaued at ~0.016.
Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
# ara-diac-small-1.0
2+
3+
Arabic diacritization (haraqat restoration). Client-tier ByT5-small
4+
student distilled from the r6 teacher via sequence-level KD: 29,322
5+
greedy teacher labels over 1,400-byte windows of the r5-units corpus,
6+
3 epochs.
7+
8+
Capacity-limited at +2.34pp windowed DER-CE over the teacher (3.66% vs
9+
1.32% on the same 300-paragraph Sadeed harness) — the strict +0.5pp
10+
gate is met by the teacher release (ara-diac-1.0). Shipped as the
11+
Arabic client rung per the documented Thai client-tier precedent: a
12+
working student at a fraction of the artifact size, with the miss
13+
measured and disclosed. Identical IMF v1 contract: dynamic fetch,
14+
sha256-verified, KV decode.
15+
16+
```python
17+
from interscript_ml import Model
18+
model = Model.load("ara-diac-small-1.0")
19+
model.translate("قوله فحكمها في الوفاة")
20+
```
Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,30 @@
1+
format: imf-v1
2+
id: ara-diac-small-1.0
3+
task: diacritization
4+
source_script: Arab
5+
target: Arab
6+
tokenizer: bytes
7+
opset: 14
8+
decoder: kv
9+
precision: fp32
10+
license: BSD-3-Clause
11+
trained_from: 'sequence-level KD from the r6 teacher (rababa_arabic_byt5/run-006-morph/best,
12+
2.5793 windowed DER-CE on the full SadeedDiac-25 protocol): 29,322 greedy
13+
teacher-generated labels on the r5-units corpus (domain + replay, 1400-byte
14+
windows); ByT5-small init google/byt5-small; 3 epochs; checkpoint
15+
rababa-checkpoints:/rababa_arabic_distill_small/run-002/best. Client tier:
16+
capacity-limited at +2.34pp over the teacher — the strict gate is met by the
17+
teacher release (ara-diac-1.0); shipped as the Arabic client rung per the
18+
documented Thai precedent.'
19+
metrics:
20+
- name: der_teacher_greedy
21+
value: 1.3205
22+
protocol: windowed DER-CE (1400-byte windows, word-boundary split, greedy,
23+
haraqat-projected, Misraj evaluator); 300 SadeedDiac-25 paragraphs; r6 teacher
24+
on the same harness as the student
25+
source: interscript/interscript-ml docs/RESULTS.md#ara-diac-small-1.0
26+
- name: der_student_greedy
27+
value: 3.658
28+
protocol: same harness; +2.34pp client-tier shrink cost (strict gate was teacher
29+
+0.5pp); shipped capacity-limited — see the RESULTS gate discussion
30+
source: interscript/interscript-ml docs/RESULTS.md#ara-diac-small-1.0

‎models/metrics-sources.yaml‎

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -69,10 +69,19 @@ heb-diac-small-1.0:
6969
- {row: "Student (ByT5-small, gate)", column: DER, as: der_student_greedy}
7070
tha-g2p-small-1.0:
7171
repo: interscript/interscript-ml
72-
ref: main
72+
ref: docs/greedy-correction
7373
path: docs/RESULTS.md
7474
anchor: tha-g2p-small-10-thai-g2p-client-tier-2026-08-22
7575
protocol: "greedy decode via the Python runtime (the shipped ONNX KV path), corpus-level PER, true Levenshtein; 1,219 held-out Kaikki Thai test sentences"
7676
tables:
7777
- {row: "beam-4 (published, torch harness)", column: PER, as: per_student_beam4}
7878
- {row: "greedy (runtime protocol)", column: PER, as: per_student}
79+
ara-diac-small-1.0:
80+
repo: interscript/interscript-ml
81+
ref: main
82+
path: docs/RESULTS.md
83+
anchor: ara-diac-small-10-arabic-client-tier-2026-08-24
84+
protocol: "windowed DER-CE (1400-byte windows, greedy, haraqat-projected, Misraj evaluator); 300 SadeedDiac-25 paragraphs"
85+
tables:
86+
- {row: "Teacher (r6)", column: DER-CE, as: der_teacher_greedy}
87+
- {row: "Student (ByT5-small, client rung)", column: DER-CE, as: der_student_greedy}

0 commit comments

Comments
 (0)