python scripts/generate/fish_s2_pro.py \
  --text "Hello from Fish S2 Pro." \
  --model-dir /path/to/fishaudio-s2-pro-8bit-mlx \
  --output outputs/fish_s2_pro.wav

Voice cloning:

bash

python scripts/generate/fish_s2_pro.py \
  --text "This is a cloned voice." \
  --reference-audio /path/to/reference.wav \
  --reference-text "Transcript of the reference audio." \
  --model-dir /path/to/fishaudio-s2-pro-8bit-mlx \
  --output outputs/fish_s2_pro_clone.wav

Inline prosody and emotion tags:

Fish S2 Pro supports 15,000+ inline tags placed directly in the text. Tags are single open-style [tag] — no closing tag. Place them immediately before the word or phrase they apply to.

bash

python scripts/generate/fish_s2_pro.py \
  --text "Now Bobby, [clearing throat] I need to talk to you. [whisper] This stays between us. [chuckle] Just kidding." \
  --reference-audio /path/to/reference.wav \
  --reference-text "Transcript of the reference audio." \
  --output outputs/fish_s2_pro_emotion.wav

Common tags: [whisper], [chuckle], [laugh], [clearing throat], [excited], [sad], [pause]. See the upstream repo for the full tag list.

Minimal Python usage:

python

from pathlib import Path

from mlx_speech.generation.fish_s2_pro import generate_fish_s2_pro

result = generate_fish_s2_pro(
    "Hello from Fish S2 Pro.",
    model_dir=Path("/path/to/fishaudio-s2-pro-8bit-mlx"),
)

Notes

This repo contains the quantized MLX runtime artifact only.
The conversion keeps the Fish S2 Pro dual-autoregressive model architecture and ships a bundled MLX codec for waveform decode.
Upstream defaults: temperature=0.8, top_p=0.8.
The current bundle is intended for local MLX runtime use and parity validation.

License

Fish Audio Research License — following the upstream license published with fishaudio/s2-pro.

appautomaton/fishaudio-s2-pro-8bit-mlx

Fish Audio S2 Pro — MLX 8-bit

Model Details

Bundle Contents

How to Get Started

Notes

Links

License

appautomaton/
fishaudio-s2-pro-8bit-mlx