faraday commited on
Commit
07bc44c
·
1 Parent(s): f7f5573

Add RE-USE MLX converted weights

Browse files

Includes the converted MLX safetensors artifact, source revision manifest,
NVIDIA noncommercial license text, attribution notice, and model card.

Files changed (5) hide show
  1. LICENSE +35 -0
  2. NOTICE +8 -0
  3. README.md +161 -0
  4. conversion-manifest.json +19 -0
  5. model_mlx.safetensors +3 -0
LICENSE ADDED
@@ -0,0 +1,35 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ NVIDIA License
2
+
3
+ 1. Definitions
4
+
5
+ “Licensor” means any person or entity that distributes its Work.
6
+ “Work” means (a) the original work of authorship made available under this license, which may include software, documentation, or other files, and (b) any additions to or derivative works thereof that are made available under this license.
7
+ The terms “reproduce,” “reproduction,” “derivative works,” and “distribution” have the meaning as provided under U.S. copyright law; provided, however, that for the purposes of this license, derivative works shall not include works that remain separable from, or merely link (or bind by name) to the interfaces of, the Work.
8
+ Works are “made available” under this license by including in or with the Work either (a) a copyright notice referencing the applicability of this license to the Work, or (b) a copy of this license.
9
+
10
+ 2. License Grant
11
+
12
+ 2.1 Copyright Grant. Subject to the terms and conditions of this license, each Licensor grants to you a perpetual, worldwide, non-exclusive, royalty-free, copyright license to use, reproduce, prepare derivative works of, publicly display, publicly perform, sublicense and distribute its Work and any resulting derivative works in any form.
13
+
14
+ 3. Limitations
15
+
16
+ 3.1 Redistribution. You may reproduce or distribute the Work only if (a) you do so under this license, (b) you include a complete copy of this license with your distribution, and (c) you retain without modification any copyright, patent, trademark, or attribution notices that are present in the Work.
17
+
18
+ 3.2 Derivative Works. You may specify that additional or different terms apply to the use, reproduction, and distribution of your derivative works of the Work (“Your Terms”) only if (a) Your Terms provide that the use limitation in Section 3.3 applies to your derivative works, and (b) you identify the specific derivative works that are subject to Your Terms. Notwithstanding Your Terms, this license (including the redistribution requirements in Section 3.1) will continue to apply to the Work itself.
19
+
20
+ 3.3 Use Limitation. The Work and any derivative works thereof only may be used or intended for use non-commercially. Notwithstanding the foregoing, NVIDIA Corporation and its affiliates may use the Work and any derivative works commercially. As used herein, “non-commercially” means for non-commercial research and educational purposes only.
21
+
22
+ 3.4 Patent Claims. If you bring or threaten to bring a patent claim against any Licensor (including any claim, cross-claim or counterclaim in a lawsuit) to enforce any patents that you allege are infringed by any Work, then your rights under this license from such Licensor (including the grant in Section 2.1) will terminate immediately.
23
+
24
+ 3.5 Trademarks. This license does not grant any rights to use any Licensor’s or its affiliates’ names, logos, or trademarks, except as necessary to reproduce the notices described in this license.
25
+
26
+ 3.6 Termination. If you violate any term of this license, then your rights under this license (including the grant in Section 2.1) will terminate immediately.
27
+
28
+ 4. Disclaimer of Warranty.
29
+
30
+ THE WORK IS PROVIDED “AS IS” WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING WARRANTIES OR CONDITIONS OF
31
+ MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE OR NON-INFRINGEMENT. YOU BEAR THE RISK OF UNDERTAKING ANY ACTIVITIES UNDER THIS LICENSE.
32
+
33
+ 5. Limitation of Liability.
34
+
35
+ EXCEPT AS PROHIBITED BY APPLICABLE LAW, IN NO EVENT AND UNDER NO LEGAL THEORY, WHETHER IN TORT (INCLUDING NEGLIGENCE), CONTRACT, OR OTHERWISE SHALL ANY LICENSOR BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES ARISING OUT OF OR RELATED TO THIS LICENSE, THE USE OR INABILITY TO USE THE WORK (INCLUDING BUT NOT LIMITED TO LOSS OF GOODWILL, BUSINESS INTERRUPTION, LOST PROFITS OR DATA, COMPUTER FAILURE OR MALFUNCTION, OR ANY OTHER DAMAGES OR LOSSES), EVEN IF THE LICENSOR HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
NOTICE ADDED
@@ -0,0 +1,8 @@
 
 
 
 
 
 
 
 
 
