kevinqz commited on
Commit
d2e2ec8
·
verified ·
1 Parent(s): a646ab2

coreai-fabric: moss-transcribe-diarize-decoder card + license + reports

Browse files
Files changed (3) hide show
  1. LICENSE +210 -0
  2. README.md +147 -0
  3. parity-report.json +71 -0
LICENSE ADDED
@@ -0,0 +1,210 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ NOTE — supplied by coreai-fabric (the redistributor), not the upstream.
2
+ The upstream OpenMOSS-Team/MOSS-Transcribe-Diarize @ d7231bbae2587a4af278735eb765b318c4f64edd declares its license as "apache-2.0"
3
+ in its Hugging Face model-card metadata but ships no LICENSE file. Under
4
+ Apache-2.0 §4(a) a redistribution must give recipients a copy of the
5
+ License, so the canonical apache-2.0 text is reproduced below
6
+ verbatim. Copyright in the underlying work remains with the upstream
7
+ authors (OpenMOSS-Team/MOSS-Transcribe-Diarize); see the model card for attribution.
8
+ ========================================================================
9
+
10
+ Apache License
11
+ Version 2.0, January 2004
12
+ http://www.apache.org/licenses/
13
+
14
+ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
15
+
16
+ 1. Definitions.
17
+
18
+ "License" shall mean the terms and conditions for use, reproduction,
19
+ and distribution as defined by Sections 1 through 9 of this document.
20
+
21
+ "Licensor" shall mean the copyright owner or entity authorized by
22
+ the copyright owner that is granting the License.
23
+
24
+ "Legal Entity" shall mean the union of the acting entity and all
25
+ other entities that control, are controlled by, or are under common
26
+ control with that entity. For the purposes of this definition,
27
+ "control" means (i) the power, direct or indirect, to cause the
28
+ direction or management of such entity, whether by contract or
29
+ otherwise, or (ii) ownership of fifty percent (50%) or more of the
30
+ outstanding shares, or (iii) beneficial ownership of such entity.
31
+
32
+ "You" (or "Your") shall mean an individual or Legal Entity
33
+ exercising permissions granted by this License.
34
+
35
+ "Source" form shall mean the preferred form for making modifications,
36
+ including but not limited to software source code, documentation
37
+ source, and configuration files.
38
+
39
+ "Object" form shall mean any form resulting from mechanical
40
+ transformation or translation of a Source form, including but
41
+ not limited to compiled object code, generated documentation,
42
+ and conversions to other media types.
43
+
44
+ "Work" shall mean the work of authorship, whether in Source or
45
+ Object form, made available under the License, as indicated by a
46
+ copyright notice that is included in or attached to the work
47
+ (an example is provided in the Appendix below).
48
+
49
+ "Derivative Works" shall mean any work, whether in Source or Object
50
+ form, that is based on (or derived from) the Work and for which the
51
+ editorial revisions, annotations, elaborations, or other modifications
52
+ represent, as a whole, an original work of authorship. For the purposes
53
+ of this License, Derivative Works shall not include works that remain
54
+ separable from, or merely link (or bind by name) to the interfaces of,
55
+ the Work and Derivative Works thereof.
56
+
57
+ "Contribution" shall mean any work of authorship, including
58
+ the original version of the Work and any modifications or additions
59
+ to that Work or Derivative Works thereof, that is intentionally
60
+ submitted to Licensor for inclusion in the Work by the copyright owner
61
+ or by an individual or Legal Entity authorized to submit on behalf of
62
+ the copyright owner. For the purposes of this definition, "submitted"
63
+ means any form of electronic, verbal, or written communication sent
64
+ to the Licensor or its representatives, including but not limited to
65
+ communication on electronic mailing lists, source code control systems,
66
+ and issue tracking systems that are managed by, or on behalf of, the
67
+ Licensor for the purpose of discussing and improving the Work, but
68
+ excluding communication that is conspicuously marked or otherwise
69
+ designated in writing by the copyright owner as "Not a Contribution."
70
+
71
+ "Contributor" shall mean Licensor and any individual or Legal Entity
72
+ on behalf of whom a Contribution has been received by Licensor and
73
+ subsequently incorporated within the Work.
74
+
75
+ 2. Grant of Copyright License. Subject to the terms and conditions of
76
+ this License, each Contributor hereby grants to You a perpetual,
77
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
78
+ copyright license to reproduce, prepare Derivative Works of,
79
+ publicly display, publicly perform, sublicense, and distribute the
80
+ Work and such Derivative Works in Source or Object form.
81
+
82
+ 3. Grant of Patent License. Subject to the terms and conditions of
83
+ this License, each Contributor hereby grants to You a perpetual,
84
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
85
+ (except as stated in this section) patent license to make, have made,
86
+ use, offer to sell, sell, import, and otherwise transfer the Work,
87
+ where such license applies only to those patent claims licensable
88
+ by such Contributor that are necessarily infringed by their
89
+ Contribution(s) alone or by combination of their Contribution(s)
90
+ with the Work to which such Contribution(s) was submitted. If You
91
+ institute patent litigation against any entity (including a
92
+ cross-claim or counterclaim in a lawsuit) alleging that the Work
93
+ or a Contribution incorporated within the Work constitutes direct
94
+ or contributory patent infringement, then any patent licenses
95
+ granted to You under this License for that Work shall terminate
96
+ as of the date such litigation is filed.
97
+
98
+ 4. Redistribution. You may reproduce and distribute copies of the
99
+ Work or Derivative Works thereof in any medium, with or without
100
+ modifications, and in Source or Object form, provided that You
101
+ meet the following conditions:
102
+
103
+ (a) You must give any other recipients of the Work or Derivative
104
+ Works a copy of this License; and
105
+
106
+ (b) You must cause any modified files to carry prominent notices
107
+ stating that You changed the files; and
108
+
109
+ (c) You must retain, in the Source form of any Derivative Works
110
+ that You distribute, all copyright, patent, trademark, and
111
+ attribution notices from the Source form of the Work,
112
+ excluding those notices that do not pertain to any part of
113
+ the Derivative Works; and
114
+
115
+ (d) If the Work includes a "NOTICE" text file as part of its
116
+ distribution, then any Derivative Works that You distribute must
117
+ include a readable copy of the attribution notices contained
118
+ within such NOTICE file, excluding those notices that do not
119
+ pertain to any part of the Derivative Works, in at least one
120
+ of the following places: within a NOTICE text file distributed
121
+ as part of the Derivative Works; within the Source form or
122
+ documentation, if provided along with the Derivative Works; or,
123
+ within a display generated by the Derivative Works, if and
124
+ wherever such third-party notices normally appear. The contents
125
+ of the NOTICE file are for informational purposes only and
126
+ do not modify the License. You may add Your own attribution
127
+ notices within Derivative Works that You distribute, alongside
128
+ or as an addendum to the NOTICE text from the Work, provided
129
+ that such additional attribution notices cannot be construed
130
+ as modifying the License.
131
+
132
+ You may add Your own copyright statement to Your modifications and
133
+ may provide additional or different license terms and conditions
134
+ for use, reproduction, or distribution of Your modifications, or
135
+ for any such Derivative Works as a whole, provided Your use,
136
+ reproduction, and distribution of the Work otherwise complies with
137
+ the conditions stated in this License.
138
+
139
+ 5. Submission of Contributions. Unless You explicitly state otherwise,
140
+ any Contribution intentionally submitted for inclusion in the Work
141
+ by You to the Licensor shall be under the terms and conditions of
142
+ this License, without any additional terms or conditions.
143
+ Notwithstanding the above, nothing herein shall supersede or modify
144
+ the terms of any separate license agreement you may have executed
145
+ with Licensor regarding such Contributions.
146
+
147
+ 6. Trademarks. This License does not grant permission to use the trade
148
+ names, trademarks, service marks, or product names of the Licensor,
149
+ except as required for reasonable and customary use in describing the
150
+ origin of the Work and reproducing the content of the NOTICE file.
151
+
152
+ 7. Disclaimer of Warranty. Unless required by applicable law or
153
+ agreed to in writing, Licensor provides the Work (and each
154
+ Contributor provides its Contributions) on an "AS IS" BASIS,
155
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
156
+ implied, including, without limitation, any warranties or conditions
157
+ of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
158
+ PARTICULAR PURPOSE. You are solely responsible for determining the
159
+ appropriateness of using or redistributing the Work and assume any
160
+ risks associated with Your exercise of permissions under this License.
161
+
162
+ 8. Limitation of Liability. In no event and under no legal theory,
163
+ whether in tort (including negligence), contract, or otherwise,
164
+ unless required by applicable law (such as deliberate and grossly
165
+ negligent acts) or agreed to in writing, shall any Contributor be
166
+ liable to You for damages, including any direct, indirect, special,
167
+ incidental, or consequential damages of any character arising as a
168
+ result of this License or out of the use or inability to use the
169
+ Work (including but not limited to damages for loss of goodwill,
170
+ work stoppage, computer failure or malfunction, or any and all
171
+ other commercial damages or losses), even if such Contributor
172
+ has been advised of the possibility of such damages.
173
+
174
+ 9. Accepting Warranty or Additional Liability. While redistributing
175
+ the Work or Derivative Works thereof, You may choose to offer,
176
+ and charge a fee for, acceptance of support, warranty, indemnity,
177
+ or other liability obligations and/or rights consistent with this
178
+ License. However, in accepting such obligations, You may act only
179
+ on Your own behalf and on Your sole responsibility, not on behalf
180
+ of any other Contributor, and only if You agree to indemnify,
181
+ defend, and hold each Contributor harmless for any liability
182
+ incurred by, or claims asserted against, such Contributor by reason
183
+ of your accepting any such warranty or additional liability.
184
+
185
+ END OF TERMS AND CONDITIONS
186
+
187
+ APPENDIX: How to apply the Apache License to your work.
188
+
189
+ To apply the Apache License to your work, attach the following
190
+ boilerplate notice, with the fields enclosed by brackets "[]"
191
+ replaced with your own identifying information. (Don't include
192
+ the brackets!) The text should be enclosed in the appropriate
193
+ comment syntax for the file format. We also recommend that a
194
+ file or class name and description of purpose be included on the
195
+ same "printed page" as the copyright notice for easier
196
+ identification within third-party archives.
197
+
198
+ Copyright [yyyy] [name of copyright owner]
199
+
200
+ Licensed under the Apache License, Version 2.0 (the "License");
201
+ you may not use this file except in compliance with the License.
202
+ You may obtain a copy of the License at
203
+
204
+ http://www.apache.org/licenses/LICENSE-2.0
205
+
206
+ Unless required by applicable law or agreed to in writing, software
207
+ distributed under the License is distributed on an "AS IS" BASIS,
208
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
209
+ See the License for the specific language governing permissions and
210
+ limitations under the License.
README.md ADDED
@@ -0,0 +1,147 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ license: apache-2.0
3
+ base_model: OpenMOSS-Team/MOSS-Transcribe-Diarize
4
+ pipeline_tag: audio-text-to-text
5
+ library_name: coreai
6
+ language:
7
+ - en
8
+ - zh
9
+ widget:
10
+ - text: "Explain on-device AI in one sentence."
11
+ - text: "Write a haiku about Apple Silicon."
12
+ tags:
13
+ - coreai
14
+ - core-ai
15
+ - coreai-fabric
16
+ - aimodel
17
+ - coreml
18
+ - apple
19
+ - apple-silicon
20
+ - on-device
21
+ - iphone
22
+ - metal
23
+ - audio-text-to-text
24
+ - llm
25
+ ---
26
+
27
+ > **Canonical:** [`kevinqz/MOSS-Transcribe-Diarize-Decoder-CoreAI`](https://huggingface.co/kevinqz/MOSS-Transcribe-Diarize-Decoder-CoreAI) — source of truth.
28
+
29
+ # MOSS-Transcribe-Diarize Qwen3 Decoder (fabric)
30
+
31
+ **Apple Core AI chat model — runs fully on-device on Apple Silicon
32
+ (iPhone / iPad / Mac, macOS/iOS 27+).**
33
+
34
+ A quantized **stateful KV-cache chat** `.aimodel` — an Apple Core AI conversion of
35
+ [OpenMOSS-Team/MOSS-Transcribe-Diarize](https://huggingface.co/OpenMOSS-Team/MOSS-Transcribe-Diarize), with an embedded
36
+ tokenizer + chat template. Produced by
37
+ [coreai-fabric](https://github.com/kevinqz/coreai-fabric/blob/main/recipes/moss-transcribe-diarize-decoder.yaml) and indexed by
38
+ [coreai-catalog](https://github.com/kevinqz/coreai-catalog).
39
+
40
+ ## Model facts
41
+
42
+ | Field | Value |
43
+ |---|---|
44
+ | Parameters | 0.6B |
45
+ | Architecture | transformer |
46
+ | Capabilities | speech-to-text, text-generation |
47
+ | Quantization / precision | none / float32 |
48
+ | Context length | — |
49
+ | On-disk size | 2.2 GB |
50
+ | Asset kind | stateful KV-cache chat bundle; embedded tokenizer + chat template |
51
+ | assetVersion | 2.0 |
52
+
53
+
54
+
55
+ ## Use it
56
+
57
+ Install via the catalog, then run it with Apple's Foundation Models runtime:
58
+
59
+ ```bash
60
+ pip install coreai-catalog && coreai-catalog install moss-transcribe-diarize-decoder
61
+ ```
62
+
63
+ ```swift
64
+ import CoreAILanguageModels
65
+ import FoundationModels
66
+
67
+ // modelURL = the installed macos/ bundle directory for this model
68
+ let model = try await CoreAILanguageModel(resourcesAt: modelURL)
69
+ let session = LanguageModelSession(model: model)
70
+ let reply = try await session.respond(to: "Explain on-device AI in one sentence.")
71
+ print(reply)
72
+ ```
73
+
74
+ A complete, buildable example lives at
75
+ [coreai-catalog/examples/llm-chat](https://github.com/kevinqz/coreai-catalog/tree/main/examples/llm-chat).
76
+
77
+ ## Requirements
78
+
79
+ - **Deployment: macOS 27.0+ / iOS 27.0+, Xcode 27+.** The asset serializes with
80
+ `minimum_os v27`, so the on-device Swift runtime requires macOS/iOS 27+.
81
+ - A Mac on **macOS 26 can convert and inspect** the asset but **cannot run** it
82
+ on-device (the Swift runtime needs the 27 SDK).
83
+ - Apple Silicon.
84
+
85
+ ## Intended use & limitations
86
+
87
+ - **Intended use:** general on-device chat / text generation. Inherits the base
88
+ model's capabilities, languages, and biases.
89
+ - **Limitations:** uncompressed (fp16) — full precision. See the Evaluation section for the measured
90
+ greedy fidelity vs the fp16 reference.
91
+
92
+ ## Evaluation (parity)
93
+
94
+ - **Gate A (structure): passed** — the bundle's layout + metadata were
95
+ validated on real hardware (Apple Silicon); the asset loads and generates.
96
+ - **Gate B (numeric accuracy): passed.** Task-accuracy evaluation (e.g. tinyMMLU) is pending *upstream*: Apple's `coreai.llm.eval` is a stub in coreai-models 0.1.0 that cannot score a stateful KV-cache asset. Greedy fidelity vs fp32 can be measured on-device via the parity runner. fabric never fakes a parity number.
97
+ - **Runtime throughput (tok/s):** to be published once measured on the on-device
98
+ (macOS/iOS 27) Swift runtime. Not estimated — real numbers or none.
99
+
100
+ ## Provenance
101
+
102
+ | Field | Value |
103
+ |---|---|
104
+ | Base model | [OpenMOSS-Team/MOSS-Transcribe-Diarize](https://huggingface.co/OpenMOSS-Team/MOSS-Transcribe-Diarize) @ `d7231bbae2587a4af278735eb765b318c4f64edd` |
105
+ | Converted by | `models/moss_transcribe/export_decoder.py` (version not reported) |
106
+ | Recipe | [moss-transcribe-diarize-decoder](https://github.com/kevinqz/coreai-fabric/blob/main/recipes/moss-transcribe-diarize-decoder.yaml) (recipe_source: fabric) |
107
+ | Precision / quantization | float32 / none |
108
+ | Conversion date | 2026-07-10 |
109
+
110
+ Machine-readable, in this repo:
111
+ [`parity-report.json`](./parity-report.json) (gate results) ·
112
+ [`reproduce-manifest.json`](./reproduce-manifest.json) (exact tool + stack + pinned
113
+ revision to reproduce this conversion) · [`LICENSE`](./LICENSE) (upstream terms).
114
+
115
+ ## License and attribution
116
+
117
+ Weights licensed **apache-2.0** — see the bundled `LICENSE`. This artifact is a **converted + quantized derivative** of the base
118
+ model (the Apache-2.0 §4(b) change notice): weights were converted to Apple Core
119
+ AI format and quantized to uncompressed (fp16). The conversion itself is community work.
120
+
121
+ ## Links
122
+
123
+ - **Base model:** [OpenMOSS-Team/MOSS-Transcribe-Diarize](https://huggingface.co/OpenMOSS-Team/MOSS-Transcribe-Diarize)
124
+ - **Reproduce:** [recipe `moss-transcribe-diarize-decoder`](https://github.com/kevinqz/coreai-fabric/blob/main/recipes/moss-transcribe-diarize-decoder.yaml) · [runnable example](https://github.com/kevinqz/coreai-catalog/tree/main/examples/llm-chat)
125
+ - **Index:** [coreai-catalog](https://github.com/kevinqz/coreai-catalog) — the neutral registry that ties upstream ↔ this asset ↔ mirror together
126
+
127
+
128
+ ## The on-device Core AI ecosystem
129
+
130
+ This conversion is part of a broader open ecosystem for running models on Apple's
131
+ on-device stack — useful references if you're building here:
132
+
133
+ - [coreai-fabric](https://github.com/kevinqz/coreai-fabric) — the reproducible
134
+ recipe → `.aimodel` pipeline that produced this asset.
135
+ - [coreai-catalog](https://github.com/kevinqz/coreai-catalog) — the index of Core
136
+ AI models across the community, with provenance and integration snippets.
137
+ - [apple/coreai-models](https://github.com/apple/coreai-models) — Apple's official
138
+ exporters and runtimes.
139
+ - [CoreAI Model Zoo](https://github.com/john-rocky/coreai-model-zoo) and the wider
140
+ [coreai-community](https://huggingface.co/coreai-community) — community
141
+ conversions across many model families.
142
+
143
+ ## Not affiliated with Apple
144
+
145
+ Community conversion. Not produced, hosted, or endorsed by Apple. Apple and
146
+ Core AI are trademarks of Apple Inc., used here only to describe the target
147
+ runtime/format. This is an independent community conversion.
parity-report.json ADDED
@@ -0,0 +1,71 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "recipe_id": "moss-transcribe-diarize-decoder",
3
+ "generated_at": "2026-07-10T03:56:49+00:00",
4
+ "bundle": "build/moss-transcribe-diarize-decoder/moss-transcribe-diarize-decoder.aimodel",
5
+ "conversion_manifest": null,
6
+ "gate_a": {
7
+ "status": "passed",
8
+ "checks": [
9
+ {
10
+ "name": "bundle_exists",
11
+ "status": "passed",
12
+ "detail": "build/moss-transcribe-diarize-decoder/moss-transcribe-diarize-decoder.aimodel"
13
+ },
14
+ {
15
+ "name": "bundle_files_present",
16
+ "status": "passed",
17
+ "detail": "3 expected file(s) present"
18
+ },
19
+ {
20
+ "name": "metadata_json_parses",
21
+ "status": "passed",
22
+ "detail": "metadata.json parses (3 top-level keys)"
23
+ },
24
+ {
25
+ "name": "metadata_matches_recipe",
26
+ "status": "passed",
27
+ "detail": "1 key(s) match"
28
+ }
29
+ ]
30
+ },
31
+ "gate_b": {
32
+ "metric": "graph_output_cosine",
33
+ "threshold": 0.999,
34
+ "tolerance": 0.0005,
35
+ "value": 0.9999999999855157,
36
+ "status": "passed",
37
+ "measurement_source": "graph-output-parity-measured.json",
38
+ "min_cosine": 0.9999999999855157,
39
+ "median_cosine": 0.9999999999928846,
40
+ "mean_cosine": 0.9999999999923304,
41
+ "cosine_ci95": [
42
+ 0.9999999999855157,
43
+ 0.9999999999915508
44
+ ],
45
+ "per_obs_cosine": [
46
+ 0.9999999999888292,
47
+ 0.9999999999931365,
48
+ 0.9999999999967749,
49
+ 0.9999999999915508,
50
+ 0.9999999999855157,
51
+ 0.9999999999926326,
52
+ 0.9999999999959467,
53
+ 0.9999999999942565
54
+ ],
55
+ "n_obs": 8,
56
+ "seq_len": 64,
57
+ "vocab_size": 151936,
58
+ "reference_dtype": "float32",
59
+ "runner": "coreai-fabric-parity-runner/0.1.0",
60
+ "environment": {
61
+ "platform": "darwin-arm64",
62
+ "accelerator": "apple_silicon",
63
+ "runtime_version": "1.0.0b2",
64
+ "coreai_torch": "0.4.1",
65
+ "torch": "2.9.0",
66
+ "transformers": "4.57.6"
67
+ },
68
+ "reference": "Torch MOSS Qwen3 decoder logits [1,S,151936] vs the Core AI .aimodel over identical seeded inputs_embeds [1,S,1024]; single causal prefill forward."
69
+ },
70
+ "overall": "passed"
71
+ }