diarray commited on
Commit
32264f9
·
verified ·
1 Parent(s): d441f73

Push model using huggingface_hub.

Browse files
Files changed (3) hide show
  1. .gitattributes +1 -0
  2. README.md +186 -0
  3. anbekalanNet.nemo +3 -0
.gitattributes CHANGED
@@ -33,3 +33,4 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
33
  *.zip filter=lfs diff=lfs merge=lfs -text
34
  *.zst filter=lfs diff=lfs merge=lfs -text
35
  *tfevents* filter=lfs diff=lfs merge=lfs -text
 
 
33
  *.zip filter=lfs diff=lfs merge=lfs -text
34
  *.zst filter=lfs diff=lfs merge=lfs -text
35
  *tfevents* filter=lfs diff=lfs merge=lfs -text
36
+ anbekalanNet.nemo filter=lfs diff=lfs merge=lfs -text
README.md ADDED
@@ -0,0 +1,186 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ language:
3
+ - bm
4
+ library_name: nemo
5
+ datasets:
6
+ - RobotsMali/an-be-kalan-bench
7
+ thumbnail: null
8
+ tags:
9
+ - automatic-speech-recognition
10
+ - speech
11
+ - audio
12
+ - CTC
13
+ - QuartzNet
14
+ - legacy-model
15
+ - deprecated
16
+ - pytorch
17
+ - Bambara
18
+ - NeMo
19
+ license: cc-by-4.0
20
+ base_model: RobotsMali/stt-bm-quartznet15x5-v2
21
+ model-index:
22
+ - name: anbekalanNet
23
+ results:
24
+ - task:
25
+ name: Automatic Speech Recognition
26
+ type: automatic-speech-recognition
27
+ dataset:
28
+ name: An be kalan Children's Reading Benchmark
29
+ type: RobotsMali/an-be-kalan-bench
30
+ split: test
31
+ args:
32
+ language: bm
33
+ metrics:
34
+ - name: Test WER
35
+ type: wer
36
+ value: 40.0
37
+ - name: Test CER
38
+ type: cer
39
+ value: 15.0
40
+ metrics:
41
+ - wer
42
+ - cer
43
+ pipeline_tag: automatic-speech-recognition
44
+ ---
45
+
46
+ # anbekalanNet (QuartzNet 15x5 char CTC Series) — [LEGACY]
47
+
48
+ <style>
49
+ img {
50
+ display: inline;
51
+ }
52
+ </style>
53
+
54
+ [![Model architecture](https://img.shields.io/badge/Model_Arch-QuartzNet-blue#model-badge)](#model-architecture)
55
+ | [![Model size](https://img.shields.io/badge/Params-18M-green#model-badge)](#model-architecture)
56
+ | [![Language](https://img.shields.io/badge/Language-bm-orange#model-badge)](#datasets)
57
+
58
+ `anbekalanNet` is the final domain-specific release of the convolutional QuartzNet framework adapted for Bambara children's reading materials. It is a fine-tuned version of [`RobotsMali/stt-bm-quartznet15x5-v2`](https://huggingface.co/RobotsMali/stt-bm-quartznet15x5-v2). Like its predecessors, the model was fine-tuned using **NVIDIA NeMo** and trained with **CTC (Connectionist Temporal Classification) Loss**.
59
+
60
+ ## **🚨 Obsolescence Notice**
61
+
62
+ This architecture is officially retired. Field testing and benchmark evaluations demonstrate that this convolutional foundation exhibits unstable alignment paths under tight, low-resource constraints compared to hybrid attention-transducer systems.
63
+
64
+
65
+ ## NVIDIA NeMo: Installation
66
+
67
+ To load or run evaluations on this legacy checkpoint, install the standard [NVIDIA NeMo](https://github.com/NVIDIA/NeMo) package:
68
+
69
+ ```bash
70
+ pip install nemo-toolkit['asr']
71
+
72
+ ```
73
+
74
+ ## How to Use This Model
75
+
76
+ ### Load Model with NeMo
77
+
78
+ ```python
79
+ import nemo.collections.asr as nemo_asr
80
+
81
+ asr_model = nemo_asr.models.EncDecCTCModel.from_pretrained(model_name="RobotsMali/anbekalanNet")
82
+
83
+ ```
84
+
85
+ ### Transcribe Audio
86
+
87
+ ```python
88
+ # Downsamples or processes input natively via its internal preprocessor
89
+ asr_model.transcribe(['sample_audio.wav'])
90
+
91
+ ```
92
+
93
+ ### Input / Output
94
+
95
+ * **Input:** Accepts **16 kHz mono-channel audio (wav files)**.
96
+ * **Output:** Generates a transcribed speech hypothesis object with a lowercase `.text` string attribute containing character-encoded text. It does not output punctuations or capitalizations.
97
+
98
+ ## Model Architecture
99
+
100
+ QuartzNet is a convolutional ASR model consisting of **1D time-channel separable convolutions** designed to minimize parameter count while maintaining acoustic representations. This specific variant utilizes a **15x5 block structure** with roughly 18 million parameters.
101
+
102
+ ## Training & Fine-Tuning Configurations
103
+
104
+ Four experimental setups were designed to test vocabulary limits and regularization effects. This final artifact (`anbekalanNet`) used the following strict parameters:
105
+
106
+ *
107
+ **Optimization Window:** Regulated with an **Early Stopping mechanism** set to a **15-epoch patience window** monitored against validation metrics.
108
+
109
+ *
110
+ **Convergence Behavior:** Due to high training-batch lexical convergence (<4% WER), validation metrics flatlined early. Operational shutdown was forced at **epoch 30** to protect the encoder from total generalization collapse.
111
+
112
+ ## Dataset
113
+
114
+ The model was fine-tuned on the combined **Main + Duplicate** expanded subsets (**45.6 hours** total) of the [RobotsMali/an-be-kalan-bench](https://huggingface.co/datasets/RobotsMali/an-be-kalan-bench) educational children's book corpus.
115
+
116
+ *
117
+ **Main Split (1.6h):** Pristine recordings of unique readings across 22 GAIFE books by 8 distinct speakers.
118
+
119
+
120
+ *
121
+ **Duplicate Split (44h):** High-density, redundant multi-speaker tracks reading identical textual literature to introduce physical vocal variance (pitch, child vocal acoustics, and regional accents).
122
+
123
+
124
+
125
+ ## Performance
126
+
127
+ The performance metrics below illustrate how expanding data volume rescued the QuartzNet framework from catastrophic lexical overfitting.
128
+
129
+ ### Overall Evaluation Metrics
130
+
131
+ | Experimental Pass | Dataset Baseline Configuration | SpecAugment | Training Volume | Test WER (%) ↓ | Test CER (%) ↓ |
132
+ | --- | --- | --- | --- | --- | --- |
133
+ | **anbekalanNet-exp3 (this release)** | <br>**Main + Duplicate**
134
+
135
+ | <br>**None**
136
+
137
+ | <br>**45.6 Hours**
138
+
139
+ | <br>**40.0%**
140
+
141
+ | <br>**15.0%**
142
+
143
+ |
144
+ | *anbekalanNet-exp1* | <br>*Main Only*
145
+
146
+ | <br>*None*
147
+
148
+ | <br>*1.6 Hours*
149
+
150
+ | <br>*93.0%*
151
+
152
+ | <br>*80.0%*
153
+
154
+ |
155
+ | *anbekalanNet-exp2* | <br>*Main Only*
156
+
157
+ | <br>*Active*
158
+
159
+ | <br>*1.6 Hours*
160
+
161
+ | <br>*64.0%*
162
+
163
+ | <br>*23.0%*
164
+
165
+ |
166
+ | *anbekalanNet-exp4* | <br>*Main + Duplicate*
167
+
168
+ | <br>*Active*
169
+
170
+ | <br>*45.6 Hours*
171
+
172
+ | <br>*42.0%*
173
+
174
+ | <br>*16.0%*
175
+
176
+ |
177
+
178
+ *All results indicate greedy decoding performance without external Language Models (LMs).*
179
+
180
+ ## License
181
+
182
+ This legacy checkpoint is archived and released under the **CC-BY-4.0** license.
183
+
184
+ ---
185
+
186
+ **Repository & Issues:** Technical tracking for this legacy series can be referenced at [RobotsMali-AI/bambara-asr](https://github.com/RobotsMali-AI/bambara-asr/). No further architectural expansions or fine-tuning updates are planned for this model card sequence.
anbekalanNet.nemo ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ version https://git-lfs.github.com/spec/v1
2
+ oid sha256:6f93029f8195b20c300d54637815433cb7f3e54d080b8a6df1541944dda951aa
3
+ size 76482560