Update repository

Co-authored-by: laurier-rochon <laurier-rochon@users.noreply.huggingface.co>
Co-authored-by: pveugen <pveugen@users.noreply.huggingface.co>
Co-authored-by: finnvoorhees <finnvoorhees@users.noreply.huggingface.co>

.gitattributes

@@ -0,0 +1,36 @@
+*.7z filter=lfs diff=lfs merge=lfs -text
+*.arrow filter=lfs diff=lfs merge=lfs -text
+*.bin filter=lfs diff=lfs merge=lfs -text
+*.bz2 filter=lfs diff=lfs merge=lfs -text
+*.ckpt filter=lfs diff=lfs merge=lfs -text
+*.ftz filter=lfs diff=lfs merge=lfs -text
+*.gz filter=lfs diff=lfs merge=lfs -text
+*.h5 filter=lfs diff=lfs merge=lfs -text
+*.joblib filter=lfs diff=lfs merge=lfs -text
+*.lfs.* filter=lfs diff=lfs merge=lfs -text
+*.mlirb filter=lfs diff=lfs merge=lfs -text
+*.mlmodel filter=lfs diff=lfs merge=lfs -text
+*.model filter=lfs diff=lfs merge=lfs -text
+*.msgpack filter=lfs diff=lfs merge=lfs -text
+*.npy filter=lfs diff=lfs merge=lfs -text
+*.npz filter=lfs diff=lfs merge=lfs -text
+*.onnx filter=lfs diff=lfs merge=lfs -text
+*.ot filter=lfs diff=lfs merge=lfs -text
+*.parquet filter=lfs diff=lfs merge=lfs -text
+*.pb filter=lfs diff=lfs merge=lfs -text
+*.pickle filter=lfs diff=lfs merge=lfs -text
+*.pkl filter=lfs diff=lfs merge=lfs -text
+*.pt filter=lfs diff=lfs merge=lfs -text
+*.pth filter=lfs diff=lfs merge=lfs -text
+*.rar filter=lfs diff=lfs merge=lfs -text
+*.safetensors filter=lfs diff=lfs merge=lfs -text
+*.tar filter=lfs diff=lfs merge=lfs -text
+*.tar.* filter=lfs diff=lfs merge=lfs -text
+*.tflite filter=lfs diff=lfs merge=lfs -text
+*.tgz filter=lfs diff=lfs merge=lfs -text
+*.wasm filter=lfs diff=lfs merge=lfs -text
+*.xz filter=lfs diff=lfs merge=lfs -text
+*.zip filter=lfs diff=lfs merge=lfs -text
+*.zst filter=lfs diff=lfs merge=lfs -text
+*tfevents* filter=lfs diff=lfs merge=lfs -text
+saved_model/**/* filter=lfs diff=lfs merge=lfs -text

README.md