1
+ These artifacts are converted MLX-format derivative weights for NVIDIA RE-USE.
2
+
3
+ Original model: https://huggingface.co/nvidia/RE-USE
4
+ Original license: NVIDIA One-Way Noncommercial License (NSCLv1)
5
+ License text: https://raw.githubusercontent.com/NVlabs/HMAR/main/LICENSE
6
+
7
+ This repository is not affiliated with, sponsored by, or endorsed by NVIDIA.
8
+ NVIDIA trademarks are referenced only for attribution and license notice purposes.
README.md CHANGED
@@ -2,4 +2,165 @@
2
  license: other
3
  license_name: nvidia-one-way-noncommercial-license-nsclv1
4
  license_link: https://github.com/NVlabs/HMAR/blob/main/LICENSE
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
5
  ---
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
2
  license: other
3
  license_name: nvidia-one-way-noncommercial-license-nsclv1
4
  license_link: https://github.com/NVlabs/HMAR/blob/main/LICENSE
5
+ track_downloads: true
6
+ pipeline_tag: audio-to-audio
7
+ tasks:
8
+ - audio-to-audio
9
+ base_model: nvidia/RE-USE
10
+ library_name: mlx
11
+ tags:
12
+ - speech-enhancement
13
+ - universal speech enhancement
14
+ - multiple input sampling rates
15
+ - language-agnostic
16
+ - audio-to-audio
17
+ - mamba
18
+ - re-use
19
+ - mlx
20
+ - mlx-swift
21
+ - safetensors
22
+ - apple
23
  ---
