---
license: mit
pipeline_tag: audio-to-audio
library_name: rlx
tags:
- miocodec
- codec
- rlx
---

# MioCodec 25Hz/24kHz (RLX staging)

MioCodec weights + ONNX decoder body (local parity fixtures removed).

| Field | Value |
|---|---|
| **Hub id** | [`eugenehp/miocodec`](https://huggingface.co/eugenehp/miocodec) |
| **Kind** | Staging redistrib of an upstream checkpoint for RLX runners. |
| **RLX crate** | [`rlx-miotts`](https://github.com/MIT-RLX/rlx-models/tree/main/crates/rlx-miotts) |
| **Upstream** | https://huggingface.co/Aratako/MioCodec-25Hz-24kHz |

## Quick start

```bash
hf download eugenehp/miocodec --local-dir .
cargo run -p rlx-miotts --release -- --codec-dir .
```

## File highlights

- `model.safetensors` (498.9 MiB)
- `decoder_body.onnx` (348.4 MiB)
- `miocodec.f16.gguf` (249.4 MiB)
- `config.yaml` (2.3 KiB)

## Do not use as the main runtime pack

These files may be present for historical / staging reasons but are **not** the supported RLX load path:

- `miocodec.f16.gguf`

Community `*.f16.gguf` / LM-only Q4 packs are format wraps — they are not drop-in replacements for the RLX primary file above.

## Run with RLX

Clone [rlx-models](https://github.com/MIT-RLX/rlx-models), place this repo under `weights/tts/miocodec` (or pass the path explicitly), then:

```bash
cargo run -p rlx-miotts --release -- --codec-dir .
```

## License

MIT — see `LICENSE`. Inherit upstream terms when redistributing.

Original weights and authorship: https://huggingface.co/Aratako/MioCodec-25Hz-24kHz

## Redistrib note

This Hub repo exists so RLX recipes have a stable fetch target. When you only need the upstream checkpoint, prefer the Upstream link above.