@@ -0,0 +1,211 @@
+---
+license: other
+license_name: desert-ant-labs-source-available-1.0
+license_link: https://license.desertant.com/1.0
+tags:
+- audio
+- speech
+- speech-enhancement
+- speech-denoising
+- noise-suppression
+- dereverberation
+- podcast
+- on-device
+- core-ml
+- core-ai
+- onnx
+- ios
+- android
+pipeline_tag: audio-to-audio
+---
+
+<!-- card-header:start (generated from manifest.json, edit below this block) -->
+# Clear
+
+Studio sound, no cloud bill.
+
+On-device speech enhancement: denoise, dereverb, and loudness-normalize.
+
+- **SDKs, install and examples:** https://github.com/Desert-Ant-Labs/desert-ant-core/blob/main/docs/models/clear.md
+- **Website:** https://desertant.com/models/clear/
+
+<!-- card-header:end -->
+
+Record in a coffee shop and get studio sound, for podcasters, video creators and
+voice apps.
+
+Reduce noise, clean up audio,
+normalize volume. Works on noisy 48kHz mono or stereo audio: meeting recorders, bluetooth
+microphones, built-in phone mics, a laptop in a coffee shop.
+
+Runs entirely on the Apple Neural Engine via Core ML, and on Android via
+LiteRT. iOS 27 and macOS 27 add provisional Core AI builds of both variants.
+The Core ML assets use the iOS 16 model format; the Swift SDK currently
+supports iOS 17+ and macOS 14+.
+
+## Sound
+
+Delivers a **rich, present, close-miked podcast sound**.
+
+- **Denoised.**
+  HVAC, keyboard clicks, mouse rustle, mic bumps, room hum, laptop
+  fans, coffee shop background, all pulled down without chewing
+  consonants.
+- **Dereverbed.**
+  Untreated bedrooms, offices and hotel rooms come out sounding closer
+  to a treated studio. The model does not add reverberation of its own.
+- **Warm and present.**
+  Low-mids brought forward so voice sits comfortably in a mix rather
+  than sounding thin or distant.
+- **Sibilance-safe.**
+  No harsh peaks introduced when cleaning up S / T / F consonants.
+- **No pumping or musical-noise artefacts.**
+  Breaths, plosives and vocal texture stay intact.
+
+## Variants
+
+Two variants ship. They take the same input, produce the same output format
+and cost the same to run, so switching between them is a one-line change in
+the SDK. Pick by the sound you want, not by platform: both ship for every
+runtime.
+
+### clear-studio
+
+The default. Quiet, studio-like character; silences sit close to true
+zero.
+
+Best for solo podcasts, tutorials, voiceover, video demos, screen
+recordings, and anything that wants a clean broadcast feel.
+
+| File | Purpose | Size |
+|---|---|---:|
+| `clear-studio.mlmodelc` | Core ML for the Apple Neural Engine (iOS 16 model format) | 9.0MB |
+| `clear-studio.mlmodelc.zip` | Same compiled model, zipped | 8.6MB |
+| `clear-studio.onnx` | Cross-platform ONNX | 24MB |
+
+### clear-natural
+
+Preserves room tone, breath, and lip texture.
+
+For treated podcast studios, intentional voiceover, interviews where
+the room is part of the take, and remote guest recordings where
+absolute silence would sound wrong.
+
+| File | Purpose | Size |
+|---|---|---:|
+| `clear-natural.mlmodelc` | Core ML for the Apple Neural Engine (iOS 16 model format) | 9.0MB |
+| `clear-natural.mlmodelc.zip` | Same compiled model, zipped | 8.6MB |
+| `clear-natural.onnx` | Cross-platform ONNX | 24MB |
+
+## Performance
+
+The Core ML variants are optimized for the Apple Neural Engine.
+`MLComputePlan` confirms that all 492 model operations run on ANE.
+
+`clear-studio`, whole SDK pipeline on a 60-second clip, best of three:
+
+| Device | Realtime factor |
+|---|---:|
+| iPhone 16 Pro | **302x** |
+| MacBook Pro (M5) | **345x** |
+
+On iPhone 16 Pro, first-ever model loading takes approximately 3.4 seconds
+while Core ML compiles the ANE program. Cached launches load in approximately
+62ms; applications should warm the model in the background.
+
+### Core AI
+
+`clear-studio.aimodel` and `clear-natural.aimodel` are Core AI builds for
+iOS 27 and macOS 27, with fp16 weights. On an iPhone 17 Pro the studio
+variant runs the whole SDK pipeline at 413x realtime, against 366x for the
+Core ML build on the same device and clip.
+
+These files are provisional. The Core AI toolchain is in beta and its asset
+format has changed between beta releases, so both will be rebuilt against the
+released toolchain. No SDK resolves them yet.
+
+## Try it
+
+<!-- card-install:start (generated from manifest.json, edit below this block) -->
+| | |
+| --- | --- |
+| **Platforms** | iOS, macOS, tvOS, visionOS, Android, Linux, Windows, Browser, Node |
+| **Weights** | [v0.3.0](https://huggingface.co/desert-ant-labs/clear) |
+
+## Install
+
+**Swift** ([requirements](https://github.com/Desert-Ant-Labs/desert-ant-core/blob/main/README.md#swift))
+
+```swift
+.package(url: "https://github.com/Desert-Ant-Labs/desert-ant-core.git", from: "3.1.0")
+```
+
+Then add the `Clear` product to your target.
+
+**Kotlin** ([requirements](https://github.com/Desert-Ant-Labs/desert-ant-core/blob/main/README.md#android))
+
+```kotlin
+implementation("ai.desertant:clear:3.1.0")
+```
+
+**JavaScript** ([requirements](https://github.com/Desert-Ant-Labs/desert-ant-core/blob/main/README.md#javascript-and-typescript))
+
+```bash
+npm i @desert-ant-labs/clear @litertjs/core   # browser
+npm i @desert-ant-labs/clear                  # Node, prebuilt native core
+```
+<!-- card-install:end -->
+
+## What it's good for
+
+- **Meeting recorders.** Zoom, Teams, Meet, Detail exports, single or multi-speaker.
+- **Bluetooth microphones.** AirPods, Sony, headset mics.
+- **Mobile devices.** iPhone and Android built-in microphone recordings, voice notes, field recordings.
+- **Laptop built-in microphones.** MacBook and PC built-in mics.
+- **Untreated rooms.** Bedrooms, hotel rooms, kitchens, coffee shops.
+
+Whenever the pitch is *messy recording in, clean audio out*.
+
+## What it is not
+
+- Not a general-purpose audio denoiser.
+  Speech is the target; music, effects, and non-vocal signals get pulled down as noise.
+- Not a source separator.
+  Overlapping speakers stay overlapping.
+- Not a voice changer, cloner, or transcription model.
+
+## Keywords
+
+speech enhancement · noise suppression · dereverberation · speech
+denoising · reduce noise · clean up audio · normalize volume · turn a
+recording into studio sound · messy recording in clean audio out ·
+podcast audio · voice cleanup · meeting recorder cleanup · bluetooth
+microphone cleanup · mobile device audio · built-in microphone ·
+on-device audio · edge ML · Core ML · ONNX · iOS speech enhancement ·
+Android speech enhancement · real-time speech enhancement ·
+studio sound · podcast sound · Apple Neural Engine · ANE
+
+<!-- card-footer:start (generated from manifest.json, edit above this block) -->
+## License
+
+[Desert Ant Labs Source-Available License](https://license.desertant.com/1.0). Free for most
+apps, and a commercial license is required at scale. Full terms are at the link.
+Licensing: <licensing@desertant.com>.
+
+See [`THIRD_PARTY_NOTICES.md`](THIRD_PARTY_NOTICES.md).
+
+## Citation
+
+```bibtex
+@software{clear_2026,
+  title  = {Clear: On-device speech enhancement: denoise, dereverb, and loudness-normalize},
+  author = {Desert Ant Labs},
+  year   = {2026},
+  url    = {https://huggingface.co/desert-ant-labs/clear},
+}
+```
+
+---
+
+© 2026 Desert Ant Labs · <https://desertant.com>
+<!-- card-footer:end -->

THIRD_PARTY_NOTICES.md

@@ -0,0 +1,38 @@
+# Third-party notices — clear
+
+The `clear` model derives from components licensed by third parties. Their licenses apply to the components named below; nothing in the Desert Ant Labs Source-Available License overrides them.
+
+## Base architecture
+
+### DeepFilterNet 3 — Hendrik Schröter (Rikorose)
+- **Source:** [github.com/Rikorose/DeepFilterNet](https://github.com/Rikorose/DeepFilterNet)
+- **License:** MIT
+- **Use in `clear`:** Both `clear-studio` and `clear-natural` are fine-tunes of DeepFilterNet 3 (DFN3-half configuration) on the Desert Ant Labs speech corpus.
+
+## MIT preservation notice
+
+The MIT license requires preservation of the upstream copyright and permission notice in substantial portions of the software. Reproduced verbatim:
+
+```
+MIT License
+
+Copyright (c) 2022 Hendrik Schröter
+
+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.
+```

clear-natural.aimodel.zip

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

clear-natural.aimodel/main.hash

@@ -0,0 +1 @@
+O��"*4<���.���)���|��z�!�eH�m

clear-natural.aimodel/main.mlirb

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

clear-natural.aimodel/metadata.json

@@ -0,0 +1,5 @@
+{
+  "creationDate" : "20260907T114359Z",
+  "producer" : "coreai-core 1.0.0b2",
+  "assetVersion" : "2.0"
+}

clear-natural.mlmodelc.zip

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

clear-natural.mlmodelc/analytics/coremldata.bin

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

clear-natural.mlmodelc/coremldata.bin

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

clear-natural.mlmodelc/metadata.json

@@ -0,0 +1,98 @@
+[
+  {
+    "metadataOutputVersion" : "3.0",
+    "storagePrecision" : "Mixed (Float16, Palettized (6 bits))",
+    "outputSchema" : [
+      {
+        "hasShapeFlexibility" : "0",
+        "isOptional" : "0",
+        "dataType" : "Float16",
+        "formattedType" : "MultiArray (Float16 4 × 2 × 481 × 200)",
+        "shortDescription" : "",
+        "shape" : "[4, 2, 481, 200]",
+        "name" : "spec_enhanced",
+        "type" : "MultiArray"
+      }
+    ],
+    "modelParameters" : [
+
+    ],
+    "specificationVersion" : 7,
+    "mlProgramOperationTypeHistogram" : {
+      "Crop" : 2,
+      "Ios16.rsqrt" : 24,
+      "Concat" : 3,
+      "Ios16.mul" : 69,
+      "Ios16.tanh" : 1,
+      "SliceByIndex" : 31,
+      "Ios16.constexprLutToDense" : 63,
+      "Transpose" : 6,
+      "Ios16.sub" : 29,
+      "Ios16.sigmoid" : 1,
+      "Ios16.reduceMean" : 48,
+      "Ios16.add" : 68,
+      "Ios16.relu" : 19,
+      "Ios16.conv" : 85,
+      "Ios16.gelu" : 24,
+      "Ios16.convTranspose" : 2,
+      "Ios16.reshape" : 52,
+      "Pad" : 28
+    },
+    "computePrecision" : "Mixed (Float16, Int32)",
+    "isUpdatable" : "0",
+    "stateSchema" : [
+
+    ],
+    "availability" : {
+      "macOS" : "13.0",
+      "tvOS" : "16.0",
+      "visionOS" : "1.0",
+      "watchOS" : "9.0",
+      "iOS" : "16.0",
+      "macCatalyst" : "16.0"
+    },
+    "modelType" : {
+      "name" : "MLModelType_mlProgram"
+    },
+    "userDefinedMetadata" : {
+      "com.github.apple.coremltools.conversion_date" : "2026-08-12",
+      "com.github.apple.coremltools.source" : "torch==2.7.0",
+      "com.github.apple.coremltools.version" : "9.0",
+      "com.github.apple.coremltools.source_dialect" : "TorchScript"
+    },
+    "inputSchema" : [
+      {
+        "hasShapeFlexibility" : "0",
+        "isOptional" : "0",
+        "dataType" : "Float16",
+        "formattedType" : "MultiArray (Float16 4 × 2 × 481 × 200)",
+        "shortDescription" : "",
+        "shape" : "[4, 2, 481, 200]",
+        "name" : "spec",
+        "type" : "MultiArray"
+      },
+      {
+        "hasShapeFlexibility" : "0",
+        "isOptional" : "0",
+        "dataType" : "Float16",
+        "formattedType" : "MultiArray (Float16 4 × 1 × 32 × 200)",
+        "shortDescription" : "",
+        "shape" : "[4, 1, 32, 200]",
+        "name" : "feat_erb",
+        "type" : "MultiArray"
+      },
+      {
+        "hasShapeFlexibility" : "0",
+        "isOptional" : "0",
+        "dataType" : "Float16",
+        "formattedType" : "MultiArray (Float16 4 × 2 × 96 × 200)",
+        "shortDescription" : "",
+        "shape" : "[4, 2, 96, 200]",
+        "name" : "feat_spec",
+        "type" : "MultiArray"
+      }
+    ],
+    "generatedClassName" : "clear_natural_ane_b4_palette6",
+    "method" : "predict"
+  }
+]

clear-natural.mlmodelc/weights/weight.bin

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

clear-natural.onnx

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

clear-natural.tflite

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

clear-studio.aimodel.zip

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

clear-studio.aimodel/main.mlirb

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

clear-studio.aimodel/metadata.json

@@ -0,0 +1,5 @@
+{
+  "creationDate" : "20260907T114352Z",
+  "assetVersion" : "2.0",
+  "producer" : "coreai-core 1.0.0b2"
+}

clear-studio.mlmodelc.zip

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

clear-studio.mlmodelc/analytics/coremldata.bin

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

clear-studio.mlmodelc/coremldata.bin

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

clear-studio.mlmodelc/metadata.json

@@ -0,0 +1,98 @@
+[
+  {
+    "metadataOutputVersion" : "3.0",
+    "storagePrecision" : "Mixed (Float16, Palettized (6 bits))",
+    "outputSchema" : [
+      {
+        "hasShapeFlexibility" : "0",
+        "isOptional" : "0",
+        "dataType" : "Float16",
+        "formattedType" : "MultiArray (Float16 4 × 2 × 481 × 200)",
+        "shortDescription" : "",
+        "shape" : "[4, 2, 481, 200]",
+        "name" : "spec_enhanced",
+        "type" : "MultiArray"
+      }
+    ],
+    "modelParameters" : [
+
+    ],
+    "specificationVersion" : 7,
+    "mlProgramOperationTypeHistogram" : {
+      "Crop" : 2,
+      "Ios16.rsqrt" : 24,
+      "Concat" : 3,
+      "Ios16.mul" : 69,
+      "Ios16.tanh" : 1,
+      "SliceByIndex" : 31,
+      "Ios16.constexprLutToDense" : 63,
+      "Transpose" : 6,
+      "Ios16.sub" : 29,
+      "Ios16.sigmoid" : 1,
+      "Ios16.reduceMean" : 48,
+      "Ios16.add" : 68,
+      "Ios16.relu" : 19,
+      "Ios16.conv" : 85,
+      "Ios16.gelu" : 24,
+      "Ios16.convTranspose" : 2,
+      "Ios16.reshape" : 52,
+      "Pad" : 28
+    },
+    "computePrecision" : "Mixed (Float16, Int32)",
+    "isUpdatable" : "0",
+    "stateSchema" : [
+
+    ],
+    "availability" : {
+      "macOS" : "13.0",
+      "tvOS" : "16.0",
+      "visionOS" : "1.0",
+      "watchOS" : "9.0",
+      "iOS" : "16.0",
+      "macCatalyst" : "16.0"
+    },
+    "modelType" : {
+      "name" : "MLModelType_mlProgram"
+    },
+    "userDefinedMetadata" : {
+      "com.github.apple.coremltools.conversion_date" : "2026-08-12",
+      "com.github.apple.coremltools.source" : "torch==2.7.0",
+      "com.github.apple.coremltools.version" : "9.0",
+      "com.github.apple.coremltools.source_dialect" : "TorchScript"
+    },
+    "inputSchema" : [
+      {
+        "hasShapeFlexibility" : "0",
+        "isOptional" : "0",
+        "dataType" : "Float16",
+        "formattedType" : "MultiArray (Float16 4 × 2 × 481 × 200)",
+        "shortDescription" : "",
+        "shape" : "[4, 2, 481, 200]",
+        "name" : "spec",
+        "type" : "MultiArray"
+      },
+      {
+        "hasShapeFlexibility" : "0",
+        "isOptional" : "0",
+        "dataType" : "Float16",
+        "formattedType" : "MultiArray (Float16 4 × 1 × 32 × 200)",
+        "shortDescription" : "",
+        "shape" : "[4, 1, 32, 200]",
+        "name" : "feat_erb",
+        "type" : "MultiArray"
+      },
+      {
+        "hasShapeFlexibility" : "0",
+        "isOptional" : "0",
+        "dataType" : "Float16",
+        "formattedType" : "MultiArray (Float16 4 × 2 × 96 × 200)",
+        "shortDescription" : "",
+        "shape" : "[4, 2, 96, 200]",
+        "name" : "feat_spec",
+        "type" : "MultiArray"
+      }
+    ],
+    "generatedClassName" : "clear_studio_ane_b4_palette6",
+    "method" : "predict"
+  }
+]

clear-studio.mlmodelc/weights/weight.bin

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

clear-studio.onnx

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

clear-studio.tflite

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