24
+
25
+ # RE-USE MLX Converted Weights
26
+
27
+ This repository contains MLX-compatible converted weights for [`nvidia/RE-USE`](https://huggingface.co/nvidia/RE-USE), NVIDIA's multilingual universal speech enhancement model.
28
+
29
+ These artifacts are intended for Apple Silicon / MLX / MLX Swift inference workflows.
30
+
31
+ ## Files
32
+
33
+ | File | Description |
34
+ |---|---|
35
+ | `model_mlx.safetensors` | Converted MLX-compatible runtime weights. |
36
+ | `conversion-manifest.json` | Source revision, checksum, size, license, and conversion metadata. |
37
+ | `LICENSE` | Copy of the NVIDIA One-Way Noncommercial License (NSCLv1). |
38
+ | `NOTICE` | Attribution and repository relationship notice. |
39
+
40
+ ## Source Model
41
+
42
+ These weights are derived from:
43
+
44
+ - Model: [`nvidia/RE-USE`](https://huggingface.co/nvidia/RE-USE)
45
+ - Source revision: `761905064ea1ea882e015e20a64e2e9d28458890`
46
+ - Source file: `model.safetensors`
47
+ - Upstream model version: `30USEMamba_peak+GAN_tel_mic_1134k`
48
+
49
+ This repository contains a converted derivative artifact only. It does not contain the original NVIDIA checkpoint.
50
+
51
+ ## Conversion
52
+
53
+ The conversion changes tensor keys and layouts for MLX Swift compatibility. It does not train, fine-tune, distill, quantize, or otherwise modify the learned model behavior.
54
+
55
+ The conversion consists of:
56
+
57
+ - mapping source PyTorch-style parameter names to MLX Swift parameter names
58
+ - converting convolution tensor layouts where required by the MLX implementation
59
+ - preserving required tensor dtypes for runtime correctness
60
+ - writing the result as `model_mlx.safetensors`
61
+
62
+ See `conversion-manifest.json` for checksum and source metadata.
63
+
64
+ ## License / Terms of Use
65
+
66
+ These converted weights are distributed under the **NVIDIA One-Way Noncommercial License (NSCLv1)**.
67
+
68
+ Use is limited to **non-commercial research and educational purposes only**.
69
+
70
+ The complete license text is included in this repository as `LICENSE` and is also available from NVIDIA at:
71
+
72
+ <https://github.com/NVlabs/HMAR/blob/main/LICENSE>
73
+
74
+ Any source code used with these weights may be licensed separately. That source-code license does not change the license terms of these converted model weights.
75
+
76
+ ## Attribution
77
+
78
+ Original model and checkpoint are by NVIDIA and the upstream RE-USE contributors.
79
+
80
+ This repository is not affiliated with, sponsored by, or endorsed by NVIDIA. NVIDIA trademarks are referenced only for attribution and license notice purposes.
81
+
82
+ ## Use Case
83
+
84
+ Researchers and general users can use these MLX-compatible converted weights to enhance the quality of their speech data.
85
+
86
+ These weights are derived from `nvidia/RE-USE` and remain subject to the NVIDIA One-Way Noncommercial License (NSCLv1).
87
+
88
+ ## Model Architecture
89
+ **Architecture Type:** Convolutional encoder, Convolutional decoder, and Mamba for time–frequency modeling <br>
90
+ **Network Architecture:** Bi-directional Mamba with 30 layers <br>
91
+ **Number of model parameters:** 9.6M <br>
92
+
93
+ ## Input
94
+
95
+ Input Type(s): Audio <br>
96
+ Input Format(s): Typically `.wav` files in compatible implementations <br>
97
+ Input Parameters: One-Dimensional (1D) <br>
98
+ Other Properties Related to Input: 8000 Hz - 48000 Hz Mono-channel Audio <br>
99
+
100
+ ## Output
101
+
102
+ Output Type(s): Audio <br>
103
+ Output Format: Typically `.wav` files in compatible implementations <br>
104
+ Output Parameters: One-Dimensional (1D) <br>
105
+ Other Properties Related to Output: 8000 Hz - 48000 Hz Mono-channel Audio <br>
106
+
107
+ ## Software Integration
108
+
109
+ These converted weights are intended for MLX-compatible implementations, especially MLX Swift on Apple Silicon.
110
+
111
+ Upstream NVIDIA RE-USE was originally documented for NVIDIA GPU-accelerated systems. See the original model card for upstream environment, hardware, and inference instructions:
112
+
113
+ <https://huggingface.co/nvidia/RE-USE>
114
+
115
+ ## Training Data
116
+
117
+ This repository does not modify or retrain the model.
118
+
119
+ Training dataset details are documented by NVIDIA in the upstream RE-USE model card:
120
+
121
+ <https://huggingface.co/nvidia/RE-USE>
122
+
123
+ ## Checksum
124
+
125
+ `model_mlx.safetensors`
126
+
127
+ ```text
128
+ SHA-256: d1158502eaf39d0b11d097177160ce3804454653c5d14d17921b6c274ca53237
129
+ Size: 38583628 bytes
130
+ ```
131
+
132
+ ## Ethical Considerations
133
+
134
+ Speech enhancement can alter evidence-like audio. Enhanced outputs should not be represented as untouched originals.
135
+
136
+ Users should evaluate model behavior on their own data and use case before deployment. For upstream NVIDIA model quality, safety, or security concerns, see the original RE-USE model card.
137
+
138
+ ## Citation
139
+
140
+ Please cite the original NVIDIA RE-USE model and paper when using these converted weights.
141
+
142
+ Original model repository:
143
+
144
+ <https://huggingface.co/nvidia/RE-USE>
145
+
146
+ ```bibtex
147
+ @article{fu2026rethinking,
148
+ title={Rethinking Training Targets, Architectures and Data Quality for Universal Speech Enhancement},
149
+ author={Fu, Szu-Wei and Chao, Rong and Yang, Xuesong and Huang, Sung-Feng and Zezario, Ryandhimas E and Nasretdinov, Rauf and Juki{\'c}, Ante and Tsao, Yu and Wang, Yu-Chiang Frank},
150
+ journal={arXiv preprint arXiv:2603.02641},
151
+ year={2026}
152
+ }
153
+ ```
154
+
155
+ If you use this MLX conversion artifact directly, please also cite this repository:
156
+
157
+ ```bibtex
158
+ @misc{cagataycalli2026reusemlx,
159
+ title = {RE-USE MLX Converted Weights},
160
+ author = {Çağatay Çallı},
161
+ year = {2026},
162
+ publisher = {Hugging Face},
163
+ howpublished = {\url{https://huggingface.co/faraday/re-use-mlx}},
164
+ note = {MLX-compatible converted weights derived from NVIDIA RE-USE}
165
+ }
166
+ ```
conversion-manifest.json ADDED
@@ -0,0 +1,19 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "artifact": "re-use-mlx",
3
+ "artifact_version": "1.0.0",
4
+ "source_model": "nvidia/RE-USE",
5
+ "source_revision": "761905064ea1ea882e015e20a64e2e9d28458890",
6
+ "source_file": "model.safetensors",
7
+ "license": "NVIDIA One-Way Noncommercial License (NSCLv1)",
8
+ "converter": {
9
+ "name": "MLX-Swift weight conversion",
10
+ "output_format": "MLX-compatible safetensors"
11
+ },
12
+ "files": {
13
+ "model_mlx.safetensors": {
14
+ "role": "runtime_model_weights",
15
+ "sha256": "d1158502eaf39d0b11d097177160ce3804454653c5d14d17921b6c274ca53237",
16
+ "size_bytes": 38583628
17
+ }
18
+ }
19
+ }
model_mlx.safetensors ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ version https://git-lfs.github.com/spec/v1
2
+ oid sha256:d1158502eaf39d0b11d097177160ce3804454653c5d14d17921b6c274ca53237
3
+ size 38583628