add deterministic GTCRN Simple MLX weights

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Rong Xiaobin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,63 @@
+---
+license: mit
+library_name: mlx
+pipeline_tag: audio-to-audio
+tags:
+  - speech-enhancement
+  - speech-denoising
+  - gtcrn
+  - mlx
+  - apple-silicon
+  - onnx-conversion
+---
+
+# GTCRN Simple - MLX
+
+Apple MLX conversion of the GTCRN Simple streaming speech-enhancement model.
+This repository contains FP32 safetensors deterministically converted from the
+pinned Sherpa-ONNX release asset. It is a layout conversion only: there is no
+retraining, quantization, fusion, or weight modification beyond the layout
+required by MLX convolutions.
+
+## Files
+
+- `model.safetensors` - 208,427-byte FP32 MLX weight file. Its SHA-256 is
+  `d503ed83a35b91f66af97a6a1b07a76425988db7d9744556d0565c336a7e6e3b`.
+- `conversion.json` - deterministic conversion record binding the source ONNX,
+  audit, converter revision, weight SHA-256, byte count, and 179 tensors.
+- `LICENSE` - the upstream GTCRN MIT license.
+
+## Provenance
+
+- Upstream implementation and model: [Xiaobin-Rong/gtcrn](https://github.com/Xiaobin-Rong/gtcrn)
+  at `9202557caa577baf2ec2220bef82ba9f4b589dc1`.
+- Pinned ONNX source: the Sherpa-ONNX `gtcrn_simple.onnx` release asset, SHA-256
+  `e77603ac0c23dac3227dd2d7135b3a585cbee2679048aecfa886657d3ae1b534`.
+- Conversion: [model-gtcrn](https://github.com/agentable/model-gtcrn)
+  `scripts/convert_onnx_to_mlx.py`, using its committed conversion audit.
+
+The converted file preserves ONNX initializer names. ONNX Conv weights become
+MLX OHWI; grouped ConvTranspose weights use the audited group-aware layout
+transform. GRU, normalization, PReLU, matrix, and structural parameters retain
+their source layouts as required by the MLX runner.
+
+## Validation
+
+The MLX runner replays the pinned one-frame GTCRN graph, including all three
+recurrent cache families. It is validated against the committed ONNX frame and
+cache oracle with maximum absolute error below `5e-5` on Metal FP32 execution.
+End-to-end waveform and corpus-quality qualification are not part of this
+artifact release; they remain required gates in the consumer library before a
+production release.
+
+## Usage
+
+This artifact is consumed by the `engine: mlx` backend in
+[model-gtcrn](https://github.com/agentable/model-gtcrn) on Apple Silicon with
+the `mlx` build tag. The consumer manifest pins this repository at an immutable
+commit and verifies the asset SHA-256 and byte count before MLX allocation.
+
+## License
+
+The upstream GTCRN model is distributed under the MIT license. This derived
+format conversion is redistributed under that same license; see `LICENSE`.

conversion.json

@@ -0,0 +1,11 @@
+{
+  "asset_bytes": 208427,
+  "asset_filename": "model.safetensors",
+  "asset_sha256": "d503ed83a35b91f66af97a6a1b07a76425988db7d9744556d0565c336a7e6e3b",
+  "audit_sha256": "23e83d7bc95de4ea3b8ee2940ec12592284b33ed05e8bcea3d51349a04fa7918",
+  "converter_sha256": "45bd6d99d87f4a4667642e9bec0f6f21c384e5c7dc6e19167e9d595ead4a579c",
+  "generated_by": "scripts/convert_onnx_to_mlx.py",
+  "schema_version": "gtcrn-mlx-conversion-v1",
+  "source_onnx_sha256": "e77603ac0c23dac3227dd2d7135b3a585cbee2679048aecfa886657d3ae1b534",
+  "tensor_count": 179
+}

model.safetensors

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:d503ed83a35b91f66af97a6a1b07a76425988db7d9744556d0565c336a7e6e3b
+size 208427