| --- |
| language: |
| - zh |
| - en |
| license: apache-2.0 |
| library_name: mlx |
| pipeline_tag: text-to-audio |
| base_model: OpenMOSS-Team/MOSS-SoundEffect |
| base_model_relation: quantized |
| tags: |
| - mlx |
| - audio |
| - sound-effects |
| - audio-generation |
| - apple-silicon |
| - quantized |
| - 4bit |
| --- |
| |
| # MOSS SoundEffect — MLX 4-bit |
|
|
| This repository contains an MLX-native 4-bit conversion of MOSS SoundEffect for local text-to-audio generation on Apple Silicon. |
|
|
| > Note |
| > This repo is a community mirror of the canonical MLX conversion maintained by |
| > [AppAutomaton](https://github.com/appautomaton) at |
| > [`appautomaton/openmoss-sound-effect-mlx`](https://huggingface.co/appautomaton/openmoss-sound-effect-mlx). |
|
|
| ## Variants |
|
|
| | Path | Precision | |
| | --- | --- | |
| | `mlx-4bit/` | 4-bit quantized weights | |
|
|
| ## Model Details |
|
|
| - Developed by: AppAutomaton |
| - Shared by: `mlx-community` |
| - Original MLX repo: [`appautomaton/openmoss-sound-effect-mlx`](https://huggingface.co/appautomaton/openmoss-sound-effect-mlx) |
| - Upstream model: [`OpenMOSS-Team/MOSS-SoundEffect`](https://huggingface.co/OpenMOSS-Team/MOSS-SoundEffect) |
| - Task: text-to-audio and sound-effect generation |
| - Runtime: MLX on Apple Silicon |
|
|
| ## How to Get Started |
|
|
| Command-line generation with [`mlx-speech`](https://github.com/appautomaton/mlx-speech): |
|
|
| ```bash |
| python scripts/generate_moss_sound_effect.py \ |
| --ambient-sound "rolling thunder with steady rainfall on a metal roof" \ |
| --duration-seconds 8 \ |
| --output outputs/thunder.wav |
| ``` |
|
|
| Minimal Python usage: |
|
|
| ```python |
| from mlx_speech.generation import MossSoundEffectModel |
| |
| model = MossSoundEffectModel.from_path("mlx-4bit") |
| ``` |
|
|
| ## Notes |
|
|
| - This repo contains the quantized MLX runtime artifact only. |
| - The conversion keeps the original SoundEffect architecture and remaps weights explicitly for MLX inference. |
| - This is the 4-bit variant, and the published folder layout reflects that in `mlx-4bit/`. |
| - This mirror is a duplicated repo, not an automatically synchronized namespace mirror. |
|
|
| ## Links |
|
|
| - Canonical MLX repo: [`appautomaton/openmoss-sound-effect-mlx`](https://huggingface.co/appautomaton/openmoss-sound-effect-mlx) |
| - Source code: [`mlx-speech`](https://github.com/appautomaton/mlx-speech) |
| - More examples: [AppAutomaton](https://github.com/appautomaton) |
|
|
| ## License |
|
|
| Apache 2.0 — following the upstream license published with [`OpenMOSS-Team/MOSS-SoundEffect`](https://huggingface.co/OpenMOSS-Team/MOSS-SoundEffect). |
|
|
